List actions on a container
openstack appcontainer action list
[--format-config-file FORMAT_CONFIG]
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
<container>
Config file for the dict-to-csv formatter
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
sort the column(s) in ascending order
sort the column(s) in descending order
ID or name of the container to list actions.
This command is provided by the python-zunclient plugin.
Show a action
openstack appcontainer action show <container> <request_id>
ID or name of the container to show.
request ID of action to describe.
This command is provided by the python-zunclient plugin.
Add floating IP address to container
openstack appcontainer add floating ip
[--fixed-ip-address <ip-address>]
<container>
<ip-address>
Fixed IP address to associate with this floating IP address. The first container port containing the fixed IP address will be used
ID or name of the container to receive the floating IP address.
Floating IP address to assign to the first available container port (IP only)
This command is provided by the python-zunclient plugin.
Add security group for specified container.
openstack appcontainer add security group <container> <security_group>
ID or name of the container to add security group.
Security group ID or name for specified container.
This command is provided by the python-zunclient plugin.
Attach to a running container
openstack appcontainer attach <container>
ID or name of the container to be attached to.
This command is provided by the python-zunclient plugin.
List availability zones
openstack appcontainer availability zone list
[--format-config-file FORMAT_CONFIG]
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
Config file for the dict-to-csv formatter
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
sort the column(s) in ascending order
sort the column(s) in descending order
This command is provided by the python-zunclient plugin.
Create a new image from a container’s changes
openstack appcontainer commit <container> <repository>[:<tag>]
ID or name of the (container)s to commit.
Repository and tag of the new image.
This command is provided by the python-zunclient plugin.
Copy files/tars between a container and the local filesystem.
openstack appcontainer cp <source> <destination>
The source should be copied to the container or localhost. The format of this parameter is [container:]src_path.
The directory destination where save the source. The format of this parameter is [container:]dest_path.
This command is provided by the python-zunclient plugin.
Create a container
openstack appcontainer create
[--name <name>]
[--cpu <cpu>]
[--memory <memory>]
[--environment <KEY=VALUE>]
[--workdir <workdir>]
[--label <KEY=VALUE>]
[--image-pull-policy <policy>]
[--restart <restart> | --auto-remove]
[--image-driver <image_driver>]
[--interactive]
[--security-group <security_group> | --expose-port <port>]
[--hint <key=value>]
[--net <network=network, port=port-uuid,v4-fixed-ip=ip-addr,v6-fixed-ip=ip-addr>]
[--mount <mount>]
[--runtime <runtime>]
[--hostname <hostname>]
[--disk <disk>]
[--availability-zone <availability_zone>]
[--auto-heal]
[--privileged]
[--healthcheck <cmd=test_cmd,interval=time,retries=n,timeout=time>]
[--wait]
[--registry <registry>]
[--host <host>]
[--entrypoint <entrypoint>]
<image>
...
name of the container
The number of virtual cpus.
The container memory size in MiB
The environment variables
The working directory for commands to run in
Adds a map of labels to a container. May be used multiple times.
The policy which determines if the image should be pulled prior to starting the container. It can have following values: “ifnotpresent”: only pull the image if it does not already exist on the node. “always”: Always pull the image from repository.”never”: never pull the image
Restart policy to apply when a container exits(no, on-failure[:max-retry], always, unless-stopped)
Automatically remove the container when it exits
The image driver to use to pull container image. It can have following values: “docker”: pull the image from Docker Hub. “glance”: pull the image from Glance.
Keep STDIN open even if not attached, allocate a pseudo-TTY
The name of security group for the container. May be used multiple times.
Expose container port(s) to outside (format: <port>[/<protocol>]).
The key-value pair(s) for scheduler to select host. The format of this parameter is “key=value[,key=value]”. May be used multiple times.
Create network enpoints for the container. network: attach container to the specified neutron networks. port: attach container to the neutron port with this UUID. v4-fixed-ip: IPv4 fixed address for container. v6-fixed-ip: IPv6 fixed address for container.
A dictionary to configure volumes mounted inside the container.
The runtime to use for this container. It can have value “runc” or any other custom runtime.
Container host name
The disk size in GiB for per container.
The availability zone of the container.
The flag of healing non-existent container in docker
Give extended privileges to this container
Specify a test cmd to perform to check that the containeris healthy. cmd: Command to run to check health. interval: Time between running the check (s|m|h
) (default 0s). retries: Consecutive failures needed to report unhealthy.timeout: Maximum time to allow one check to run (s|m|h
) (default 0s).
Wait for create to complete
The container image registry ID or name.
Requested host to create containers. Admin only by default. (supported by –os-container-api-version 1.39 or above
The entrypoint which overwrites the default ENTRYPOINT of the image.
name or ID or repo of the image (e.g. cirros:latest)
Send command to the container
This command is provided by the python-zunclient plugin.
Delete specified container(s)
openstack appcontainer delete
[--force]
[--stop]
[--all-projects]
[--wait]
<container>
[<container> ...]
Force delete the container.
Stop the running container first before delete.
Delete container(s) in all projects by name.
Wait for create to complete
ID or name of the container(s) to delete.
This command is provided by the python-zunclient plugin.
Execute command in a running container
openstack appcontainer exec [--interactive] <container> ...
Keep STDIN open and allocate a pseudo-TTY for interactive
ID or name of the container to execute command in.
The command to execute.
This command is provided by the python-zunclient plugin.
List available hosts
openstack appcontainer host list
[--format-config-file FORMAT_CONFIG]
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--marker <marker>]
[--limit <limit>]
[--sort-key <sort-key>]
[--sort-dir <sort-dir>]
Config file for the dict-to-csv formatter
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
sort the column(s) in ascending order
sort the column(s) in descending order
The last host UUID of the previous page; displays list of hosts after “marker”.
Maximum number of hosts to return
Column to sort results by
Direction to sort. “asc” or “desc”.
This command is provided by the python-zunclient plugin.
Show a host
openstack appcontainer host show <host>
ID or name of the host to show.
This command is provided by the python-zunclient plugin.
Delete specified image from a host
openstack appcontainer image delete <uuid>
UUID of image to describe
This command is provided by the python-zunclient plugin.
List available images
openstack appcontainer image list
[--format-config-file FORMAT_CONFIG]
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--marker <marker>]
[--limit <limit>]
[--sort-key <sort-key>]
[--sort-dir <sort-dir>]
Config file for the dict-to-csv formatter
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
sort the column(s) in ascending order
sort the column(s) in descending order
The last image UUID of the previous page; displays list of images after “marker”.
Maximum number of images to return
Column to sort results by
Direction to sort. “asc” or “desc”.
This command is provided by the python-zunclient plugin.
Pull specified image into a host
openstack appcontainer image pull <image> <host>
Name of the image
Name or UUID of the host
This command is provided by the python-zunclient plugin.
Search specified image
openstack appcontainer image search
[--format-config-file FORMAT_CONFIG]
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--image-driver <image-driver>]
[--exact-match]
<image_name>
Config file for the dict-to-csv formatter
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
sort the column(s) in ascending order
sort the column(s) in descending order
Name of the image driver
exact match image name
Name of the image
This command is provided by the python-zunclient plugin.
Describe a specific image
openstack appcontainer image show <uuid>
UUID of image to describe
This command is provided by the python-zunclient plugin.
Kill one or more running container(s)
openstack appcontainer kill
[--signal <signal>]
<container>
[<container> ...]
The signal to kill
ID or name of the (container)s to kill.
This command is provided by the python-zunclient plugin.
List available containers
openstack appcontainer list
[--format-config-file FORMAT_CONFIG]
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--all-projects]
[--marker <marker>]
[--limit <limit>]
[--sort-key <sort-key>]
[--sort-dir <sort-dir>]
[--name <name>]
[--image <image>]
[--project-id <project-id>]
[--user-id <user-id>]
[--task-state <task-state>]
[--status <status>]
[--memory <memory>]
[--host <host>]
[--auto-remove <auto-remove>]
Config file for the dict-to-csv formatter
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
sort the column(s) in ascending order
sort the column(s) in descending order
List containers in all projects
The last container UUID of the previous page; displays list of containers after “marker”.
Maximum number of containers to return
Column to sort results by
Direction to sort. “asc” or “desc”.
List containers according to their name.
List containers according to their image.
List containers according to their project_id
List containers according to their user_id
List containers according to their task-state
List containers according to their Status
List containers according to their memory size in MiB
List containers according to their hostname
List containers whether they are auto-removed on exiting
This command is provided by the python-zunclient plugin.
Get logs of a container
openstack appcontainer logs
[--stdout]
[--stderr]
[--since <since>]
[--timestamps]
[--tail <tail>]
<container>
Only stdout logs of container.
Only stderr logs of container.
Show logs since a given datetime or integer epoch (in seconds).
Show timestamps.
Number of lines to show from the end of the logs.
ID or name of the container to get logs for.
This command is provided by the python-zunclient plugin.
Attach neutron network to specified container.
openstack appcontainer network attach
[--network <network>]
[--port <port>]
[--fixed-ip <fixed_ip>]
<container>
The network for specified container to attach.
The port for specified container to attach.
The fixed-ip that container will attach to.
ID or name of the container to attach network.
This command is provided by the python-zunclient plugin.
Detach neutron network from specified container.
openstack appcontainer network detach
[--network <network> | --port <port>]
<container>
The network for specified container to detach.
The port for specified container to detach.
ID or name of the container to detach network.
This command is provided by the python-zunclient plugin.
List networks on a container
openstack appcontainer network list
[--format-config-file FORMAT_CONFIG]
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
<container>
Config file for the dict-to-csv formatter
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
sort the column(s) in ascending order
sort the column(s) in descending order
ID or name of the container to list networks.
This command is provided by the python-zunclient plugin.
Pause specified container
openstack appcontainer pause <container> [<container> ...]
ID or name of the (container)s to pause.
This command is provided by the python-zunclient plugin.
List the quotas for a quota class
openstack appcontainer quota class get <quota_class_name>
The name of quota class
This command is provided by the python-zunclient plugin.
Update the quotas for a quota class
openstack appcontainer quota class update
[--containers <containers>]
[--memory <memory>]
[--cpu <cpu>]
[--disk <disk>]
<quota_class_name>
The number of containers allowed per project
The number of megabytes of container RAM allowed per project
The number of container cores or vCPUs allowed per project
The number of gigabytes of container Disk allowed per project
The name of quota class
This command is provided by the python-zunclient plugin.
Get default quota of the project
openstack appcontainer quota default <project_id>
The UUID of project in a multi-project cloud
This command is provided by the python-zunclient plugin.
Delete quota of the project
openstack appcontainer quota delete <project_id>
The UUID of project in a multi-project cloud
This command is provided by the python-zunclient plugin.
Get quota of the project
openstack appcontainer quota get [--usages] <project_id>
Whether show quota usage statistic or not
The UUID of project in a multi-project cloud
This command is provided by the python-zunclient plugin.
Update the quotas of the project
openstack appcontainer quota update
[--containers <containers>]
[--memory <memory>]
[--cpu <cpu>]
[--disk <disk>]
<project_id>
The number of containers allowed per project
The number of megabytes of container RAM allowed per project
The number of container cores or vCPUs allowed per project
The number of gigabytes of container Disk allowed per project
The UUID of project in a multi-project cloud
This command is provided by the python-zunclient plugin.
Rebuild one or more running container(s)
openstack appcontainer rebuild
[--image <image>]
[--image-driver <image_driver>]
[--wait]
<container>
[<container> ...]
The image for specified container to update.
The image driver to use to update container image. It can have following values: “docker”: update the image from Docker Hub. “glance”: update the image from Glance. The default value is source container’s image driver
Wait for rebuild to complete
ID or name of the (container)s to rebuild.
This command is provided by the python-zunclient plugin.
Create a registry
openstack appcontainer registry create
[--name <name>]
[--username <username>]
[--password <password>]
--domain <domain>
The name of the registry.
The username to login to the registry.
The password to login to the registry.
The domain of the registry.
This command is provided by the python-zunclient plugin.
Delete specified registry(s)
openstack appcontainer registry delete <registry> [<registry> ...]
ID or name of the registry(s) to delete.
This command is provided by the python-zunclient plugin.
List available registries
openstack appcontainer registry list
[--format-config-file FORMAT_CONFIG]
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--all-projects]
[--marker <marker>]
[--limit <limit>]
[--sort-key <sort-key>]
[--sort-dir <sort-dir>]
[--name <name>]
[--domain <domain>]
[--project-id <project-id>]
[--user-id <user-id>]
[--username <username>]
Config file for the dict-to-csv formatter
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
sort the column(s) in ascending order
sort the column(s) in descending order
List registries in all projects
The last registry UUID of the previous page; displays list of registries after “marker”.
Maximum number of registries to return
Column to sort results by
Direction to sort. “asc” or “desc”.
List registries according to their name.
List registries according to their domain.
List registries according to their project_id
List registries according to their user_id
List registries according to their username
This command is provided by the python-zunclient plugin.
Show a registry
openstack appcontainer registry show <registry>
ID or name of the registry to show.
This command is provided by the python-zunclient plugin.
Update one or more attributes of the registry
openstack appcontainer registry update
[--username <username>]
[--password <password>]
[--name <name>]
[--domain <domain>]
<registry>
The new username of registry to update.
The new password of registry to update.
The new name of registry to update.
The new domain of registry to update.
ID or name of the registry to update.
This command is provided by the python-zunclient plugin.
Remove floating IP address from container
openstack appcontainer remove floating ip <ip-address>
Floating IP address to remove from container (IP only)
This command is provided by the python-zunclient plugin.
Remove security group for specified container.
openstack appcontainer remove security group
<container>
<security_group>
ID or name of the container to remove security group.
The security group to remove from specified container.
This command is provided by the python-zunclient plugin.
Restart specified container
openstack appcontainer restart
[--timeout <timeout>]
<container>
[<container> ...]
Seconds to wait for stop before restarting (container)s
ID or name of the (container)s to restart.
This command is provided by the python-zunclient plugin.
Create and run a new container
openstack appcontainer run
[--name <name>]
[--cpu <cpu>]
[--memory <memory>]
[--environment <KEY=VALUE>]
[--workdir <workdir>]
[--label <KEY=VALUE>]
[--image-pull-policy <policy>]
[--restart <restart> | --auto-remove]
[--image-driver <image_driver>]
[--interactive]
[--security-group <security_group> | --expose-port <port>]
[--hint <key=value>]
[--net <network=network, port=port-uuid,v4-fixed-ip=ip-addr,v6-fixed-ip=ip-addr>]
[--mount <mount>]
[--runtime <runtime>]
[--hostname <hostname>]
[--disk <disk>]
[--availability-zone <availability_zone>]
[--auto-heal]
[--privileged]
[--healthcheck <cmd=test_cmd,interval=time,retries=n,timeout=time>]
[--wait]
[--registry <registry>]
[--host <host>]
[--entrypoint <entrypoint>]
<image>
...
name of the container
The number of virtual cpus.
The container memory size in MiB
The environment variables
The working directory for commands to run in
Adds a map of labels to a container. May be used multiple times.
The policy which determines if the image should be pulled prior to starting the container. It can have following values: “ifnotpresent”: only pull the image if it does not already exist on the node. “always”: Always pull the image from repository.”never”: never pull the image
Restart policy to apply when a container exits(no, on-failure[:max-retry], always, unless-stopped)
Automatically remove the container when it exits
The image driver to use to pull container image. It can have following values: “docker”: pull the image from Docker Hub. “glance”: pull the image from Glance.
Keep STDIN open even if not attached, allocate a pseudo-TTY
The name of security group for the container. May be used multiple times.
Expose container port(s) to outside (format: <port>[/<protocol>]).
The key-value pair(s) for scheduler to select host. The format of this parameter is “key=value[,key=value]”. May be used multiple times.
Create network enpoints for the container. network: attach container to the specified neutron networks. port: attach container to the neutron port with this UUID. v4-fixed-ip: IPv4 fixed address for container. v6-fixed-ip: IPv6 fixed address for container.
A dictionary to configure volumes mounted inside the container.
The runtime to use for this container. It can have value “runc” or any other custom runtime.
Container host name
The disk size in GiB for per container.
The availability zone of the container.
The flag of healing non-existent container in docker
Give extended privileges to this container
Specify a test cmd to perform to check that the containeris healthy. cmd: Command to run to check health. interval: Time between running the check (s|m|h
) (default 0s). retries: Consecutive failures needed to report unhealthy.timeout: Maximum time to allow one check to run (s|m|h
) (default 0s).
Wait for run to complete
The container image registry ID or name.
Requested host to run containers. Admin only by default. (supported by –os-container-api-version 1.39 or above
The entrypoint which overwrites the default ENTRYPOINT of the image.
name or ID of the image
Send command to the container
This command is provided by the python-zunclient plugin.
Delete the Zun binaries/services.
openstack appcontainer service delete <host> <binary>
Name of host
Name of the binary to delete
This command is provided by the python-zunclient plugin.
Disable the Zun service.
openstack appcontainer service disable
[--reason <reason>]
<host>
<binary>
Reason for disabling service
Name of host
Name of the binary to disable
This command is provided by the python-zunclient plugin.
Enable the Zun service.
openstack appcontainer service enable <host> <binary>
Name of host
Name of the binary to enable
This command is provided by the python-zunclient plugin.
Force the Zun service to down or up.
openstack appcontainer service forcedown [--unset] <host> <binary>
Unset the force state down of service
Name of host
Name of the binary to disable
This command is provided by the python-zunclient plugin.
Print a list of zun services.
openstack appcontainer service list
[--format-config-file FORMAT_CONFIG]
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
Config file for the dict-to-csv formatter
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
sort the column(s) in ascending order
sort the column(s) in descending order
This command is provided by the python-zunclient plugin.
Update one or more attributes of the container
openstack appcontainer set
[--cpu <cpu>]
[--memory <memory>]
[--name <name>]
[--auto-heal | --no-auto-heal]
<container>
The number of virtual cpus.
The container memory size in MiB
The new name of container to update
Automatic recovery the status of contaier
Needless recovery the status of contaier
ID or name of the container to update.
This command is provided by the python-zunclient plugin.
Show a container
openstack appcontainer show [--all-projects] <container>
Show container(s) in all projects by name.
ID or name of the container to show.
This command is provided by the python-zunclient plugin.
Start specified container
openstack appcontainer start <container> [<container> ...]
ID or name of the (container)s to start.
This command is provided by the python-zunclient plugin.
Display stats of the container.
openstack appcontainer stats <container>
ID or name of the (container)s to display stats.
This command is provided by the python-zunclient plugin.
Stop specified containers
openstack appcontainer stop
[--timeout <timeout>]
<container>
[<container> ...]
Seconds to wait for stop before killing (container)s
ID or name of the (container)s to stop.
This command is provided by the python-zunclient plugin.
Display the running processes inside the container
openstack appcontainer top [--pid <pid>] <container>
The args of the ps id.
ID or name of the container to display processes.
This command is provided by the python-zunclient plugin.
unpause specified container
openstack appcontainer unpause <container> [<container> ...]
ID or name of the (container)s to unpause.
This command is provided by the python-zunclient plugin.
Create a capsule
openstack capsule create --file <template_file>
Path to the capsule template file.
This command is provided by the python-zunclient plugin.
Delete specified capsule(s)
openstack capsule delete <capsule> [<capsule> ...]
ID or name of the capsule(s) to delete.
This command is provided by the python-zunclient plugin.
List available capsules
openstack capsule list
[--format-config-file FORMAT_CONFIG]
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--all-projects]
[--marker <marker>]
[--limit <limit>]
[--sort-key <sort-key>]
[--sort-dir <sort-dir>]
Config file for the dict-to-csv formatter
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
sort the column(s) in ascending order
sort the column(s) in descending order
List capsules in all projects
The last capsule UUID of the previous page; displays list of capsules after “marker”.
Maximum number of capsules to return
Column to sort results by
Direction to sort. “asc” or “desc”.
This command is provided by the python-zunclient plugin.
Show a capsule
openstack capsule show <capsule>
ID or name of the capsule to show.
This command is provided by the python-zunclient plugin.
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.