{"id":22628132,"url":"https://github.com/turgon37/ansible-docker-server","last_synced_at":"2026-04-25T11:36:29.180Z","repository":{"id":85532651,"uuid":"74200665","full_name":"Turgon37/ansible-docker-server","owner":"Turgon37","description":"Ansible role to install and configure docker engine","archived":false,"fork":false,"pushed_at":"2019-07-26T17:45:09.000Z","size":162,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-31T23:15:17.006Z","etag":null,"topics":["ansible","docker-engine","docker-server"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Turgon37.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-11-19T10:00:13.000Z","updated_at":"2019-07-25T16:55:02.000Z","dependencies_parsed_at":null,"dependency_job_id":"975ca82c-ecb0-48ca-a09f-2d913d8bc671","html_url":"https://github.com/Turgon37/ansible-docker-server","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Turgon37/ansible-docker-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Turgon37%2Fansible-docker-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Turgon37%2Fansible-docker-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Turgon37%2Fansible-docker-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Turgon37%2Fansible-docker-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Turgon37","download_url":"https://codeload.github.com/Turgon37/ansible-docker-server/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Turgon37%2Fansible-docker-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32261117,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T09:15:33.318Z","status":"ssl_error","status_checked_at":"2026-04-25T09:15:31.997Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","docker-engine","docker-server"],"created_at":"2024-12-09T01:18:19.040Z","updated_at":"2026-04-25T11:36:29.164Z","avatar_url":"https://github.com/Turgon37.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Ansible Role Docker server\n=========\n\n[![Build Status](https://travis-ci.org/Turgon37/ansible-docker-server.svg?branch=master)](https://travis-ci.org/Turgon37/ansible-docker-server)\n\n:warning: This role is under development, some important (and possibly breaking) changes may happend. Don't use it in production level environments but you can eventually base your own role on this one :hammer:\n\n:grey_exclamation: Before using this role, please know that all my Ansible roles are fully written and accustomed to my IT infrastructure. So, even if they are as generic as possible they will not necessarily fill your needs, I advice you to carrefully analyse what they do and evaluate their capability to be installed securely on your servers.\n\n**This roles configure the docker daemon.**\n\n## Features\n\nCurrently this role provide the following features :\n\n  * docker engine installation\n  * docker engine configuration\n  * docker engine systemd service file\n  * install the docker-compose tool\n    * use the native tool for x86 architectures\n    * use a workaround script + compiled docker image for some other platforms (only armhf for now)\n  * monitoring items for\n    * Zabbix\n  * [local facts](#facts)\n\n## Requirements\n\n### OS Family\n\nThis role is available for\n\n  * Debian/Raspbian 8/9\n  * CentOS 7\n\n### Dependencies\n\nIf you use the zabbix monitoring profile you will need the role [ansible-zabbix-agent](https://github.com/Turgon37/ansible-zabbix-agent)\n\n\n## Role Variables\n\nThe variables that can be passed to this role and a brief description about them are as follows:\n\n| Name                                      | Types/Values   | Description                                                                                                                                                                                                                                   |\n| ------------------------------------------| ---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| docker_server__facts                      | Boolean        | Install the local fact script                                                                                                                                                                                                                 |\n| docker_server__edition                    | String         | Install edition in 'ce' (Community Edition) or 'ee' (Enterprise Edition)                                                                                                                                                                      |\n| docker_server__repository_release_channel | String         | The release channel to use in 'stable', 'edge', 'test'                                                                                                                                                                                        |\n| docker_server__compose_version            | String         | The version of docker-compose to install                                                                                                                                                                                                      |\n| docker_server__compose_state              | String         | The state of docker-compose tool in 'present', 'absent'                                                                                                                                                                                       |\n| docker_server__service_enabled            | Boolean        | Enable or not the docker service on the host                                                                                                                                                                                                  |\n| docker_server__service_restartable        | Boolean        | If the docker configuration change ansible will automatically restart the service unless this variable is set to False. In others words, set this to True if you want ansible automatically restart the docker daemon on configuration changes|\n| docker_server__service_restart_stamp_file | String         | If service_restartable (above) is set to False, ansible will touch this path instead of restarting docker. This allow you to test the presence of this file with your monitoring tool                                                         |\n| docker_server__socket_group               | String         | The name of the linux group the socket will belong to                                                                                                                                                                                         |\n| docker_server__socket_group_users         | List/Dict (see below) | The list of linux local user name you want to add to socket group                                                                                                                                                                             |\n\n:exclamation: In a production environment I recommend to set docker_server__service_restartable to False and to handle manually the docker service's restarts\n\n### Socket privileged users configuration\n\nIf any of your configured docker listen hosts contains 'unix://' string this role will configure a unix system group to secure it.\nThen, you can add some users to this group by using the following configuration:\n\n```\ndocker_server__socket_group_users:\n  - userlogin1\n```\n\nIf you want to revoke user socket access\n\n```\ndocker_server__socket_group_users:\n  - name: userlogin1\n    state: absent\n```\n\n## Facts\n\nBy default the local fact are installed and expose all variables available with the docker info command line.\n\nYou can use this command to get an idea of available keys\n\n```\ndocker version --format '{{json .}}'\n```\n\nIn addition, the following facts are available about docker-compose\n\n* ```ansible_local.docker_compose.version_full```\n* ```ansible_local.docker_compose.version_major```\n\n\n## Examples Playbooks\n\nTo use this role create or update your playbook according the following examples :\n\n  * Exemple of configuration with specific storage driver\n\n```\n    - hosts: servers\n      roles:\n         - docker-server\n      vars:\n        storage-driver: devicemapper\n        storage-opts:\n          - 'dm.thinpooldev=/dev/mapper/docker-thinpool'\n          - 'dm.use_deferred_removal=true'\n          - 'dm.use_deferred_deletion=true'\n```\n\n\n## License\n\nMIT","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fturgon37%2Fansible-docker-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fturgon37%2Fansible-docker-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fturgon37%2Fansible-docker-server/lists"}