Documentation

    docker_login

    Manage Docker registry authentication.

    Attributes

    check_mode:
      support: full
    

    Parameters

    Parameter Required Type Values Description
    email   string   Email address for the registry account.
    password   string   Password for authentication.
    reauthorize   boolean   Force re-authorization even if already logged in.
    registry   string   Registry URL (default: Docker Hub).
    state   string present
    absent
    Desired state of the registry login.
    username   string   Username for authentication.

    Example

    ```yaml

    • name: Login to Docker Hub docker_login: username: myuser password: mypassword

    • name: Login to private registry docker_login: registry: registry.example.com username: deploy password: “{{ registry_password }}”

    • name: Login with email docker_login: registry: registry.example.com username: deploy password: “{{ registry_password }” /// email: deploy@example.com /// /// - name: Logout from Docker Hub /// docker_login: /// state: absent /// /// - name: Logout from private registry /// docker_login: /// registry: registry.example.com /// state: absent /// /// - name: Re-authorize (force login even if already logged in) /// docker_login: /// registry: registry.example.com /// username: deploy /// password: “{{ registry_password }}” /// reauthorize: true /// ```}