Chapter 16. coe


This chapter describes the commands under the coe command.

16.1. coe ca rotate

Usage:

openstack coe ca rotate [-h] <cluster>
Copy to Clipboard Toggle word wrap

Rotate the CA certificate for cluster to revoke access.

Expand
Table 16.1. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster

Expand
Table 16.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-magnumclient plugin.

16.2. coe ca show

Usage:

openstack coe ca show [-h] <cluster>
Copy to Clipboard Toggle word wrap

Show details about the CA certificate for a cluster.

Expand
Table 16.3. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster

Expand
Table 16.4. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-magnumclient plugin.

16.3. coe ca sign

Usage:

openstack coe ca sign [-h] <cluster> <csr>
Copy to Clipboard Toggle word wrap

Generate the CA certificate for a cluster.

Expand
Table 16.5. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster

<csr>

File path of csr file to send to magnum to get signed.

Expand
Table 16.6. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-magnumclient plugin.

16.4. coe cluster config

Usage:

openstack coe cluster config [-h] [--dir <dir>] [--force] <cluster>
Copy to Clipboard Toggle word wrap

Get Configuration for a Cluster

Expand
Table 16.7. Positional Arguments
ValueSummary

<cluster>

The name or uuid of cluster to update

Expand
Table 16.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--dir <dir>

Directory to save the certificate and config files.

--force

Overwrite files if existing.

This command is provided by the python-magnumclient plugin.

16.5. coe cluster create

Usage:

openstack coe cluster create [-h] --cluster-template <cluster-template>

                                  [--discovery-url <discovery-url>]
                                  [--docker-volume-size <docker-volume-size>]
                                  [--labels <KEY1=VALUE1,KEY2=VALUE2;KEY3=VALUE3...>]
                                  [--keypair <keypair>]
                                  [--master-count <master-count>]
                                  [--node-count <node-count>]
                                  [--timeout <timeout>]
                                  [--master-flavor <master-flavor>]
                                  [--flavor <flavor>]
                                  <name>
Copy to Clipboard Toggle word wrap

Create a cluster

Expand
Table 16.9. Positional Arguments
ValueSummary

<name>

Name of the cluster to create.

Expand
Table 16.10. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--cluster-template <cluster-template>

ID or name of the cluster template.

--discovery-url <discovery-url>

Specifies custom delivery url for node discovery.

--docker-volume-size <docker-volume-size>

The size in GB for the docker volume to use.

--labels <KEY1=VALUE1,KEY2=VALUE2;KEY3=VALUE3…​>

Arbitrary labels in the form of key=valuepairs to associate with a cluster template. May be used multiple times.

--keypair <keypair>

Uuid or name of the keypair to use.

--master-count <master-count>

The number of master nodes for the cluster.

--node-count <node-count>

The cluster node count.

--timeout <timeout>

The timeout for cluster creation time. the default is 60 minutes.

--master-flavor <master-flavor>

The nova flavor name or UUID to use when launching the master node of the Cluster.

--flavor <flavor>

The nova flavor name or uuid to use when launching the Cluster.

This command is provided by the python-magnumclient plugin.

16.6. coe cluster delete

Usage:

openstack coe cluster delete [-h] <cluster> [<cluster> ...]
Copy to Clipboard Toggle word wrap

Delete a cluster

Expand
Table 16.11. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster(s) to delete.

Expand
Table 16.12. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-magnumclient plugin.

16.7. coe cluster list

Usage:

openstack coe cluster list [-h] [-f {csv,json,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--quote {all,minimal,none,nonnumeric}]
                                [--sort-column SORT_COLUMN]
                                [--limit <limit>] [--sort-key <sort-key>]
                                [--sort-dir <sort-dir>]
Copy to Clipboard Toggle word wrap

List clusters

Expand
Table 16.13. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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".

Expand
Table 16.14. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

Expand
Table 16.15. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 16.16. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 16.17. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the python-magnumclient plugin.

16.8. coe cluster show

Usage:

openstack coe cluster show [-h] [-f {json,shell,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--prefix PREFIX]
                                <cluster>
Copy to Clipboard Toggle word wrap

Show a Cluster

Expand
Table 16.18. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster to show.

Expand
Table 16.19. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 16.20. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 16.21. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 16.22. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 16.23. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-magnumclient plugin.

16.9. coe cluster template create

Usage:

openstack coe cluster template create [-h]

                                           [-f {json,shell,table,value,yaml}]
                                           [-c COLUMN]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--noindent] [--prefix PREFIX]
                                           --coe <coe> --image <image>
                                           --external-network
                                           <external-network>
                                           [--keypair <keypair>]
                                           [--fixed-network <fixed-network>]
                                           [--fixed-subnet <fixed-subnet>]
                                           [--network-driver <network-driver>]
                                           [--volume-driver <volume-driver>]
                                           [--dns-nameserver <dns-nameserver>]
                                           [--flavor <flavor>]
                                           [--master-flavor <master-flavor>]
                                           [--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]
                                           [--floating-ip-disabled]
                                           <name>
Copy to Clipboard Toggle word wrap

Create a Cluster Template.

Expand
Table 16.24. Positional Arguments
ValueSummary

<name>

Name of the cluster template to create.

Expand
Table 16.25. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--coe <coe>

Specify the container orchestration engine to use.

--image <image>

The name or uuid of the base image to customize for the Cluster.

--external-network <external-network>

The external Neutron network name or UUID to connect to this Cluster Template.

--keypair <keypair>

The name or uuid of the ssh keypair to load into the Cluster nodes.

--fixed-network <fixed-network>

The private Neutron network name to connect to this Cluster model.

--fixed-subnet <fixed-subnet>

The private Neutron subnet name to connect to Cluster.

--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 <flavor>

The nova flavor name or uuid to use when launching the Cluster.

--master-flavor <master-flavor>

The nova flavor name or UUID to use when launching the master node of the Cluster.

--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 Cluster.

--https-proxy <https-proxy>

The https_proxy address to use for nodes in Cluster.

--no-proxy <no-proxy>

The no_proxy address to use for nodes in Cluster.

--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 cluster.

--public

Make cluster template public.

--registry-enabled

Enable docker registry in the cluster

--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 clusters should have a load balancer for master nodes or not.

--floating-ip-enabled

Indicates whether created Clusters should have a floating ip.

--floating-ip-disabled

Disables floating ip creation on the new Cluster

Expand
Table 16.26. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 16.27. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 16.28. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 16.29. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-magnumclient plugin.

16.10. coe cluster template delete

Usage:

openstack coe cluster template delete [-h]

                                           <cluster-templates>
                                           [<cluster-templates> ...]
Copy to Clipboard Toggle word wrap

Delete a Cluster Template.

Expand
Table 16.30. Positional Arguments
ValueSummary

<cluster-templates>

Id or name of the (cluster template)s to delete.

Expand
Table 16.31. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-magnumclient plugin.

16.11. coe cluster template list

Usage:

openstack coe cluster template list [-h]

                                         [-f {csv,json,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent]
                                         [--quote {all,minimal,none,nonnumeric}]
                                         [--sort-column SORT_COLUMN]
                                         [--limit <limit>]
                                         [--sort-key <sort-key>]
                                         [--sort-dir <sort-dir>]
                                         [--fields <fields>]
Copy to Clipboard Toggle word wrap

List Cluster Templates.

Expand
Table 16.32. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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

Expand
Table 16.33. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

Expand
Table 16.34. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 16.35. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 16.36. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the python-magnumclient plugin.

16.12. coe cluster template show

Usage:

openstack coe cluster template show [-h]

                                         [-f {json,shell,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent] [--prefix PREFIX]
                                         <cluster-template>
Copy to Clipboard Toggle word wrap

Show a Cluster Template.

Expand
Table 16.37. Positional Arguments
ValueSummary

<cluster-template>

Id or name of the cluster template to show.

Expand
Table 16.38. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 16.39. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 16.40. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 16.41. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 16.42. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-magnumclient plugin.

16.13. coe cluster template update

Usage:

openstack coe cluster template update [-h]

                                           [-f {json,shell,table,value,yaml}]
                                           [-c COLUMN]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--noindent] [--prefix PREFIX]
                                           <cluster-template> <op>
                                           <path=value> [<path=value> ...]
Copy to Clipboard Toggle word wrap

Update a Cluster Template.

Expand
Table 16.43. Positional Arguments
ValueSummary

<cluster-template>

The name or uuid of cluster template to update

<op>

Operations: one of 'add', 'replace' or 'remove'

<path=value>

Attributes to add/replace or remove (only path is necessary on remove)

Expand
Table 16.44. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 16.45. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 16.46. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 16.47. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 16.48. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-magnumclient plugin.

16.14. coe cluster update

Usage:

openstack coe cluster update [-h] [--rollback]

                                  <cluster> <op> <path=value>
                                  [<path=value> ...]
Copy to Clipboard Toggle word wrap

Update a Cluster

Expand
Table 16.49. Positional Arguments
ValueSummary

<cluster>

The name or uuid of cluster to update

<op>

Operations: one of 'add', 'replace' or 'remove'

<path=value>

Attributes to add/replace or remove (only path is necessary on remove)

Expand
Table 16.50. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--rollback

Rollback cluster on update failure.

This command is provided by the python-magnumclient plugin.

16.15. coe quotas create

Usage:

openstack coe quotas create [-h] --project-id <project-id> --resource

                                 <resource> [--hard-limit <hard-limit>]
Copy to Clipboard Toggle word wrap

Create a quota.

Expand
Table 16.51. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--project-id <project-id>

Project ID

--resource <resource>

Resource name.

--hard-limit <hard-limit>

Max resource limit (default: hard-limit=1)

This command is provided by the python-magnumclient plugin.

16.16. coe quotas delete

Usage:

openstack coe quotas delete [-h] --project-id <project-id> --resource

                                 <resource>
Copy to Clipboard Toggle word wrap

Delete specified resource quota.

Expand
Table 16.52. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--project-id <project-id>

Project ID

--resource <resource>

Resource name.

This command is provided by the python-magnumclient plugin.

16.17. coe quotas list

Usage:

openstack coe quotas list [-h] [--marker <marker>] [--limit <limit>]

                               [--sort-key <sort-key>]
                               [--sort-dir <sort-dir>] [--all-tenants]
Copy to Clipboard Toggle word wrap

Print a list of available quotas.

Expand
Table 16.53. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--marker <marker>

The last quota uuid of the previous page; displays list of quotas after "marker".

--limit <limit>

Maximum number of quotas to return.

--sort-key <sort-key>

Column to sort results by.

--sort-dir <sort-dir>

Direction to sort. "asc" or "desc".

--all-tenants

Flag to indicate list all tenant quotas.

This command is provided by the python-magnumclient plugin.

16.18. coe quotas show

Usage:

openstack coe quotas show [-h] --project-id <project-id> --resource

                               <resource>
Copy to Clipboard Toggle word wrap

Show details about the given project resource quota.

Expand
Table 16.54. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--project-id <project-id>

Project ID

--resource <resource>

Resource name.

This command is provided by the python-magnumclient plugin.

16.19. coe quotas update

Usage:

openstack coe quotas update [-h] --project-id <project-id> --resource

                                 <resource> [--hard-limit <hard-limit>]
Copy to Clipboard Toggle word wrap

Update information about the given project resource quota.

Expand
Table 16.55. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--project-id <project-id>

Project ID

--resource <resource>

Resource name.

--hard-limit <hard-limit>

Max resource limit (default: hard-limit=1)

This command is provided by the python-magnumclient plugin.

16.20. coe service list

Usage:

openstack coe service list [-h] [-f {csv,json,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--quote {all,minimal,none,nonnumeric}]
                                [--sort-column SORT_COLUMN]
Copy to Clipboard Toggle word wrap

Print a list of Magnum services.

Expand
Table 16.56. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 16.57. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

Expand
Table 16.58. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 16.59. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 16.60. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the python-magnumclient plugin.

16.21. coe stats list

Usage:

openstack coe stats list [-h] <project>
Copy to Clipboard Toggle word wrap

Show stats for the given project_id

Expand
Table 16.61. Positional Arguments
ValueSummary

<project>

Project id

Expand
Table 16.62. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-magnumclient plugin.

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat