service_create
Create a Docker Swarm service for replicated or global scheduling, rolling updates, and automatic restart. Specify image, command, networks, ports, resources, and restart policy.
Instructions
Create a Swarm service; requires a swarm manager node.
Use this instead of container_run when you need replicated or global scheduling,
rolling updates, or automatic restart across the swarm. Common extra_kwargs keys:
name (str), env (list of "KEY=VAL"), mode ({"Replicated": {"Replicas": N}} or
{"Global": {}}), networks (list of network names/ids), endpoint_spec
({"Ports": [{"PublishedPort": 80, "TargetPort": 8080}]}), labels (dict),
restart_policy ({"Condition": "on-failure", "MaxAttempts": 3}),
resources ({"Limits": {"NanoCPUs": 500000000, "MemoryBytes": 134217728}}). For anything else
docker-py's ServiceCollection.create accepts, call docs_lookup(section="services") rather
than guessing a key name.
Args: image: Image to run service tasks from (e.g. "nginx:alpine") command: Override the image's default command; string or list of strings extra_kwargs: Additional docker-py ServiceCollection.create keyword arguments
Returns: dict: The created service's full document ({"ID", "Version", "Spec", ...})
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| image | Yes | ||
| command | No | ||
| extra_kwargs | No |