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.
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.
unregister: Unregister a name in the Store.
names: List your registered charm names in Charmhub.

Charm commands¶

upload: Upload a charm to Charmhub.
revisions: List revisions for a charm in Charmhub.
create-track: Create one or more tracks for a charm on Charmhub.
release: Release a charm revision in one or more channels.
promote: Promote a charm from one channel to another on Charmhub.
status: Show channel and released revisions.
close: Close a channel for a charm.
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 (EXPERIMENTAL).
version: Show the application version and exit.