This commit is contained in:
felixfontein
2026-08-17 09:21:49 +00:00
parent 4492650667
commit 8ea4066e18
28 changed files with 114 additions and 114 deletions
+31 -31
View File
@@ -1856,25 +1856,25 @@ see <a class="reference internal" href="#ansible-collections-community-docker-do
<span class="w"> </span><span class="nt">state</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">started</span>
<span class="w"> </span><span class="nt">restart</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
<span class="w"> </span><span class="nt">links</span><span class="p">:</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;myredis:aliasedredis&quot;</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">"myredis:aliasedredis"</span>
<span class="w"> </span><span class="nt">devices</span><span class="p">:</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;/dev/sda:/dev/xvda:rwm&quot;</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">"/dev/sda:/dev/xvda:rwm"</span>
<span class="w"> </span><span class="nt">ports</span><span class="p">:</span>
<span class="w"> </span><span class="c1"># Publish container port 9000 as host port 8080</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;8080:9000&quot;</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">"8080:9000"</span>
<span class="w"> </span><span class="c1"># Publish container UDP port 9001 as host port 8081 on interface 127.0.0.1</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;127.0.0.1:8081:9001/udp&quot;</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">"127.0.0.1:8081:9001/udp"</span>
<span class="w"> </span><span class="c1"># Publish container port 9002 as a random host port</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;9002&quot;</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">"9002"</span>
<span class="w"> </span><span class="c1"># Publish container port 9003 as a free host port in range 8000-8100</span>
<span class="w"> </span><span class="c1"># (the host port will be selected by the Docker daemon)</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;8000-8100:9003&quot;</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">"8000-8100:9003"</span>
<span class="w"> </span><span class="c1"># Publish container ports 9010-9020 to host ports 7000-7010</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;7000-7010:9010-9020&quot;</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">"7000-7010:9010-9020"</span>
<span class="w"> </span><span class="nt">env</span><span class="p">:</span>
<span class="w"> </span><span class="nt">SECRET_KEY</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;ssssh&quot;</span>
<span class="w"> </span><span class="nt">SECRET_KEY</span><span class="p">:</span><span class="w"> </span><span class="s">"ssssh"</span>
<span class="w"> </span><span class="c1"># Values which might be parsed as numbers, booleans or other types by the YAML parser need to be quoted</span>
<span class="w"> </span><span class="nt">BOOLEAN_KEY</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;yes&quot;</span>
<span class="w"> </span><span class="nt">BOOLEAN_KEY</span><span class="p">:</span><span class="w"> </span><span class="s">"yes"</span>
<span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Container present</span>
<span class="w"> </span><span class="nt">community.docker.docker_container</span><span class="p">:</span>
@@ -1890,7 +1890,7 @@ see <a class="reference internal" href="#ansible-collections-community-docker-do
<span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Start 4 load-balanced containers</span>
<span class="w"> </span><span class="nt">community.docker.docker_container</span><span class="p">:</span>
<span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;container</span><span class="cp">{{</span> <span class="nv">item</span> <span class="cp">}}</span><span class="s">&quot;</span>
<span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="s">"container</span><span class="cp">{{</span> <span class="nv">item</span> <span class="cp">}}</span><span class="s">"</span>
<span class="w"> </span><span class="nt">recreate</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
<span class="w"> </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">someuser/anotherappimage</span>
<span class="w"> </span><span class="nt">command</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">sleep 1d</span>
@@ -1909,16 +1909,16 @@ see <a class="reference internal" href="#ansible-collections-community-docker-do
<span class="w"> </span><span class="nt">log_options</span><span class="p">:</span>
<span class="w"> </span><span class="nt">syslog-address</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">tcp://my-syslog-server:514</span>
<span class="w"> </span><span class="nt">syslog-facility</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">daemon</span>
<span class="w"> </span><span class="c1"># NOTE: in Docker 1.13+ the &quot;syslog-tag&quot; option was renamed to &quot;tag&quot; for</span>
<span class="w"> </span><span class="c1"># older docker installs, use &quot;syslog-tag&quot; instead</span>
<span class="w"> </span><span class="c1"># NOTE: in Docker 1.13+ the "syslog-tag" option was renamed to "tag" for</span>
<span class="w"> </span><span class="c1"># older docker installs, use "syslog-tag" instead</span>
<span class="w"> </span><span class="nt">tag</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">myservice</span>
<span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Create db container and connect to network</span>
<span class="w"> </span><span class="nt">community.docker.docker_container</span><span class="p">:</span>
<span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">db_test</span>
<span class="w"> </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;postgres:latest&quot;</span>
<span class="w"> </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="s">"postgres:latest"</span>
<span class="w"> </span><span class="nt">networks</span><span class="p">:</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;</span><span class="cp">{{</span> <span class="nv">docker_network_name</span> <span class="cp">}}</span><span class="s">&quot;</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="s">"</span><span class="cp">{{</span> <span class="nv">docker_network_name</span> <span class="cp">}}</span><span class="s">"</span>
<span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Start container, connect to network and link</span>
<span class="w"> </span><span class="nt">community.docker.docker_container</span><span class="p">:</span>
@@ -1926,7 +1926,7 @@ see <a class="reference internal" href="#ansible-collections-community-docker-do
<span class="w"> </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ubuntu:14.04</span>
<span class="w"> </span><span class="nt">networks</span><span class="p">:</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">TestingNet</span>
<span class="w"> </span><span class="nt">ipv4_address</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;172.16.1.100&quot;</span>
<span class="w"> </span><span class="nt">ipv4_address</span><span class="p">:</span><span class="w"> </span><span class="s">"172.16.1.100"</span>
<span class="w"> </span><span class="nt">aliases</span><span class="p">:</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">sleepyzz</span>
<span class="w"> </span><span class="nt">links</span><span class="p">:</span>
@@ -1937,7 +1937,7 @@ see <a class="reference internal" href="#ansible-collections-community-docker-do
<span class="w"> </span><span class="nt">community.docker.docker_container</span><span class="p">:</span>
<span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">sleepy</span>
<span class="w"> </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ubuntu:14.04</span>
<span class="w"> </span><span class="nt">command</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;sleep&quot;</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="s">&quot;infinity&quot;</span><span class="p p-Indicator">]</span>
<span class="w"> </span><span class="nt">command</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">"sleep"</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="s">"infinity"</span><span class="p p-Indicator">]</span>
<span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Add container to networks</span>
<span class="w"> </span><span class="nt">community.docker.docker_container</span><span class="p">:</span>
@@ -1994,24 +1994,24 @@ see <a class="reference internal" href="#ansible-collections-community-docker-do
<span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">test</span>
<span class="w"> </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ubuntu:18.04</span>
<span class="w"> </span><span class="nt">env</span><span class="p">:</span>
<span class="w"> </span><span class="nt">arg1</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;true&quot;</span>
<span class="w"> </span><span class="nt">arg2</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;whatever&quot;</span>
<span class="w"> </span><span class="nt">arg1</span><span class="p">:</span><span class="w"> </span><span class="s">"true"</span>
<span class="w"> </span><span class="nt">arg2</span><span class="p">:</span><span class="w"> </span><span class="s">"whatever"</span>
<span class="w"> </span><span class="nt">volumes</span><span class="p">:</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/tmp:/tmp</span>
<span class="w"> </span><span class="nt">comparisons</span><span class="p">:</span>
<span class="w"> </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ignore</span><span class="w"> </span><span class="c1"># do not restart containers with older versions of the image</span>
<span class="w"> </span><span class="nt">env</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">strict</span><span class="w"> </span><span class="c1"># we want precisely this environment</span>
<span class="w"> </span><span class="nt">volumes</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">allow_more_present</span><span class="w"> </span><span class="c1"># if there are more volumes, that&#39;s ok, as long as `/tmp:/tmp` is there</span>
<span class="w"> </span><span class="nt">volumes</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">allow_more_present</span><span class="w"> </span><span class="c1"># if there are more volumes, that's ok, as long as `/tmp:/tmp` is there</span>
<span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Finer container restart/update control II</span>
<span class="w"> </span><span class="nt">community.docker.docker_container</span><span class="p">:</span>
<span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">test</span>
<span class="w"> </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ubuntu:18.04</span>
<span class="w"> </span><span class="nt">env</span><span class="p">:</span>
<span class="w"> </span><span class="nt">arg1</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;true&quot;</span>
<span class="w"> </span><span class="nt">arg2</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;whatever&quot;</span>
<span class="w"> </span><span class="nt">arg1</span><span class="p">:</span><span class="w"> </span><span class="s">"true"</span>
<span class="w"> </span><span class="nt">arg2</span><span class="p">:</span><span class="w"> </span><span class="s">"whatever"</span>
<span class="w"> </span><span class="nt">comparisons</span><span class="p">:</span>
<span class="w"> </span><span class="s">&#39;*&#39;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ignore</span><span class="w"> </span><span class="c1"># by default, ignore *all* options (including image)</span>
<span class="w"> </span><span class="s">'*'</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ignore</span><span class="w"> </span><span class="c1"># by default, ignore *all* options (including image)</span>
<span class="w"> </span><span class="nt">env</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">strict</span><span class="w"> </span><span class="c1"># except for environment variables; there, we want to be strict</span>
<span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Start container with healthstatus</span>
@@ -2020,9 +2020,9 @@ see <a class="reference internal" href="#ansible-collections-community-docker-do
<span class="w"> </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">nginx:1.13</span>
<span class="w"> </span><span class="nt">state</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">started</span>
<span class="w"> </span><span class="nt">healthcheck</span><span class="p">:</span>
<span class="w"> </span><span class="c1"># Check if nginx server is healthy by curl&#39;ing the server.</span>
<span class="w"> </span><span class="c1"># Check if nginx server is healthy by curl'ing the server.</span>
<span class="w"> </span><span class="c1"># If this fails or timeouts, the healthcheck fails.</span>
<span class="w"> </span><span class="nt">test</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;CMD&quot;</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="s">&quot;curl&quot;</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="s">&quot;--fail&quot;</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="s">&quot;http://nginx.host.com&quot;</span><span class="p p-Indicator">]</span>
<span class="w"> </span><span class="nt">test</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">"CMD"</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="s">"curl"</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="s">"--fail"</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="s">"http://nginx.host.com"</span><span class="p p-Indicator">]</span>
<span class="w"> </span><span class="nt">interval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1m30s</span>
<span class="w"> </span><span class="nt">timeout</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10s</span>
<span class="w"> </span><span class="nt">retries</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">3</span>
@@ -2035,8 +2035,8 @@ see <a class="reference internal" href="#ansible-collections-community-docker-do
<span class="w"> </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">nginx:1.13</span>
<span class="w"> </span><span class="nt">state</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">started</span>
<span class="w"> </span><span class="nt">healthcheck</span><span class="p">:</span>
<span class="w"> </span><span class="c1"># The &quot;NONE&quot; check needs to be specified</span>
<span class="w"> </span><span class="nt">test</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;NONE&quot;</span><span class="p p-Indicator">]</span>
<span class="w"> </span><span class="c1"># The "NONE" check needs to be specified</span>
<span class="w"> </span><span class="nt">test</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">"NONE"</span><span class="p p-Indicator">]</span>
<span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Create a tmpfs with a size and mode</span>
<span class="w"> </span><span class="nt">community.docker.docker_container</span><span class="p">:</span>
@@ -2046,8 +2046,8 @@ see <a class="reference internal" href="#ansible-collections-community-docker-do
<span class="w"> </span><span class="nt">mounts</span><span class="p">:</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">tmpfs</span>
<span class="w"> </span><span class="nt">target</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/cache</span>
<span class="w"> </span><span class="nt">tmpfs_mode</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1700&quot;</span><span class="w"> </span><span class="c1"># only readable to the owner</span>
<span class="w"> </span><span class="nt">tmpfs_size</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;16G&quot;</span>
<span class="w"> </span><span class="nt">tmpfs_mode</span><span class="p">:</span><span class="w"> </span><span class="s">"1700"</span><span class="w"> </span><span class="c1"># only readable to the owner</span>
<span class="w"> </span><span class="nt">tmpfs_size</span><span class="p">:</span><span class="w"> </span><span class="s">"16G"</span>
<span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Start container with block device read limit</span>
<span class="w"> </span><span class="nt">community.docker.docker_container</span><span class="p">:</span>
@@ -2071,13 +2071,13 @@ see <a class="reference internal" href="#ansible-collections-community-docker-do
<span class="w"> </span><span class="nt">device_requests</span><span class="p">:</span>
<span class="w"> </span><span class="c1"># Add some specific devices to this container</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">device_ids</span><span class="p">:</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&#39;0&#39;</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&#39;GPU-3a23c669-1f69-c64e-cf85-44e9b07e7a2a&#39;</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">'0'</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">'GPU-3a23c669-1f69-c64e-cf85-44e9b07e7a2a'</span>
<span class="w"> </span><span class="c1"># Add nVidia GPUs to this container</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">driver</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">nvidia</span>
<span class="w"> </span><span class="nt">count</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">-1</span><span class="w"> </span><span class="c1"># this means we want all</span>
<span class="w"> </span><span class="nt">capabilities</span><span class="p">:</span>
<span class="w"> </span><span class="c1"># We have one OR condition: &#39;gpu&#39; AND &#39;utility&#39;</span>
<span class="w"> </span><span class="c1"># We have one OR condition: 'gpu' AND 'utility'</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gpu</span>
<span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">utility</span>
<span class="w"> </span><span class="c1"># See https://github.com/NVIDIA/nvidia-container-runtime#supported-driver-capabilities</span>