24 KiB

Raw Blame History

Container Infrastructure Management service (magnum) command-line client

The magnum client is the command-line interface (CLI) for the Container Infrastructure Management service (magnum) API and its extensions.

This chapter documents magnum version 2.3.1.

For help on a specific magnum command, enter:

$ magnum help COMMAND

magnum usage

usage: magnum [--version] [--debug] [--os-cache]
              [--os-region-name <region-name>] [--os-auth-url <auth-auth-url>]
              [--os-user-id <auth-user-id>] [--os-username <auth-username>]
              [--os-user-domain-id <auth-user-domain-id>]
              [--os-user-domain-name <auth-user-domain-name>]
              [--os-project-id <auth-project-id>]
              [--os-project-name <auth-project-name>]
              [--os-project-domain-id <auth-project-domain-id>]
              [--os-project-domain-name <auth-project-domain-name>]
              [--os-token <auth-token>] [--os-password <auth-password>]
              [--service-type <service-type>]
              [--os-endpoint-type <os-endpoint-type>]
              [--os-cloud <auth-cloud>]
              [--magnum-api-version <magnum-api-ver>]
              [--os-cacert <ca-certificate>]
              [--os-endpoint-override <endpoint-override>] [--insecure]
              <subcommand> ...

Subcommands:

baymodel-create: Create a baymodel.
baymodel-delete: Delete specified baymodel.
baymodel-list: Print a list of baymodels.
baymodel-show: Show details about the given baymodel.
baymodel-update: Updates one or more baymodel attributes.
bay-config: Configure native client to access bay. You can source the output of this command to get the native client of the corresponding COE configured to access the bay. Example: eval $(magnum bay-config <bay-name>).
bay-create: Create a bay.
bay-delete: Delete specified bay.
bay-list: Print a list of available bays.
bay-show: Show details about the given bay.
bay-update: Update information about the given bay.
ca-show: Show details about the CA certificate for a bay or cluster.
ca-sign: Generate the CA certificate for a bay or cluster.
cluster-config: Configure native client to access cluster. You can source the output of this command to get the native client of the corresponding COE configured to access the cluster. Example: eval $(magnum cluster-config <cluster-name>).
cluster-create: Create a cluster.
cluster-delete: Delete specified cluster.
cluster-list: Print a list of available clusters.
cluster-show: Show details about the given cluster.
cluster-update: Update information about the given cluster.
cluster-template-create: Create a cluster template.
cluster-template-delete: Delete specified cluster template.
cluster-template-list: Print a list of cluster templates.
cluster-template-show: Show details about the given cluster template.
cluster-template-update: Updates one or more cluster template attributes.
service-list: Print a list of magnum services.
bash-completion: Prints arguments for bash-completion. Prints all of the commands and options to stdout so that the magnum.bash_completion script doesn't have to hard code them.
help: Display help about this program or one of its subcommands.

magnum optional arguments

--version: show program's version number and exit
--debug: Print debugging output.
--os-cache: Use the auth token cache. Defaults to False if env[OS_CACHE] is not set.
--os-region-name <region-name>: Region name. Default= env[OS_REGION_NAME].
--os-auth-url <auth-auth-url>: Defaults to env[OS_AUTH_URL].
--os-user-id <auth-user-id>: Defaults to env[OS_USER_ID].
--os-username <auth-username>: Defaults to env[OS_USERNAME].
--os-user-domain-id <auth-user-domain-id>: Defaults to env[OS_USER_DOMAIN_ID].
--os-user-domain-name <auth-user-domain-name>: Defaults to env[OS_USER_DOMAIN_NAME].
--os-project-id <auth-project-id>: Defaults to env[OS_PROJECT_ID].
--os-project-name <auth-project-name>: Defaults to env[OS_PROJECT_NAME].
--os-project-domain-id <auth-project-domain-id>: Defaults to env[OS_PROJECT_DOMAIN_ID].
--os-project-domain-name <auth-project-domain-name>: Defaults to env[OS_PROJECT_DOMAIN_NAME].
--os-token <auth-token>: Defaults to env[OS_TOKEN].
--os-password <auth-password>: Defaults to env[OS_PASSWORD].
--service-type <service-type>: Defaults to container-infra for all actions.
--os-endpoint-type <os-endpoint-type>: Defaults to env[OS_ENDPOINT_TYPE]
--os-cloud <auth-cloud>: Defaults to env[OS_CLOUD].
--magnum-api-version <magnum-api-ver>: Accepts "api", defaults to env[MAGNUM_API_VERSION].
--os-cacert <ca-certificate>: Specify a CA bundle file to use in verifying a TLS (https) server certificate. Defaults to env[OS_CACERT].
--os-endpoint-override <endpoint-override>: Use this API endpoint instead of the Service Catalog.
--insecure: Do not verify https connections

magnum bay-config

usage: magnum bay-config [--dir <dir>] [--force] <bay>

Configure native client to access bay. You can source the output of this command to get the native client of the corresponding COE configured to access the bay. Example: eval $(magnum bay-config <bay-name>).

Positional arguments:

<bay>: ID or name of the bay to retrieve config.

Optional arguments:

--dir <dir>: Directory to save the certificate and config files.
--force: Overwrite files if existing.

magnum bay-create

usage: magnum bay-create [--name <name>] --baymodel <baymodel>
                         [--node-count <node-count>]
                         [--master-count <master-count>]
                         [--discovery-url <discovery-url>]
                         [--timeout <timeout>]

Create a bay.

Optional arguments:

--name <name>: Name of the bay to create.
--baymodel <baymodel>: ID or name of the baymodel.
--node-count <node-count>: The bay node count.
--master-count <master-count>: The number of master nodes for the bay.
--discovery-url <discovery-url>: Specifies custom discovery url for node discovery.
--timeout <timeout>: The timeout for bay creation in minutes. The default is 60 minutes.

magnum bay-delete

usage: magnum bay-delete <bay> [<bay> ...]

Delete specified bay.

Positional arguments:

<bay>: ID or name of the (bay)s to delete.

magnum bay-list

usage: magnum bay-list [--marker <marker>] [--limit <limit>]
                       [--sort-key <sort-key>] [--sort-dir <sort-dir>]
                       [--fields <fields>]

Print a list of available bays.

Optional arguments:

--marker <marker>: The last bay UUID of the previous page; displays list of bays after "marker".
--limit <limit>: Maximum number of bays to return.
--sort-key <sort-key>: Column to sort results by.
--sort-dir <sort-dir>: Direction to sort. "asc" or "desc".
--fields <fields>: Comma-separated list of fields to display. Available fields: uuid, name, baymodel_id, stack_id, status, master_count, node_count, links, bay_create_timeout

magnum bay-show

usage: magnum bay-show [--long] <bay>

Show details about the given bay.

Positional arguments:

<bay>: ID or name of the bay to show.

Optional arguments:

--long: Display extra associated Baymodel info.

magnum bay-update

usage: magnum bay-update <bay> <op> <path=value> [<path=value> ...]

Update information about the given bay.

Positional arguments:

<bay>: UUID or name of bay
<op>: Operations: 'add', 'replace' or 'remove'
<path=value>: Attributes to add/replace or remove (only PATH is necessary on remove)

magnum baymodel-create

usage: magnum baymodel-create [--name <name>] --image-id <image-id>
                              --keypair-id <keypair-id> --external-network-id
                              <external-network-id> --coe <coe>
                              [--fixed-network <fixed-network>]
                              [--fixed-subnet <fixed-subnet>]
                              [--network-driver <network-driver>]
                              [--volume-driver <volume-driver>]
                              [--dns-nameserver <dns-nameserver>]
                              [--flavor-id <flavor-id>]
                              [--master-flavor-id <master-flavor-id>]
                              [--docker-volume-size <docker-volume-size>]
                              [--docker-storage-driver <docker-storage-driver>]
                              [--http-proxy <http-proxy>]
                              [--https-proxy <https-proxy>]
                              [--no-proxy <no-proxy>]
                              [--labels <KEY1=VALUE1,KEY2=VALUE2;KEY3=VALUE3...>]
                              [--tls-disabled] [--public] [--registry-enabled]
                              [--server-type <server-type>]
                              [--master-lb-enabled] [--floating-ip-enabled]

Create a baymodel.

Optional arguments:

--name <name>: Name of the baymodel to create.
--image-id <image-id>: The name or UUID of the base image to customize for the bay.
--keypair-id <keypair-id>: The name or UUID of the SSH keypair to load into the Bay nodes.
--external-network-id <external-network-id>: The external Neutron network ID to connect to this bay model.
--coe <coe>: Specify the Container Orchestration Engine to use.
--fixed-network <fixed-network>: The private Neutron network name to connect to this bay model.
--fixed-subnet <fixed-subnet>: The private Neutron subnet name to connect to bay.
--network-driver <network-driver>: The network driver name for instantiating container networks.
--volume-driver <volume-driver>: The volume driver name for instantiating container volume.
--dns-nameserver <dns-nameserver>: The DNS nameserver to use for this baymodel.
--flavor-id <flavor-id>: The nova flavor id to use when launching the bay.
--master-flavor-id <master-flavor-id>: The nova flavor id to use when launching the master node of the bay.
--docker-volume-size <docker-volume-size>: Specify the number of size in GB for the docker volume to use.
--docker-storage-driver <docker-storage-driver>: Select a docker storage driver. Supported: devicemapper, overlay. Default: devicemapper
--http-proxy <http-proxy>: The http_proxy address to use for nodes in bay.
--https-proxy <https-proxy>: The https_proxy address to use for nodes in bay.
--no-proxy <no-proxy>: The no_proxy address to use for nodes in bay.
--labels <KEY1=VALUE1,KEY2=VALUE2;KEY3=VALUE3...>: Arbitrary labels in the form of key=value pairs to associate with a baymodel. May be used multiple times.
--tls-disabled: Disable TLS in the Bay.
--public: Make baymodel public.
--registry-enabled: Enable docker registry in the Bay
--server-type <server-type>: Specify the server type to be used for example vm. For this release default server type will be vm.
--master-lb-enabled: Indicates whether created bays should have a load balancer for master nodes or not.
--floating-ip-enabled: Indicates whether created bays should have a floating ipor not.

magnum baymodel-delete

usage: magnum baymodel-delete <baymodels> [<baymodels> ...]

Delete specified baymodel.

Positional arguments:

<baymodels>: ID or name of the (baymodel)s to delete.

magnum baymodel-list

usage: magnum baymodel-list [--limit <limit>] [--sort-key <sort-key>]
                            [--sort-dir <sort-dir>] [--fields <fields>]

Print a list of baymodels.

Optional arguments:

--limit <limit>: Maximum number of baymodels to return
--sort-key <sort-key>: Column to sort results by
--sort-dir <sort-dir>: Direction to sort. "asc" or "desc".
--fields <fields>: Comma-separated list of fields to display. Available fields: uuid, name, coe, image_id, public, link, apiserver_port, server_type, tls_disabled, registry_enabled

magnum baymodel-show

usage: magnum baymodel-show <baymodel>

Show details about the given baymodel.

Positional arguments:

<baymodel>: ID or name of the baymodel to show.

magnum baymodel-update

usage: magnum baymodel-update <baymodel> <op> <path=value> [<path=value> ...]

Updates one or more baymodel attributes.

Positional arguments:

<baymodel>: UUID or name of baymodel
<op>: Operations: 'add', 'replace' or 'remove'
<path=value>: Attributes to add/replace or remove (only PATH is necessary on remove)

magnum ca-show

usage: magnum ca-show [--bay <bay>] [--cluster <cluster>]

Show details about the CA certificate for a bay or cluster.

Optional arguments:

--bay <bay>: ID or name of the bay.
--cluster <cluster>: ID or name of the cluster.

magnum ca-sign

usage: magnum ca-sign [--csr <csr>] [--bay <bay>] [--cluster <cluster>]

Generate the CA certificate for a bay or cluster.

Optional arguments:

--csr <csr>: File path of the csr file to send to Magnum to get signed.
--bay <bay>: ID or name of the bay.
--cluster <cluster>: ID or name of the cluster.

magnum cluster-config

usage: magnum cluster-config [--dir <dir>] [--force] <cluster>

Configure native client to access cluster. You can source the output of this command to get the native client of the corresponding COE configured to access the cluster. Example: eval $(magnum cluster-config <cluster-name>).

Positional arguments:

<cluster>: ID or name of the cluster to retrieve config.

Optional arguments:

--dir <dir>: Directory to save the certificate and config files.
--force: Overwrite files if existing.

magnum cluster-create

usage: magnum cluster-create [--name <name>] --cluster-template
                             <cluster_template> [--node-count <node-count>]
                             [--master-count <master-count>]
                             [--discovery-url <discovery-url>]
                             [--timeout <timeout>]

Create a cluster.

Optional arguments:

--name <name>: Name of the cluster to create.
--cluster-template <cluster_template>: ID or name of the cluster template.
--node-count <node-count>: The cluster node count.
--master-count <master-count>: The number of master nodes for the cluster.
--discovery-url <discovery-url>: Specifies custom discovery url for node discovery.
--timeout <timeout>: The timeout for cluster creation in minutes. The default is 60 minutes.

magnum cluster-delete

usage: magnum cluster-delete <cluster> [<cluster> ...]

Delete specified cluster.

Positional arguments:

<cluster>: ID or name of the (cluster)s to delete.

magnum cluster-list

usage: magnum cluster-list [--marker <marker>] [--limit <limit>]
                           [--sort-key <sort-key>] [--sort-dir <sort-dir>]
                           [--fields <fields>]

Print a list of available clusters.

Optional arguments:

--marker <marker>: The last cluster UUID of the previous page; displays list of clusters after "marker".
--limit <limit>: Maximum number of clusters to return.
--sort-key <sort-key>: Column to sort results by.
--sort-dir <sort-dir>: Direction to sort. "asc" or "desc".
--fields <fields>: Comma-separated list of fields to display. Available fields: uuid, name, baymodel_id, stack_id, status, master_count, node_count, links, cluster_create_timeout

magnum cluster-show

usage: magnum cluster-show [--long] <cluster>

Show details about the given cluster.

Positional arguments:

<cluster>: ID or name of the cluster to show.

Optional arguments:

--long: Display extra associated cluster template info.

magnum cluster-template-create

usage: magnum cluster-template-create [--name <name>] --image-id <image-id>
                                      --keypair-id <keypair-id>
                                      --external-network-id
                                      <external-network-id> --coe <coe>
                                      [--fixed-network <fixed-network>]
                                      [--fixed-subnet <fixed-subnet>]
                                      [--network-driver <network-driver>]
                                      [--volume-driver <volume-driver>]
                                      [--dns-nameserver <dns-nameserver>]
                                      [--flavor-id <flavor-id>]
                                      [--master-flavor-id <master-flavor-id>]
                                      [--docker-volume-size <docker-volume-size>]
                                      [--docker-storage-driver <docker-storage-driver>]
                                      [--http-proxy <http-proxy>]
                                      [--https-proxy <https-proxy>]
                                      [--no-proxy <no-proxy>]
                                      [--labels <KEY1=VALUE1,KEY2=VALUE2;KEY3=VALUE3...>]
                                      [--tls-disabled] [--public]
                                      [--registry-enabled]
                                      [--server-type <server-type>]
                                      [--master-lb-enabled]
                                      [--floating-ip-enabled]

Create a cluster template.

Optional arguments:

--name <name>: Name of the cluster template to create.
--image-id <image-id>: The name or UUID of the base image to customize for the bay.
--keypair-id <keypair-id>: The name or UUID of the SSH keypair to load into the Bay nodes.
--external-network-id <external-network-id>: The external Neutron network ID to connect to this bay model.
--coe <coe>: Specify the Container Orchestration Engine to use.
--fixed-network <fixed-network>: The private Neutron network name to connect to this bay model.
--fixed-subnet <fixed-subnet>: The private Neutron subnet name to connect to bay.
--network-driver <network-driver>: The network driver name for instantiating container networks.
--volume-driver <volume-driver>: The volume driver name for instantiating container volume.
--dns-nameserver <dns-nameserver>: The DNS nameserver to use for this cluster template.
--flavor-id <flavor-id>: The nova flavor id to use when launching the bay.
--master-flavor-id <master-flavor-id>: The nova flavor id to use when launching the master node of the bay.
--docker-volume-size <docker-volume-size>: Specify the number of size in GB for the docker volume to use.
--docker-storage-driver <docker-storage-driver>: Select a docker storage driver. Supported: devicemapper, overlay. Default: devicemapper
--http-proxy <http-proxy>: The http_proxy address to use for nodes in bay.
--https-proxy <https-proxy>: The https_proxy address to use for nodes in bay.
--no-proxy <no-proxy>: The no_proxy address to use for nodes in bay.
--labels <KEY1=VALUE1,KEY2=VALUE2;KEY3=VALUE3...>: Arbitrary labels in the form of key=value pairs to associate with a cluster template. May be used multiple times.
--tls-disabled: Disable TLS in the Bay.
--public: Make cluster template public.
--registry-enabled: Enable docker registry in the Bay
--server-type <server-type>: Specify the server type to be used for example vm. For this release default server type will be vm.
--master-lb-enabled: Indicates whether created bays should have a load balancer for master nodes or not.
--floating-ip-enabled: Indicates whether created bays should have a floating ipor not.

magnum cluster-template-delete

usage: magnum cluster-template-delete <cluster_templates>
                                      [<cluster_templates> ...]

Delete specified cluster template.

Positional arguments:

<cluster_templates>: ID or name of the (cluster template)s to delete.

magnum cluster-template-list

usage: magnum cluster-template-list [--limit <limit>] [--sort-key <sort-key>]
                                    [--sort-dir <sort-dir>]
                                    [--fields <fields>]

Print a list of cluster templates.

Optional arguments:

--limit <limit>: Maximum number of cluster templates to return
--sort-key <sort-key>: Column to sort results by
--sort-dir <sort-dir>: Direction to sort. "asc" or "desc".
--fields <fields>: Comma-separated list of fields to display. Available fields: uuid, name, coe, image_id, public, link, apiserver_port, server_type, tls_disabled, registry_enabled

magnum cluster-template-show

usage: magnum cluster-template-show <cluster_template>

Show details about the given cluster template.

Positional arguments:

<cluster_template>: ID or name of the cluster template to show.

magnum cluster-template-update

usage: magnum cluster-template-update <cluster_template> <op> <path=value>
                                      [<path=value> ...]

Updates one or more cluster template attributes.

Positional arguments:

<cluster_template>: UUID or name of cluster template
<op>: Operations: 'add', 'replace' or 'remove'
<path=value>: Attributes to add/replace or remove (only PATH is necessary on remove)

magnum cluster-update

usage: magnum cluster-update <cluster> <op> <path=value> [<path=value> ...]

Update information about the given cluster.

Positional arguments:

<cluster>: UUID or name of cluster
<op>: Operations: 'add', 'replace' or 'remove'
<path=value>: Attributes to add/replace or remove (only PATH is necessary on remove)

magnum service-list

usage: magnum service-list

Print a list of magnum services.

24 KiB Raw Blame History

Container Infrastructure Management service (magnum) command-line client

magnum usage

magnum optional arguments

magnum bay-config

magnum bay-create

magnum bay-delete

magnum bay-list

magnum bay-show

magnum bay-update

magnum baymodel-create

magnum baymodel-delete

magnum baymodel-list

magnum baymodel-show

magnum baymodel-update

magnum ca-show

magnum ca-sign

magnum cluster-config

magnum cluster-create

magnum cluster-delete

magnum cluster-list

magnum cluster-show

magnum cluster-template-create

magnum cluster-template-delete

magnum cluster-template-list

magnum cluster-template-show

magnum cluster-template-update

magnum cluster-update

magnum service-list

24 KiB

Raw Blame History