docker.container: Support container args

This change adds an `args` parameter to the `docker.container` operation
that passes said supplied args to the container at creation time. This
allows the operation to support container images that have an entrypoint
expecting to receive additional arguments, without needing to build+push
a custom image that embeds said arguments.

Author: minor-fixes

pyinfra/operations/docker.py

@@ -15,6 +15,7 @@
 def container(
     container,
     image="",
+    args=None,
     ports=None,
     networks=None,
     volumes=None,
@@ -28,6 +29,7 @@ def container(
     Manage Docker containers
 
     + container: name to identify the container
+    + args: list of command-line args to supply to the image
     + image: container image and tag ex: nginx:alpine
     + networks: network list to attach on container
     + ports: port list to expose
@@ -72,6 +74,7 @@ def container(
 
     want_spec = ContainerSpec(
         image,
+        args or list(),
         ports or list(),
         networks or list(),
         volumes or list(),

pyinfra/operations/util/docker.py

@@ -7,6 +7,7 @@
 @dataclasses.dataclass
 class ContainerSpec:
     image: str = ""
+    args: List[str] = dataclasses.field(default_factory=list)
     ports: List[str] = dataclasses.field(default_factory=list)
     networks: List[str] = dataclasses.field(default_factory=list)
     volumes: List[str] = dataclasses.field(default_factory=list)
@@ -31,6 +32,7 @@ def container_create_args(self):
             args.append("--pull always")
 
         args.append(self.image)
+        args.extend(self.args)
 
         return args
 

tests/operations/docker.container/add_and_start_no_existent_container.json

@@ -2,6 +2,11 @@
     "kwargs": {
         "container": "nginx",
         "image": "nginx:alpine",
+        "args": [
+            "nginx-debug",
+            "-g",
+            "'daemon off;'"
+        ],
         "ports": [
             "80:80"
         ],
@@ -14,7 +19,7 @@
         }
     },
     "commands": [
-        "docker container create --name nginx -p 80:80 nginx:alpine",
+        "docker container create --name nginx -p 80:80 nginx:alpine nginx-debug -g 'daemon off;'",
         "docker container start nginx"
     ]
 }