---

argument_specs:

  main:
    version_added: "0.0.1"
    short_description: Install and configure Watchtower.
    description:
      - Install and configure L(Watchtower,https://containrrr.dev/watchtower/).
      - "Execution of this role can be limited using the following tags:"
      - "C(role::watchtower:install): Install Podman and Watchtower"
      - "C(role::watchtower): Apply all of the above."
    author: s3lph
    options:

      watchtower_image:
        description:
          - The name of the OCI image to run.
          - "See also: O(watchtower_image_tag)."
        type: str
        default: docker.io/containrrr/watchtower
      watchtower_image_tag:
        description:
          - The tag of the OCI image to run
          - "See also: O(watchtower_image)."
        type: str
        default: latest
      watchtower_schedule:
        description:
          - Cron expression of when containers should be updated.
          - If omitted, default to once every 24h without specifying a point in time.
        type: str
      watchtower_label_enable:
        description:
          - Whether Watchtower support has to be enabled explicitly via container labels.
        type: bool
        default: true
      watchtower_update_self:
        description:
          - Whether Watchtower should update itself as well.
        type: bool
        default: true