Skip to main content

Cosmo App

Cosmo app is used to manage all your applications deployed using wadm. It provides with all the necessary tools to retrieve, add, remove and inspect all the details of your deployed as well as undeployed applications. Following are the subcommands available under cosmo app.

  • list
  • get
  • history
  • delete
  • put
  • deploy
  • undeploy

list

This will retrieve a list of all applications that wadm knows about. Application specifications (also referred to in our documentation and code as "models") are stored in a model store and are associated to constellations.

Usage:

cosmo app list

get

The get command is used to retrieve the details for a specific version of a model.You can retrieve both the original text (e.g. YAML) that you submitted and the vetted and normalized model in JSON format.

Usage:

cosmo app get <name> [version]
cosmo app get petclinic 0.0.1

history

The history command is used to retrieve the version history of a given model. You can view all the previous versions available in store and their respective status for a given app.

Usage:

cosmo app history <name>
cosmo app history petclinic

delete

The delete command is used to delete an application model of a specific version. You can optionally delete all versions of a specification as well.

Usage:

cosmo app delete <name> <version>
cosmo app delete petclinic 0.0.1
cosmo app delete petclinic --delete-all

put

Performs an idempotent put operation for an application specification version. Spec versions are immutable. If you wish to change the contents of a spec, you must submit a new version.

Usage:

cosmo app put <SOURCE>
cosmo app put petclinic.yaml

deploy

When a version of an application specification is deployed, wadm will start monitoring the state of your constellation. Wadm will compare the desired state of an application with its current state and issue the appropriate commands to reconcile the state.

Usage:

cosmo app deploy <name> [version]
cosmo app deploy petclinic v0.0.1

undeploy

Undeploying an application spec tells wadm to stop monitoring that deployment. Wadm supports destructive as well as non-destructive undeploys. By default, all resources originally provisioned for an application will be removed after that application is undeployed.

Usage:

cosmo app undeploy <name>
cosmo app undeploy petclinic
cosmo app undeploy petclinic --non-destructive