From 912d7c28a735a48a43661c8d6c2dbf48cac80db0 Mon Sep 17 00:00:00 2001 From: felixfontein <5781356+felixfontein@users.noreply.github.com> Date: Mon, 17 Aug 2026 19:34:56 +0000 Subject: [PATCH] deploy: 2950337e48f138fdbf9a4d2fe78c5e343291235a --- branch/main/docker_swarm_service_module.html | 236 +++++++++++-------- branch/main/objects.inv | Bin 21016 -> 21029 bytes branch/main/searchindex.js | 2 +- 3 files changed, 133 insertions(+), 105 deletions(-) diff --git a/branch/main/docker_swarm_service_module.html b/branch/main/docker_swarm_service_module.html index 0265f63c..3cfff643 100644 --- a/branch/main/docker_swarm_service_module.html +++ b/branch/main/docker_swarm_service_module.html @@ -237,6 +237,8 @@ see

List arguments to be passed to the container.

Corresponds to the ARG parameter of docker service create.

+

When command_as_args=true, these values are appended after command and both are sent as ContainerSpec.Args (matching the Docker CLI).

+

When command_as_args=false, args is sent as ContainerSpec.Args while command is sent as ContainerSpec.Command.

@@ -299,9 +301,27 @@ see

Command to execute when the container starts.

A command may be either a string or a list or a list of strings.

Corresponds to the COMMAND parameter of docker service create.

+

When command_as_args=false, this is sent as ContainerSpec.Command, which replaces the image ENTRYPOINT. This is the historical module behavior.

+

When command_as_args=true, this is combined with args and sent as ContainerSpec.Args (same as the Docker CLI docker service create IMAGE [COMMAND] [ARG...]), so the image ENTRYPOINT is preserved. Use this for flag-style commands (for example --config.file=...) that must be passed as arguments to the image entrypoint (see https://github.com/ansible-collections/community.docker/issues/1044).

+

command_as_args

+

boolean

+

added in community.docker 5.3.0

+
+

Controls how command and args are mapped to the service ContainerSpec.

+

If false (default), command is written to ContainerSpec.Command and args to ContainerSpec.Args. This matches the historical module behavior (ContainerSpec.Command replaces the image ENTRYPOINT).

+

If true, command and args are concatenated and written only to ContainerSpec.Args, matching docker service create IMAGE [COMMAND] [ARG...] so the image ENTRYPOINT is preserved.

+

The current default will eventually be depreacted and change to true.

+

Choices:

+ +
+ +

configs

list / elements=dictionary

@@ -310,49 +330,49 @@ see
+

config_id

string

Config’s ID.

-
+

config_name

string / required

Config’s name as defined at its creation.

-
+

filename

string

Name of the file containing the config. Defaults to the configs[].config_name if not specified.

-
+

gid

string

GID of the config file’s group.

-
+

mode

integer

File access mode inside the container. Must be an octal number (like 0644 or 0444).

-
+

uid

string

UID of the config file’s owner.

-
+

container_labels

dictionary

@@ -360,7 +380,7 @@ see --container-label option of docker service create.

-
+

debug

boolean

@@ -372,7 +392,7 @@ see
+

dns

list / elements=string

@@ -380,7 +400,7 @@ see --dns option of docker service create.

-
+

dns_options

list / elements=string

@@ -388,7 +408,7 @@ see --dns-option option of docker service create.

-
+

list / elements=string

@@ -396,7 +416,7 @@ see --dns-search option of docker service create.

-
+

docker_host

aliases: docker_url

@@ -407,7 +427,7 @@ see Default: "unix:///var/run/docker.sock"

-
+ @@ -420,7 +440,7 @@ see -
+

env_files

list / elements=path

@@ -439,7 +459,7 @@ see env, then env value will override.

-
+

force_update

boolean

@@ -452,7 +472,7 @@ see
+

groups

list / elements=string

@@ -460,7 +480,7 @@ see --group option of docker service update.

-
+

healthcheck

dictionary

@@ -468,28 +488,28 @@ see healthcheck.interval, healthcheck.timeout, and healthcheck.start_period are specified as durations. They accept duration as a string in a format that look like: 5h34m56s, 1m30s, and so on. The supported units are us, ms, s, m and h.

-
+

interval

string

Time between running the check.

-
+

retries

integer

Consecutive failures needed to report unhealthy. It accept integer value.

-
+

start_period

string

Start period for the container to initialize before starting health-retries countdown.

-
+

test

any

@@ -497,14 +517,14 @@ see NONE, CMD or CMD-SHELL.

-
+

timeout

string

Maximum time to allow one check to run.

-
+

hostname

string

@@ -512,7 +532,7 @@ see --hostname option of docker service create.

-
+

hosts

dictionary

@@ -520,7 +540,7 @@ see --host option of docker service create.

- -
+

init

boolean

@@ -542,7 +562,7 @@ see
+

labels

dictionary

@@ -550,14 +570,14 @@ see --label option of docker service create.

-
+

limits

dictionary

Configures service resource limits.

-
+

cpus

float

@@ -565,7 +585,7 @@ see --limit-cpu option of docker service create.

-
-
+

logging

dictionary

Logging configuration for the service.

-
+

driver

string

@@ -590,7 +610,7 @@ see --log-driver option of docker service create.

-
-
+

mode

string

@@ -614,7 +634,7 @@ see
+

mounts

list / elements=dictionary

@@ -622,7 +642,7 @@ see --mount option of docker service create.

-
+

driver_config

dictionary

@@ -630,28 +650,28 @@ see mounts[].type=volume.

-
+

name

string

Name of the volume-driver plugin to use for the volume.

-
+

options

dictionary

Options as key-value pairs to pass to the driver for this volume.

-
+

labels

dictionary

Volume labels to apply.

-
+

no_copy

boolean

@@ -664,7 +684,7 @@ see
+
@@ -681,7 +701,7 @@ see
+

readonly

boolean

@@ -693,7 +713,7 @@ see
+

source

string

@@ -701,14 +721,14 @@ see mounts[].type is not tmpfs.

-
+

target

string / required

Container path.

-
+

tmpfs_mode

integer

@@ -716,7 +736,7 @@ see mounts[].type=tmpfs.

-
+

tmpfs_size

string

@@ -724,7 +744,7 @@ see mounts[].type=tmpfs.

-
+

type

string

@@ -739,7 +759,7 @@ see
+

name

string / required

@@ -747,7 +767,7 @@ see --name option of docker service create.

-
+

networks

list / elements=any

@@ -757,14 +777,14 @@ see --network option of docker service create.

-
+

placement

dictionary

Configures service placement preferences and constraints.

-
+

constraints

list / elements=string

@@ -772,7 +792,7 @@ see --constraint option of docker service create.

-
+

preferences

list / elements=dictionary

@@ -781,7 +801,7 @@ see
+

replicas_max_per_node

integer

added in community.docker 1.3.0

@@ -791,7 +811,7 @@ see
+

publish

list / elements=dictionary

@@ -799,7 +819,7 @@ see --publish option of docker service create.

-
+

mode

string

@@ -812,7 +832,7 @@ see
+

protocol

string

@@ -824,21 +844,21 @@ see
+

The port to make externally available.

-
+

target_port

integer / required

The port inside the container to expose.

-
+

read_only

boolean

@@ -851,7 +871,7 @@ see
+

replicas

integer

@@ -862,14 +882,14 @@ see Default: -1

-
+

reservations

dictionary

Configures service resource reservations.

-
+

cpus

float

@@ -877,7 +897,7 @@ see --reserve-cpu option of docker service create.

-
-
+ @@ -900,14 +920,14 @@ see
+

restart_config

dictionary

Configures if and how to restart containers when they exit.

-
+

condition

string

@@ -921,7 +941,7 @@ see
-
-
-
+

Configures how the service should be rolled back in case of a failing update.

-
+

delay

string

@@ -964,7 +984,7 @@ see
+
@@ -978,7 +998,7 @@ see
+
@@ -987,7 +1007,7 @@ see
+

monitor

string

@@ -997,7 +1017,7 @@ see
+

order

string

@@ -1006,7 +1026,7 @@ see
+
@@ -1015,7 +1035,7 @@ see
+

secrets

list / elements=dictionary

@@ -1023,7 +1043,7 @@ see --secret option of docker service create.

-
-
+

gid

string

GID of the secret file’s group.

-
+

mode

integer

File access mode inside the container. Must be an octal number (like 0644 or 0444).

-
+

secret_id

string

Secret’s ID.

-
+

secret_name

string / required

Secret’s name as defined at its creation.

-
+

uid

string

UID of the secret file’s owner.

-
+

state

string

@@ -1079,7 +1099,7 @@ see - -
+

sysctls

dictionary

added in community.docker 3.10.0

@@ -1104,7 +1124,7 @@ see

Dictionary of key, value pairs.

-
+

timeout

integer

@@ -1113,7 +1133,7 @@ see Default: 60

-
+

tls

boolean

@@ -1126,7 +1146,7 @@ see
+ @@ -1136,7 +1156,7 @@ see
+

tty

boolean

@@ -1149,14 +1169,14 @@ see
+

update_config

dictionary

Configures how the service should be updated. Useful for configuring rolling updates.

-
+

delay

string

@@ -1165,7 +1185,7 @@ see --update-delay option of docker service create.

-
+
@@ -1180,7 +1200,7 @@ see
-
-
+

order

string

@@ -1206,7 +1226,7 @@ see
-
+

use_ssh_client

boolean

added in community.docker 1.5.0

@@ -1228,7 +1248,7 @@ see
+

user

string

@@ -1238,7 +1258,7 @@ see --user option of docker service create.

-
+

validate_certs

aliases: tls_verify

@@ -1253,7 +1273,7 @@ see
+ @@ -1326,7 +1346,7 @@ see

Examples

---
-- name: Set command and arguments
+- name: Set command and arguments (historical mapping)
   community.docker.docker_swarm_service:
     name: myservice
     image: alpine
@@ -1334,6 +1354,14 @@ see     args:
       - "3600"
 
+- name: Pass flags to the image ENTRYPOINT (CLI-compatible mapping)
+  community.docker.docker_swarm_service:
+    name: loki
+    image: grafana/loki:main
+    command_as_args: true
+    command:
+      - '-config.file=/etc/loki/loki-config.yaml'
+
 - name: Set a bind mount
   community.docker.docker_swarm_service:
     name: myservice
diff --git a/branch/main/objects.inv b/branch/main/objects.inv
index 1b65803bb0e20b8a088c6ff7f98a31c2b23eadc3..5968d07cc075972a5f504ea42d0cb2c805173ea0 100644
GIT binary patch
delta 3513
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

delta 3500
zcmV;d4O8-^qyd7K>IIruzECVWVtpCEV@?f
z#(ga-^%$(zOn5*Kk8trG*e+X%?)YauvL5+o!1E)Vzca`A>x;71TL$O*;b$B(!OR5Y
z295PdG11|jQ7cHb;OW}e9X(FooI)e*__4An33|Lv747a#md@rte+&ol=W#*Oy7I7w
zJYGt)4G-zSR4kT!PJl7BILRI5QezNpLsRn<}dQZBRGm$mU6~;XOypm6eVYH+@zdaI1z%
zE+2z;N`?=&>x(vGe=7Hc%tJ<)dEMi{dnMU+n*$G-FoH%~(^Ie#nA2Bq
zb+AsBiu&PG9*cwEi5kNbBh{tg?KMQF1==twi3y5iED~Twb7m}-y5=y;qa@TAp9AW7
zcRGucWkV7yct>??+7EF+n+7prb2yZ>V8MM#fCcM$-L=3Gm@3T%81D0{=@qYx^MXm2|!%O(JRmhIoHQFE9=R?)?uLaX##kEG!M
zNHZBG!%G+v!7`v2L;<4;IK%+nkC+(TmEV7IdBq3v8>3eN$KRr}UZ#3uf1x
z+nxNg*rvgPf7lo8LG|K@HVq!cD{Z7i1+TvmM*TQF0HjHR
z7EiYI$I#HLRc|I>7Hr~NGoS@KRmE-?VJ$~?OMwZ^Sk$||ElSbO<~5yco(>oCsa3D4
zRrO9i1oAu`F6367s&ZH8w`B2dB;vdleOun(r^GUyf0$8HpD@{rd|m_WyW)jmHplEV?NxKlpakPi>^*fV$#;xQQxT+@-w
zWxLcSg^ZyyJw3xE$!rGHVCK6*xMaD=f)7wwpq;0}A=55UrN!C>EQ@5TBQ(`T<-#5v
zn+A(le@E|oa6C%ONHz~10ci8KTbua2j_
zdl+uhNxLS+ivO*w_szG50k`Q8BkO&<6uYnTPcWMZ(<5w&DSj(2VR`Q5JLK1*tj?{<
z$4LSohu!97Cog0^2TGl7aua5FK|PjEBg$(GC~
zK8BL{1UUYiKf+lY|IOIWrA2*=+tR`^-kIk|IH&Ye7wO)XZx(YIgrF_>th-`
zmGuRpbX|P`%2HKd;yy}EeaX#QQC}W_e+R0kFOLCtHT~`|NY~Qu;8`l^OJw0X`VyF<
zioV2sh#LA5ny-Ssc^OD9Ub@8}S0P(bH0ld>^Fo$PXoSmGeugw-Y|8qO?@PgxXOqZG
z5)^oL$;jPXQ6JKe2f2$*2-K>Vb6NF5KvQ%=pv9L$Sc~r{;5M!-O3XyDp6I2if6m9n
zny0HApEui1G45l&ChEph@HvT1>xl9&(5xZqM+>YV$_@rzJ=BloUpthY3c7BnA1bhF
zC_5E+#n3gZ`1L}WxG2^N^@I6p^XyQtntTw*Ib&oBAi!jiAt3+yg$babs}}~qgt2&_
z0%8z97FYy|0&~efskpYwK7K6se_BlJM38lu0x)q)-|&-Rm%WL?bS`?6iVv{hO%#}G
zxtmm6+n2iWV|izBW`_dK;Os|oYQ*d~0A1LR;`7n4)4)750U(Eih973LdnO2yi?+|<
zzL^Lx>4p-{F%u0a)?h+;Wx{w~r%Vz!pi3r<=JCiR0R#DC{8$mX96K6Hf0Og$MF?2z
zcqs8IfH!_Cce~jyiS9NlN2vF*OM9}GfyqF|uLMABU^GZj$6>=D)NsP`4Kj0#Xam=4
zNRlR1X`liPH3?Rh0V*=o7)TukD#1`=V1*a3=0XEPsI-7Y7HSGqw+*DKFc84YHeeZr
zo&u>e0Cf{`4swdP{y#Yff40XDRYsUVz+HQQ6he)F5J0fn2RRCn;sF*rn1J9C2UOi)
z0s(6pD;(|x*SHuUOREL)&wYy-v2p+xEOPS1$V=2DI8kZSdZ0`MpcR#z`G-nV)Y-!;
zQEPMe?ONrUzkwNnj^)kRx2`Qcoy$QWju=jArr5;r@@rX6HskUtFHKK+~d
zBQD#z(`4hay0u!Fe*oe0_ZzabKh9=5&!A~7x;XaR)BO~7#Mx$_LT0C7!n$#oWz~!|
zI{kYS{QBV#^Xd0jCVN(XR+TC`_4H%YtM0ao{IxL&FAu;HYq{rtxc-^xpMK(q58T-!
z8&06C_v-yVxc#{!iD|R%>{q)25NrNZFYLIY4c-0ZvExowBmZd3O~S?f#iwb=FDTnV4967QDdrSs`_aQx`W?*9M&@BgDuvU%D*
zjh`1UrbG4ZP4#a&U;UqH%l2G%n)s=By6)<`S-JM^DPU7x-N2FQZQG~W&V~ff^;2JT
zUx)biNM4iZf2J(-4o^*|Ru0_i2L3GUw)gwK{7bIh)h--kxnWeS={Jj0qsh(Bih6%{
z?4O!f{pat;pFY`PwJYhyWV$WMd47K?YO|=y@m%#~cFWB^J&Mz?B+^(X{8sjF(-%|P
zzyITxr}1`K$^3M#s;Km58%7^!^P4%yPv-Ap%Fk~2e{^b_zv}C7B{_XJMCEqdE;=>+
z6YnKZt8dYlfte`8m*?#JP=3SQQJ+u!?RM1P&+bLf(;)Im0DTHf&pERUyMBiEjrRaJ
zHVz(*``^tE&F{?u@WqpvANy(eZgyeaJvwiD3O!d=wu?>j{;BeV{`=gk;QtW3@=VL&qTjjG@?MTiW}8K3
zW3K#Z$0noi$F}Ly{zLch%H8bS@uB*p+dck#)q5XtTJN?BXFL61?UX*5FWTeqR(R6?
zo8_l})(ttEW`}LKJeiqtzMJW%fqd^b@h5xTe>(c&8?;n&(^P}~R6l;37xRu7{;$c~
zK7+4^d02KVH&c=9-C2L$$e;IY`+4U7I(%S{=&((vk6&3Irq707yf0Hz?`EmVP;QH@
zVv-wwuzc(cpZsId?%v9a`ln^0%cT4#`O`Kr3EiLOFLig)CvG~iYgtrH5j<(LZDO)8
zf1A&<_@nuIp29zN|Mc|QHpeG>nC?;vWD}i;`&GVnApC8yPus*Ch}9O@^3oj+L#qz@
zPSZE!rC=~8b8c@9^IG+04za*fZe=TfPV*l`ztHTD
z?o$h9wIQLEXU!iL!LJvIS$RElRPHtjWH4ws+U+7we}9Ux
z*|`tSFV{?_uw%2%9eDA*KeTNjI)mFP)-|&3m3oNhUkBovE$3msud3$T@L(Okx|pK$
zxtmUhZCy=y*p*hCi7dYNXEJW;eh=D(My`>2v!s^)+WfRlAcO1XE9JPmW^$q5j@KHb
z{@Gn#fs~@NnI|$2XFp#CHNEkue!_2xj2Rje?CPFM_ldm
zuiOjcPrC1%k|Q_eqDd<
z6~De*pE{HFWojsS^EwlBe{+4H%mKO+>)nU%AIv_o=5;2}W_s&v*vGa*t1p<9Lwowj
zrZ2{0_owl?8V|Cy89)x&