Commands

Charmcraft has several commands used for managing the building, uploading and releasing of a charm.

init

Initialise a charm operator package tree and files.

Lifecycle Commands

clean

Remove a part’s assets.

pull

Download or retrieve artefacts defined for a part.

build

Build artefacts defined for a part.

stage

Stage built artefacts into a common staging area.

prime

Prime artefacts defined for a part.

pack

Build the charm or bundle.

remote-build

Build a charm remotely on Launchpad.

Store Commands

Store commands fall into several categories, depending on the particular command.

Account Commands

login

Login to Charmhub.

logout

Logout from Charmhub and remove token.

whoami

Show your Charmhub login status.

register

Register a charm name in Charmhub.

register-bundle

Register a bundle name in the Store.

unregister

Unregister a name in the Store.

names

List your registered charm and bundle names in Charmhub.

Charm or Bundle Commands

upload

Upload a charm or bundle to Charmhub.

revisions

List revisions for a charm or a bundle in Charmhub.

release

Release a charm or bundle revision in one or more channels.

promote-bundle

Promote a bundle to another channel in the Store.

status

Show channel and released revisions.

close

Close a channel for a charm or bundle.

resources

List the resources associated with a given charm in Charmhub.

resource-revisions

List revisions for a resource associated to a charm in Charmhub.

set-resource-architectures

Set the architectures for a resource revision in Charmhub.

upload-resource

Upload a resource to Charmhub.

Library Commands

create-lib

Create a charm library.

publish-lib

Publish one or more charm libraries.

list-lib

List all libraries from a charm.

fetch-libs

Fetch one or more charm libraries.

Other Commands

analyse

Analyse a charm.

test

Execute charm test suites.

version

Show the application version and exit.