task.docker *********** .. include:: template.service.task.docker.example .. _task.docker.blocking_post_run: :kw:`blocking_post_run` ======================= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`run` action. Errors interrupt the action. .. _task.docker.blocking_pre_run: :kw:`blocking_pre_run` ====================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`run` action. Errors interrupt the action. .. _task.docker.check: :kw:`check` =========== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic **candidates** None | last_run ================= ================================================================ If set to 'last_run', the last run retcode is used to report a task resource status. If not set (default), the status of a task is always n/a. .. _task.docker.command: :kw:`command` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic **convert** shlex ================= ================================================================ The command to execute in the docker container on run. .. _task.docker.configs_environment: :kw:`configs_environment` ========================= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** [] **inheritance** leaf > head **scope order** specific > generic **convert** shlex ================= ================================================================ The whitespace separated list of ``=/``. A shell expression spliter is applied, so double quotes can be around ``/`` only or whole ``=/``. Variables are uppercased. .. _task.docker.confirmation: :kw:`confirmation` ================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** False **inheritance** leaf > head **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ If set to True, ask for an interactive confirmation to run the task. This flag can be used for dangerous tasks like data-restore. .. _task.docker.cwd: :kw:`cwd` ========= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ Change the working directory to the specified location instead of the default ````. .. _task.docker.detach: :kw:`detach` ============ ================= ================================================================ **scopable** True **required** False **provisioning** False **default** True **inheritance** leaf > head **scope order** specific > generic **convert** boolean ================= ================================================================ Run container in background. Set to ``false`` only for init containers, alongside :kw:`start_timeout` and the :c-tag:`nostatus` tag. .. _task.docker.devices: :kw:`devices` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** [] **inheritance** leaf > head **scope order** specific > generic **convert** shlex ================= ================================================================ The whitespace separated list of ``:``, specifying the host devices the container should have access to. .. _task.docker.entrypoint: :kw:`entrypoint` ================ ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ The script or binary executed in the container. Args must be set in :kw:`command`. .. _task.docker.environment: :kw:`environment` ================= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** [] **inheritance** leaf > head **scope order** specific > generic **convert** shlex ================= ================================================================ The whitespace separated list of ``=``. A shell expression spliter is applied, so double quotes can be around values only or whole ``=``. Variables are uppercased. .. _task.docker.group: :kw:`group` =========== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ If the binary is owned by the root user, run it as the specified group instead of root. .. _task.docker.guestos: :kw:`guestos` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic **candidates** unix | windows ================= ================================================================ The operating system in the virtual machine. .. _task.docker.hostname: :kw:`hostname` ============== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ Set the container hostname. If not set, a unique id is used. .. _task.docker.image: :kw:`image` =========== ================= ================================================================ **scopable** True **required** True **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ The docker image pull, and run the container with. .. _task.docker.image_pull_policy: :kw:`image_pull_policy` ======================= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** once **inheritance** leaf > head **scope order** specific > generic **candidates** once | always ================= ================================================================ The docker image pull policy. ``always`` pull upon each container start, ``once`` pull if not already pulled (default). .. _task.docker.interactive: :kw:`interactive` ================= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic **convert** tristate ================= ================================================================ Keep stdin open even if not attached. To use if the container entrypoint is a shell. .. _task.docker.ipcns: :kw:`ipcns` =========== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ Sets the :cmd:`docker run --ipc` argument. If not set, the docker daemon's default value is used. ``ipcns=none`` does not mount /dev/shm. ``ipcns=private`` creates a ipcns other containers can not share. ``ipcns=shareable`` creates a netns other containers can share. ``ipcns=container#0`` will share the container#0 ipcns. .. _task.docker.log: :kw:`log` ========= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** True **inheritance** leaf > head **scope order** specific > generic **convert** boolean ================= ================================================================ Log the task outputs in the service log. .. _task.docker.name: :kw:`name` ========== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ The name to assign to the container on docker run. If none is specified a ``...container.`` name is automatically assigned. .. _task.docker.netns: :kw:`netns` =========== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ Sets the :cmd:`docker run --net` argument. The default is ``none`` if :opt:`--net` is not specified in :kw:`run_args`, meaning the container will have a private netns other containers can share. A :c-res:`ip.netns` or :c-res:`ip.cni` resource can configure an ip address in this container. A container with ``netns=container#0`` will share the container#0 netns. In this case agent format a :opt:`--net=container:`. ``netns=host`` shares the host netns. .. _task.docker.no_preempt_abort: :kw:`no_preempt_abort` ====================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** False **inheritance** leaf > head **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ If set to ``true``, OpenSVC will preempt scsi reservation with a preempt command instead of a preempt and and abort. Some scsi target implementations do not support this last mode (esx). If set to ``false`` or not set, :kw:`no_preempt_abort` can be activated on a per-resource basis. .. _task.docker.on_error: :kw:`on_error` ============== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command to execute on :c-action:`run` action if :kw:`command` returned an error. .. _task.docker.osvc_root_path: :kw:`osvc_root_path` ==================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ If the OpenSVC agent is installed via package in the container, this parameter must not be set. Else the value can be set to the fullpath hosting the agent installed from sources. .. _task.docker.pidns: :kw:`pidns` =========== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ Sets the :cmd:`docker run --pid` argument. If not set, the container will have a private pidns other containers can share. Usually a pidns sharer will run a google/pause image to reap zombies. A container with ``pidns=container#0`` will share the container#0 pidns. In this case agent format a :opt:`--pid=container:`. Use ``pidns=host`` to share the host's pidns. .. _task.docker.post_run: :kw:`post_run` ============== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`run` action. Errors do not interrupt the action. .. _task.docker.pre_run: :kw:`pre_run` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`run` action. Errors do not interrupt the action. .. _task.docker.privileged: :kw:`privileged` ================ ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic **convert** tristate ================= ================================================================ Give extended privileges to the container. .. _task.docker.promote_rw: :kw:`promote_rw` ================ ================= ================================================================ **scopable** False **required** False **provisioning** False **default** False **inheritance** leaf > head **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ If set to ``true``, OpenSVC will try to promote the base devices to read-write on start. .. _task.docker.pull_timeout: :kw:`pull_timeout` ================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** 2m **inheritance** leaf > head **scope order** specific > generic **convert** duration ================= ================================================================ Wait for before declaring the container action a failure. .. _task.docker.registry_creds: :kw:`registry_creds` ==================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ The name of a secret in the same namespace having a config.json key which value is used to login to the container image registry. If not specified, the node-level registry credential store is used. .. _task.docker.rm: :kw:`rm` ======== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** False **inheritance** leaf > head **scope order** specific > generic **convert** boolean ================= ================================================================ If set to ``true``, add :opt:`--rm` to the docker run args and make sure the instance is removed on resource stop. .. _task.docker.run_args: :kw:`run_args` ============== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic **convert** expanded_shlex ================= ================================================================ Extra arguments to pass to the docker run command, like volume and port mappings. .. _task.docker.run_requires: :kw:`run_requires` ================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A whitespace-separated list of conditions to meet to accept running a 'run' action. A condition is expressed as ``(,...)``. If states are omitted, ``up,stdby up`` is used as the default expected states. .. _task.docker.schedule: :kw:`schedule` ============== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **default keyword** run_schedule **scope order** specific > generic ================= ================================================================ Set the this task run schedule. See ``/usr/share/doc/opensvc/schedule`` for the schedule syntax reference. .. _task.docker.scsireserv: :kw:`scsireserv` ================ ================= ================================================================ **scopable** False **required** False **provisioning** False **default** False **inheritance** leaf > head **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ If set to ``true``, OpenSVC will try to acquire a type-5 (write exclusive, registrant only) scsi3 persistent reservation on every path to every disks held by this resource. Existing reservations are preempted to not block service start-up. If the start-up was not legitimate the data are still protected from being written over from both nodes. If set to ``false`` or not set, :kw:`scsireserv` can be activated on a per-resource basis. .. _task.docker.secrets_environment: :kw:`secrets_environment` ========================= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** [] **inheritance** leaf > head **scope order** specific > generic **convert** shlex ================= ================================================================ A whitespace separated list of ``=/``. A shell expression spliter is applied, so double quotes can be around ``/`` only or whole ``=/``. Variables are uppercased. .. _task.docker.snooze: :kw:`snooze` ============ ================= ================================================================ **scopable** True **required** False **provisioning** False **default** 0 **inheritance** leaf > head **scope order** specific > generic **convert** duration ================= ================================================================ Snooze the service before running the task, so if the command is known to cause a service status degradation the user can decide to snooze alarms for the duration set as value. .. _task.docker.stop_timeout: :kw:`stop_timeout` ================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** 120 **inheritance** leaf > head **scope order** specific > generic **convert** duration ================= ================================================================ Wait for before declaring the container action a failure. .. _task.docker.timeout: :kw:`timeout` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic **convert** duration ================= ================================================================ Wait for before declaring the task run action a failure. If no timeout is set, the agent waits indefinitely for the task command to exit. .. _task.docker.tty: :kw:`tty` ========= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic **convert** tristate ================= ================================================================ Allocate a pseudo-tty. .. _task.docker.umask: :kw:`umask` =========== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ The umask to set for the application process. .. _task.docker.user: :kw:`user` ========== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ The user to impersonate when running the task command. The default user is root. .. _task.docker.userns: :kw:`userns` ============ ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic **candidates** host | None ================= ================================================================ Sets the :cmd:`docker run --userns` argument. If not set, the container will have a private userns other containers can share. A container with ``userns=host`` will share the host's userns. .. _task.docker.utsns: :kw:`utsns` =========== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic **candidates** None | host ================= ================================================================ Sets the :cmd:`docker run --uts` argument. If not set, the container will have a private utsns. A container with ``utsns=host`` will share the host's hostname. .. _task.docker.volume_mounts: :kw:`volume_mounts` =================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** [] **inheritance** leaf > head **scope order** specific > generic **convert** shlex ================= ================================================================ The whitespace separated list of ``::``. When the source is a local dir, the default is rw. When the source is a volume name, the default is taken from volume access. .. _task.docker.blocking_post_provision: :kw:`blocking_post_provision` ============================= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`provision` action. Errors interrupt the action. .. _task.docker.blocking_post_start: :kw:`blocking_post_start` ========================= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`start` action. Errors interrupt the action. .. _task.docker.blocking_post_startstandby: :kw:`blocking_post_startstandby` ================================ ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`startstandby` action. Errors interrupt the action. .. _task.docker.blocking_post_stop: :kw:`blocking_post_stop` ======================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`stop` action. Errors interrupt the action. .. _task.docker.blocking_post_unprovision: :kw:`blocking_post_unprovision` =============================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`unprovision` action. Errors interrupt the action. .. _task.docker.blocking_pre_provision: :kw:`blocking_pre_provision` ============================ ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`provision` action. Errors interrupt the action. .. _task.docker.blocking_pre_start: :kw:`blocking_pre_start` ======================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`start` action. Errors interrupt the action. .. _task.docker.blocking_pre_startstandby: :kw:`blocking_pre_startstandby` =============================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`startstandby` action. Errors interrupt the action. .. _task.docker.blocking_pre_stop: :kw:`blocking_pre_stop` ======================= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`stop` action. Errors interrupt the action. .. _task.docker.blocking_pre_unprovision: :kw:`blocking_pre_unprovision` ============================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`unprovision` action. Errors interrupt the action. .. _task.docker.comment: :kw:`comment` ============= ================= ================================================================ **scopable** False **required** False **provisioning** False **default** **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ Helps users understand the role of the service and resources, which is nice to on-call support people having to operate on a service they are not usually responsible for. .. _task.docker.disable: :kw:`disable` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** False **inheritance** leaf **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ A disabled resource will be ignored on service startup and shutdown. Its status is always reported ``n/a``. Set in DEFAULT, the whole service is disabled. A disabled service does not honor :c-action:`start` and :c-action:`stop` actions. These actions immediately return success. :cmd:`om disable` only sets :kw:`DEFAULT.disable`. As resources disabled state is not changed, :cmd:`om enable` does not enable disabled resources. .. _task.docker.encap: :kw:`encap` =========== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** False **inheritance** leaf > head **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ Set to ``true`` to ignore this resource in the nodes context and consider it in the encapnodes context. The resource is thus handled by the agents deployed in the service containers. .. _task.docker.monitor: :kw:`monitor` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** False **inheritance** leaf > head **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ A down monitored resource will trigger a node suicide if the monitor thinks it should be up and the resource can not be restarted. .. _task.docker.optional: :kw:`optional` ============== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** true for tasks, syncs and resources tagged 'noaction', else false **inheritance** leaf > head **scope order** specific > generic **convert** tristate ================= ================================================================ Action failures on optional resources are logged but do not stop the action sequence. Also the optional resource status is not aggregated to the instance 'availstatus', but aggregated to the 'overallstatus'. Resource tagged :c-tag:`noaction` and sync resources are automatically considered optional. Useful for resources like dump filesystems for example. .. _task.docker.pg_blkio_weight: :kw:`pg_blkio_weight` ===================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] **convert** integer ================= ================================================================ Block IO relative weight. Value: between 10 and 1000. Kernel default: 1000. .. _task.docker.pg_cpu_quota: :kw:`pg_cpu_quota` ================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] ================= ================================================================ The percent ratio of one core to allocate to the process group if % is specified, else the absolute value to set in the process group parameter. For example, on Linux cgroups, ``-1`` means unlimited, and a positive absolute value means the number of microseconds to allocate each period. ``50%@all`` means 50% of all cores, and ``50%@2`` means 50% of two cores. .. _task.docker.pg_cpu_shares: :kw:`pg_cpu_shares` =================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] **convert** integer ================= ================================================================ Kernel default value is used, which usually is 1024 shares. In a cpu-bound situation, ensure the service does not use more than its share of cpu ressource. The actual percentile depends on shares allowed to other services. .. _task.docker.pg_cpus: :kw:`pg_cpus` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] ================= ================================================================ Allow service process to bind only the specified cpus. Cpus are specified as list or range : 0,1,2 or 0-2 .. _task.docker.pg_mem_limit: :kw:`pg_mem_limit` ================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] **convert** size ================= ================================================================ Ensures the service does not use more than specified memory (in bytes). The Out-Of-Memory killer get triggered in case of tresspassing. .. _task.docker.pg_mem_oom_control: :kw:`pg_mem_oom_control` ======================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] **convert** integer ================= ================================================================ A flag (0 or 1) that enables or disables the Out of Memory killer for a cgroup. If enabled (0), tasks that attempt to consume more memory than they are allowed are immediately killed by the OOM killer. The OOM killer is enabled by default in every cgroup using the memory subsystem; to disable it, write 1. .. _task.docker.pg_mem_swappiness: :kw:`pg_mem_swappiness` ======================= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] **convert** integer ================= ================================================================ Set a swappiness value for the process group. .. _task.docker.pg_mems: :kw:`pg_mems` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] ================= ================================================================ Allow service process to bind only the specified memory nodes. Memory nodes are specified as list or range : 0,1,2 or 0-2 .. _task.docker.pg_vmem_limit: :kw:`pg_vmem_limit` =================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] **convert** size ================= ================================================================ Ensures the service does not use more than specified memory+swap (in bytes). The Out-Of-Memory killer get triggered in case of tresspassing. The specified value must be greater than :kw:`pg_mem_limit`. .. _task.docker.post_provision: :kw:`post_provision` ==================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`provision` action. Errors do not interrupt the action. .. _task.docker.post_start: :kw:`post_start` ================ ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`start` action. Errors do not interrupt the action. .. _task.docker.post_startstandby: :kw:`post_startstandby` ======================= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`startstandby` action. Errors do not interrupt the action. .. _task.docker.post_stop: :kw:`post_stop` =============== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`stop` action. Errors do not interrupt the action. .. _task.docker.post_unprovision: :kw:`post_unprovision` ====================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`unprovision` action. Errors do not interrupt the action. .. _task.docker.pre_provision: :kw:`pre_provision` =================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`provision` action. Errors do not interrupt the action. .. _task.docker.pre_start: :kw:`pre_start` =============== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`start` action. Errors do not interrupt the action. .. _task.docker.pre_startstandby: :kw:`pre_startstandby` ====================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`startstandby` action. Errors do not interrupt the action. .. _task.docker.pre_stop: :kw:`pre_stop` ============== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`stop` action. Errors do not interrupt the action. .. _task.docker.pre_unprovision: :kw:`pre_unprovision` ===================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`unprovision` action. Errors do not interrupt the action. .. _task.docker.provision: :kw:`provision` =============== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** True **inheritance** leaf > head **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ Set to false to skip the resource on provision and unprovision actions. Warning: Provision implies destructive operations like formating. Unprovision destroys service data. .. _task.docker.provision_requires: :kw:`provision_requires` ======================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A whitespace-separated list of conditions to meet to accept running a 'provision' action. A condition is expressed as ``(,...)``. If states are omitted, ``up,stdby up`` is used as the default expected states. .. _task.docker.shared: :kw:`shared` ============ ================= ================================================================ **scopable** True **required** False **provisioning** False **default** False **inheritance** leaf > head **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ Set to ``true`` to skip the resource on provision and unprovision actions if the action has already been done by a peer. Shared resources, like vg built on SAN disks must be provisioned once. All resources depending on a shared resource must also be flagged as shared. .. _task.docker.standby: :kw:`standby` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic **convert** tristate ================= ================================================================ Always start the resource, even on standby instances. The daemon is responsible for starting standby resources. A resource can be set standby on a subset of nodes using keyword scoping. A typical use-case is sync'ed fs on non-shared disks: the remote fs must be mounted to not overflow the underlying fs. .. warning:: Don't set shared resources standby: fs on shared disks for example. .. _task.docker.start_requires: :kw:`start_requires` ==================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A whitespace-separated list of conditions to meet to accept running a 'start' action. A condition is expressed as ``(,...)``. If states are omitted, ``up,stdby up`` is used as the default expected states. .. _task.docker.stop_requires: :kw:`stop_requires` =================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A whitespace-separated list of conditions to meet to accept running a 'stop' action. A condition is expressed as ``(,...)``. If states are omitted, ``up,stdby up`` is used as the default expected states. .. _task.docker.subset: :kw:`subset` ============ ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic ================= ================================================================ Assign the resource to a specific subset. .. _task.docker.tags: :kw:`tags` ========== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** **inheritance** leaf > head **scope order** specific > generic **convert** set ================= ================================================================ A list of tags. Arbitrary tags can be used to limit action scope to resources with a specific tag. Some tags can influence the driver behaviour. For example :c-tag:`noaction` avoids any state changing action from the driver and implies ``optional=true``, :c-tag:`nostatus` forces the status to n/a. .. _task.docker.unprovision: :kw:`unprovision` ================= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** True **inheritance** leaf > head **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ Set to false to skip the resource on unprovision actions. Warning: Unprovision destroys service data. .. _task.docker.unprovision_requires: :kw:`unprovision_requires` ========================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A whitespace-separated list of conditions to meet to accept running a 'unprovision' action. A condition is expressed as ``(,...)``. If states are omitted, ``up,stdby up`` is used as the default expected states.