Ansible Role - Docker 使用教程

Ansible Role - Docker 使用教程

ansible-role-docker Ansible Role - Docker 项目地址: https://gitcode.com/gh_mirrors/an/ansible-role-docker

1. 项目的目录结构及介绍

Ansible Role - Docker 是一个用于在 Linux 系统上安装 Docker 的 Ansible 角色。项目的目录结构如下：

ansible-role-docker/
├── defaults/
│   └── main.yml
├── handlers/
│   └── main.yml
├── meta/
│   └── main.yml
├── molecule/
│   └── default/
├── tasks/
│   └── main.yml
├── templates/
├── tests/
│   ├── inventory/
│   └── test.yml
├── vars/
│   └── main.yml
└── README.md

• defaults/: 包含默认变量设置。
• handlers/: 包含触发器，用于在任务执行完成后执行特定的动作，如重启服务。
• meta/: 包含角色的元数据，如依赖、 Galaxy 信息等。
• molecule/: 包含使用 Molecule 进行测试的配置和场景。
• tasks/: 包含角色执行的主要任务，如安装 Docker、启动服务、添加用户到 Docker 组等。
• templates/: 包含 Jinja2 模板文件，可以用于生成配置文件。
• tests/: 包含角色的测试用例和 inventory 文件。
• vars/: 包含角色可用的变量。
• README.md: 包含角色的说明和用法。

2. 项目的启动文件介绍

启动文件位于 tasks/main.yml，它是 Ansible 角色执行的主要入口点。以下是启动文件的主要内容：

---
- name: Install Docker
  apt:
    name: "{{ item }}"
    state: "{{ docker_packages_state }}"
  with_items: "{{ docker_packages }}"
  when: docker_edition | default('ce') | lower in ['ce', 'ee']

- name: Remove obsolete Docker packages
  apt:
    name: "{{ item }}"
    state: "absent"
  with_items: "{{ docker_obsolete_packages }}"

- name: Add the Docker repository
  apt_repository:
    repo: "{{ docker_apt_repository }}"
    state: "present"
    update_cache: yes
  when: docker_add_repo | default(true)

- name: Install Docker Compose
  when: docker_install_compose | default(false)
  pip:
    name: "{{ docker_compose_package }}"
    state: "{{ docker_compose_package_state }}"

- name: Configure Docker
  copy:
    dest: /etc/docker/daemon.json
    content: |
      {{ docker_daemon_options | to_json }}
  when: docker_daemon_options is defined

这里定义了一系列的任务，包括安装 Docker、移除过时的 Docker 包、添加 Docker 仓库、安装 Docker Compose 以及配置 Docker。

3. 项目的配置文件介绍

配置文件主要位于 defaults/main.yml 和 vars/main.yml。以下是配置文件的主要内容：

# defaults/main.yml
---
docker_edition: "ce"
docker_packages:
  - "docker-{{ docker_edition }}"
  - "docker-{{ docker_edition }}-cli"
  - "docker-{{ docker_edition }}-rootless-extras"
docker_packages_state: "present"
docker_obsolete_packages:
  - "docker"
  - "docker.io"
  - "docker-engine"
  - "docker-doc"
  - "docker-compose"
  - "docker-compose-v2"
  - "podman-docker"
  - "containerd"
  - "runc"
docker_service_manage: true
docker_service_state: "started"
docker_service_enabled: true
docker_restart_handler_state: "restarted"
# ... 其他配置项

在这个文件中，你可以定义 Docker 的版本、要安装的包、服务的状态以及其他相关配置。此外，你还可以在 vars/main.yml 文件中定义特定环境的变量，这些变量会覆盖 defaults 中的设置。

通过修改这些配置文件，你可以定制 Docker 的安装和配置，以满足不同环境的需求。

ansible-role-docker Ansible Role - Docker 项目地址: https://gitcode.com/gh_mirrors/an/ansible-role-docker