How to Upload a Component

There are two ways to upload a component to the ESP Component Registry:

  • From GitHub Actions (recommended for ongoing development): automate uploads on every push or tag. See How to Upload from GitHub Actions.

  • From the command line: upload manually using the compote CLI. This page covers the CLI approach.

Before uploading, make sure you have authenticated. See How to Authenticate for Publishing.

Upload from the component directory

From the component directory (where idf_component.yml is located), run:

$ compote component upload --name my_component

Upload to staging

If you use a staging profile, upload with:

$ compote component upload --profile "staging" --name my_component

Upload to a specific namespace

If you have permissions for multiple namespaces, you can set the namespace explicitly:

$ compote component upload --name my_component --namespace my_namespace

Troubleshooting