Documentation
docker_login
Manage Docker registry authentication.
Attributes
check_mode:
support: full
Parameters
| Parameter | Required | Type | Values | Description |
|---|---|---|---|---|
| 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 /// ```}