145 lines
5.0 KiB
YAML
145 lines
5.0 KiB
YAML
---
|
|
argument_specs:
|
|
main:
|
|
description: Sets up a service in podman container(s)
|
|
options:
|
|
service_name:
|
|
description: Name of the service.
|
|
type: str
|
|
required: true
|
|
|
|
service_domains:
|
|
description: A list of domains which should be proxied to the main service container
|
|
type: list
|
|
required: false
|
|
default: []
|
|
service_container_http_port:
|
|
description:
|
|
- Port inside the container where http requests will be proxied to.
|
|
- Required if service_domains is not empty.
|
|
type: int
|
|
required: false
|
|
|
|
service_container_image:
|
|
description: "The image to run in the service container(s), in FQIN format (registry/imagename:tag)."
|
|
type: str
|
|
required: true
|
|
service_container_publish_ports:
|
|
description: "A list of published ports in docker format (<host listen address>:<host port>:<container port>)"
|
|
type: list
|
|
required: false
|
|
default: []
|
|
service_container_mounts:
|
|
description: List of bind mounts or volumes to be mounted inside the service container(s).
|
|
type: list
|
|
required: false
|
|
default: []
|
|
elements: dict
|
|
options:
|
|
type:
|
|
description: Type of volume
|
|
type: str
|
|
required: true
|
|
choices:
|
|
- volume
|
|
- bind
|
|
source:
|
|
description:
|
|
- Mount source.
|
|
- If mount type is volume, name of the volume.
|
|
- If mount type is bind, host path to bind mount inside the container.
|
|
type: str
|
|
required: true
|
|
destination:
|
|
description: Path inside the container to mount at
|
|
type: str
|
|
required: true
|
|
readonly:
|
|
description: If true, volume will be mounted as read only inside the container
|
|
type: bool
|
|
required: false
|
|
default: false
|
|
service_container_env:
|
|
description: A dict of environment variables for the service container(s)
|
|
type: dict
|
|
required: false
|
|
default: {}
|
|
|
|
service_additional_containers:
|
|
description:
|
|
- List of additional containers for the sercice.
|
|
- >
|
|
Will inherit most options from main service container, except for publish_ports.
|
|
All options can be overridden per-container.
|
|
type: list
|
|
required: false
|
|
default: []
|
|
elements: dict
|
|
options:
|
|
name:
|
|
description:
|
|
- Name of the container.
|
|
- >
|
|
This will be appended to the service name, so if for example service name is
|
|
nextcloud and this variable is cron, the resulting container will be called
|
|
nextcloud-cron
|
|
type: str
|
|
required: true
|
|
image:
|
|
description: "The image to run in the container, in FQIN format (registry/image:tag)"
|
|
type: str
|
|
required: false
|
|
default: "{{ service_container_image }}"
|
|
mounts:
|
|
description: List of bind mounts or volumes to be mounted inside the main service container.
|
|
type: list
|
|
required: false
|
|
default: "{{ service_container_mounts }}"
|
|
elements: dict
|
|
options:
|
|
type:
|
|
description: Type of volume
|
|
type: str
|
|
required: true
|
|
choices:
|
|
- volume
|
|
- bind
|
|
source:
|
|
description:
|
|
- Mount source.
|
|
- If mount type is volume, name of the volume.
|
|
- If mount type is bind, host path to bind mount inside the container.
|
|
type: str
|
|
required: true
|
|
destination:
|
|
description: Path inside the container to mount at
|
|
type: str
|
|
required: true
|
|
readonly:
|
|
description: If true, volume will be mounted as read only inside the container
|
|
type: bool
|
|
required: false
|
|
default: false
|
|
publish_ports:
|
|
description: "A list of published ports in docker format (<host listen address>:<host port>:<container port>)"
|
|
type: list
|
|
required: false
|
|
default: []
|
|
env:
|
|
description: A dict of environment variables for the container
|
|
type: dict
|
|
required: false
|
|
default: {}
|
|
|
|
service_requires:
|
|
description: List of systemd units this service container depends on.
|
|
type: list
|
|
required: false
|
|
default: []
|
|
elements: str
|
|
service_auto_update:
|
|
description: Whether to let podman automatically update the service containers whenever the specified image gets updated
|
|
type: bool
|
|
required: false
|
|
default: true
|