diff options
author | Nicolas Vollmar <nvo@scaling.ch> | 2024-05-15 12:56:47 +0200 |
---|---|---|
committer | Christian Breunig <christian@breunig.cc> | 2024-05-16 07:29:19 +0200 |
commit | aa63e6f08cb2bc677b71e383604cae79c1be4ee0 (patch) | |
tree | da11af48ad3a1eb5d1e1bb759cffce8b71c13fed | |
parent | 67f126d84f1dcb870e8bb0e62f44696c6c63e812 (diff) | |
download | vyos-documentation-aa63e6f08cb2bc677b71e383604cae79c1be4ee0.tar.gz vyos-documentation-aa63e6f08cb2bc677b71e383604cae79c1be4ee0.zip |
Add missing container commands
(cherry picked from commit 02739d2a03f6edff1755594b4997635e15a8624f)
-rw-r--r-- | docs/configuration/container/index.rst | 58 |
1 files changed, 45 insertions, 13 deletions
diff --git a/docs/configuration/container/index.rst b/docs/configuration/container/index.rst index c25b0be0..39215f98 100644 --- a/docs/configuration/container/index.rst +++ b/docs/configuration/container/index.rst @@ -21,12 +21,34 @@ Configuration If a registry is not specified, Docker.io will be used as the container registry unless an alternative registry is specified using - **set container registry <name>** or the registry is included in the image name + **set container registry <name>** or the registry is included + in the image name .. code-block:: none set container name mysql-server image quay.io/mysql:8.0 +.. cfgcmd:: set container name <name> entrypoint <entrypoint> + + Override the default entrypoint from the image for a container. + +.. cfgcmd:: set container name <name> command <command> + + Override the default command from the image for a container. + +.. cfgcmd:: set container name <name> arguments <arguments> + + Set the command arguments for a container. + +.. cfgcmd:: set container name <name> uid <userid> +.. cfgcmd:: set container name <name> gid <groupid> + + Set user ID and/or group ID a container will run as. + +.. cfgcmd:: set container name <name> host-name <hostname> + + Set the host name for a container. + .. cfgcmd:: set container name <name> allow-host-networks Allow host networking in a container. The network stack of the container is @@ -47,7 +69,8 @@ Configuration Optionally set a specific static IPv4 or IPv6 address for the container. This address must be within the named network prefix. - .. note:: The first IP in the container network is reserved by the engine and cannot be used + .. note:: The first IP in the container network is reserved by the + engine and cannot be used .. cfgcmd:: set container name <name> description <text> @@ -103,8 +126,10 @@ Configuration Set the restart behavior of the container. - **no**: Do not restart containers on exit - - **on-failure**: Restart containers when they exit with a non-zero exit code, retrying indefinitely (default) - - **always**: Restart containers when they exit, regardless of status, retrying indefinitely + - **on-failure**: Restart containers when they exit with a non-zero + exit code, retrying indefinitely (default) + - **always**: Restart containers when they exit, regardless of status, + retrying indefinitely .. cfgcmd:: set container name <name> memory <MB> @@ -122,12 +147,18 @@ Configuration Set container capabilities or permissions. - **net-admin**: Network operations (interface, firewall, routing tables) - - **net-bind-service**: Bind a socket to privileged ports (port numbers less than 1024) + - **net-bind-service**: Bind a socket to privileged ports + (port numbers less than 1024) - **net-raw**: Permission to create raw network sockets - **setpcap**: Capability sets (from bounded or inherited set) - - **sys-admin**: Administation operations (quotactl, mount, sethostname, setdomainame) + - **sys-admin**: Administration operations (quotactl, mount, sethostname, + setdomainame) - **sys-time**: Permission to set system clock +.. cfgcmd:: set container name <name> label <label> value <value> + + Add metadata label for this container. + .. cfgcmd:: set container name <name> disable Disable a container. @@ -216,16 +247,17 @@ Example Configuration ********************* For the sake of demonstration, `example #1 in the official documentation - <https://www.zabbix.com/documentation/current/manual/installation/containers>`_ + <https://www.zabbix.com/documentation/current/manual/ + installation/containers>`_ to the declarative VyOS CLI syntax. .. code-block:: none - set container network zabbix-net prefix 172.20.0.0/16 - set container network zabbix-net description 'Network for Zabbix component containers' + set container network zabbix prefix 172.20.0.0/16 + set container network zabbix description 'Network for Zabbix component containers' set container name mysql-server image mysql:8.0 - set container name mysql-server network zabbix-net + set container name mysql-server network zabbix set container name mysql-server environment 'MYSQL_DATABASE' value 'zabbix' set container name mysql-server environment 'MYSQL_USER' value 'zabbix' @@ -233,10 +265,10 @@ Example Configuration set container name mysql-server environment 'MYSQL_ROOT_PASSWORD' value 'root_pwd' set container name zabbix-java-gateway image zabbix/zabbix-java-gateway:alpine-5.2-latest - set container name zabbix-java-gateway network zabbix-net + set container name zabbix-java-gateway network zabbix set container name zabbix-server-mysql image zabbix/zabbix-server-mysql:alpine-5.2-latest - set container name zabbix-server-mysql network zabbix-net + set container name zabbix-server-mysql network zabbix set container name zabbix-server-mysql environment 'DB_SERVER_HOST' value 'mysql-server' set container name zabbix-server-mysql environment 'MYSQL_DATABASE' value 'zabbix' @@ -249,7 +281,7 @@ Example Configuration set container name zabbix-server-mysql port zabbix destination 10051 set container name zabbix-web-nginx-mysql image zabbix/zabbix-web-nginx-mysql:alpine-5.2-latest - set container name zabbix-web-nginx-mysql network zabbix-net + set container name zabbix-web-nginx-mysql network zabbix set container name zabbix-web-nginx-mysql environment 'MYSQL_DATABASE' value 'zabbix' set container name zabbix-web-nginx-mysql environment 'ZBX_SERVER_HOST' value 'zabbix-server-mysql' |