docker_compose – Управление многоконтейнерными приложениями Docker с помощью Docker Compose

• Краткое описание
• Требования
• Параметры
• Примечания
• Примеры
• Возвращаемые значения
• Статус

Краткое описание

• Использует Docker Compose для запуска, остановки и масштабирования служб.
• Работает с версиями Docker Compose 1 и 2.
• Конфигурацию можно читать из файла docker-compose.yml или docker-compose.yaml или встраивать с помощью опции definition.
• Более подробную информацию см. в примерах.
• Поддерживает режим проверки.
• Этот модуль назывался docker_service до Ansible 2.8. Способ использования не изменился.

Псевдонимы: docker_service

Требования

Ниже приведены требования к хосту, на котором будет выполняться этот модуль.

• API Docker >= 1.20
• Docker SDK для Python: Обратите внимание, что модуль Python docker-py устарел и заменен на docker (подробнее см. здесь). Для Python 2.6 необходимо использовать docker-py. В противном случае рекомендуется установить модуль Python docker. Обратите внимание, что оба модуля не следует устанавливать одновременно. Также обратите внимание, что при одновременной установке обоих модулей и удалении одного из них другой может перестать работать, и потребуется его повторная установка.
• Docker SDK для Python >= 1.8.0 (используйте docker-py для Python 2.6)
• PyYAML >= 3.11
• docker-compose >= 1.7.0

Параметры

Примечания

Примеры

# Examples use the django example at https://docs.docker.com/compose/django. Follow it to create the
# flask directory

- name: Run using a project directory
  hosts: localhost
  gather_facts: no
  tasks:
    - name: Tear down existing services
      docker_compose:
        project_src: flask
        state: absent

    - name: Create and start services
      docker_compose:
        project_src: flask
      register: output

    - debug:
        var: output

    - name: Run `docker-compose up` again
      docker_compose:
        project_src: flask
        build: no
      register: output

    - debug:
        var: output

    - assert:
        that: "not output.changed "

    - name: Stop all services
      docker_compose:
        project_src: flask
        build: no
        stopped: yes
      register: output

    - debug:
        var: output

    - assert:
        that:
          - "not web.flask_web_1.state.running"
          - "not db.flask_db_1.state.running"

    - name: Restart services
      docker_compose:
        project_src: flask
        build: no
        restarted: yes
      register: output

    - debug:
        var: output

    - assert:
        that:
          - "web.flask_web_1.state.running"
          - "db.flask_db_1.state.running"

- name: Scale the web service to 2
  hosts: localhost
  gather_facts: no
  tasks:
    - docker_compose:
        project_src: flask
        scale:
          web: 2
      register: output

    - debug:
        var: output

- name: Run with inline v2 compose
  hosts: localhost
  gather_facts: no
  tasks:
    - docker_compose:
        project_src: flask
        state: absent

    - docker_compose:
        project_name: flask
        definition:
          version: '2'
          services:
            db:
              image: postgres
            web:
              build: "{{ playbook_dir }}/flask"
              command: "python manage.py runserver 0.0.0.0:8000"
              volumes:
                - "{{ playbook_dir }}/flask:/code"
              ports:
                - "8000:8000"
              depends_on:
                - db
      register: output

    - debug:
        var: output

    - assert:
        that:
          - "web.flask_web_1.state.running"
          - "db.flask_db_1.state.running"

- name: Run with inline v1 compose
  hosts: localhost
  gather_facts: no
  tasks:
    - docker_compose:
        project_src: flask
        state: absent

    - docker_compose:
        project_name: flask
        definition:
            db:
              image: postgres
            web:
              build: "{{ playbook_dir }}/flask"
              command: "python manage.py runserver 0.0.0.0:8000"
              volumes:
                - "{{ playbook_dir }}/flask:/code"
              ports:
                - "8000:8000"
              links:
                - db
      register: output

    - debug:
        var: output

    - assert:
        that:
          - "web.flask_web_1.state.running"
          - "db.flask_db_1.state.running"

Значения возврата

Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:

Статус

• Гарантируется, что у данного модуля не будет обратной совместимости. [preview]
• Данный модуль поддерживается сообществом Ansible. [community]

Авторы

• Chris Houseknecht (@chouseknecht)