Rola Ansible: docker

Ta rola w pełni konfiguruje i instaluje dockerd.

Przeniosłem tę rolę do własnej kolekcji.
W przyszłości nie będę akceptować ani przetwarzać żadnych dalszych pull requestów ani zgłoszeń problemów tutaj.

Od teraz korzystaj z powiązanej kolekcji!

Wymagania i zależności

Kolekcje Ansible

• bodsch.core

ansible-galaxy collection install bodsch.core

lub

ansible-galaxy collection install --requirements-file collections.yml

• Połączenie z repozytorium pakietu docker-ce repozytorium

Systemy operacyjne

Testowane na

• ArchLinux
• ArtixLinux
• Oparte na Debianie
  • Debian 10 / 11
  • Ubuntu 20.04 / 22.04

Systemy oparte na RedHat nie są już oficjalnie wspierane! Mogą działać, ale nie muszą.

Zmienne roli

Następujące zmienne mogą być używane do dostosowania instalacji dockera:

## wybierz status włączenia kanału repozytorium centos
docker_repo:
  channel:
    stable_enabled: true
    test_enabled: false
    nightly_enabled: false

## stan pakietu (obecny, brak, itp.)
docker_state: present

## czy demon dockera ma uruchamiać się podczas rozruchu?
docker_service:
  enable: true
  ## nazwa usługi dockera
  name: docker

## zainstaluj docker-compose w wersji
docker_compose: {}
# na przykład:
# docker_compose:
#   install: true
#   version: 1.29.2

docker_users: []

docker_plugins: []

docker_client_config: []

docker_config: {}

docker_config_diff: true

docker_python_packages: []

Powiązane z proxy

Czy demon dockera powinien używać proxy do połączeń wychodzących?

docker_proxy:
  enabled: false
  ## lista zmiennych środowiskowych, które należy ustawić (zakomentuj te, których nie potrzebujesz)
  env:
    - "HTTP_PROXY=http://proxy.example.com:80/"
    - "HTTP_PROXY=https://proxy.example.com:443/"
    - "NO_PROXY=localhost,127.0.0.1,internalhub.example.com"

Konfiguracja klienta docker

Włącz autoryzację dla rejestru Dockera.
Możliwe jest stworzenie konfiguracji dla różnych użytkowników.
Hasło przechowywane tutaj jest zakodowane w base64 i nie jest szyfrowane!
Tworzenie odpowiedniego ciągu można wykonać w następujący sposób:

echo "jenkins$robot:rubbel-die-katz-du-dummschwätzer1" | base64
amVua2luczpydWJiZWwtZGllLWthdHotZHUtZHVtbXNjaHfDpHR6ZXIxCg==

docker_client_config:
  ## lokalizacja, w której powinniśmy umieścić konfigurację klienta
  - location: "/root/.docker/config.json"
    enabled: false
    auths:
      registry.gitfoo.tld:
        auth: amVua2luczpydWJiZWwtZGllLWthdHotZHUtZHVtbXNjaHfDpHR6ZXIxCg==

Alternatywnie możesz również wpisać swoją nazwę użytkownika i hasło.
Moduł Ansible utworzy prawidłowy zakodowany w Base64 ciąg.

docker_client_config:
    ## lokalizacja, w której powinniśmy umieścić konfigurację klienta
  - location: "/var/tmp/foo/config.json"
    enabled: false
    auths:
      "test.tld":
        username: "FOO-was-sonst"
        password: "ja-toll-schon-wieder-alles-scheisse!"

Od wersji 3.1.0 możliwe jest również skonfigurowanie formatu wyjściowego dla docker ps lub docker image.
Tutaj przekazane parametry muszą być zdefiniowane jako lista:

docker_client_config:
  ## lokalizacja, w której powinniśmy umieścić konfigurację klienta
  - location: "/root/.docker/config.json"
    enabled: false
    auths:
      registry.gitfoo.tld:
        auth: amVua2luczpydWJiZWwtZGllLWthdHotZHUtZHVtbXNjaHfDpHR6ZXIxCg==
    formats:
      ps:
        - ".ID"
        - ".Names"
        - ".Status"
        - ".Labels"
        - ".RunningFor"
        - ".Ports"
      images:
        - ".ID"
        - ".Size"
        - ".Repository"
        - ".Tag"
        - ".CreatedAt"

Domyślne opcje konfiguracyjne dockerd

odniesienie konfiguracji

aktualnie wspierane opcje:

Przykłady

docker_config:
  log_driver: ""
  log_opts: {}
  #  env: "os,customer"
  #  "max-file": "5"
  #  "max-size": "10m"
  max_concurrent_downloads: 3
  max_concurrent_uploads: 5
  debug: false
  log_level: ""
  bridge: ""
  bip: "172.16.0.1/24"
  fixed_cidr: "172.16.0.0/24"
  fixed_cidr_v6: ""
  default_gateway: ""
  default_gateway_v6: ""
  selinux_enabled: false
  experimental: false
  ip: "0.0.0.0"
  group: "{{ docker_group }}"
  insecure_registries: []

Podczas tworzenia konfiguracji można opcjonalnie utworzyć różnicę w stosunku do oryginalnej wersji i ją wyświetlić.

Aby to zrobić, zmienna docker_config_diff musi być ustawiona na true.

Są więcej przykładów w testach molekułowych:

• domyślne
• dockerd-z-pluginem
• dockerd-z-tls
• aktualizacja-konfiguracji

Opcje docker_users

Dodaj istniejącego użytkownika do grupy docker.

Ponadto próbuje ustawić prawa dostępu do soketu dockera za pomocą setfacl.

docker_users:
  - jenkins

Opcje docker_plugins

Zainstaluj i aktywuj własne wtyczki.

(Jednak testowane tylko z Loki!)

docker_plugins:
  - alias: loki
    source: grafana/loki-docker-driver
    version: 2.7.0
    state: present

Obsługa Pythona

Niektóre moduły w tej roli wymagają odpowiednich rozszerzeń Pythona.
Ostatnio wystąpiło kilka niezgodności, dlatego ten punkt jest teraz również konfigurowalny.

Domyślna konfiguracja jest następująca:

docker_python_packages:
  - name: docker
  - name: requests
  - name: urllib3

Jeśli inne wersje modułów pip są zainstalowane tutaj, można nadpisać te domyślne.
Można dodać wersje do każdego modułu:

docker_python_packages:
  - name: docker
    version: 6.1.1

Jeśli określona jest wersja, podejmie próbę zainstalowania dokładnie tej wersji.
Jednak można także wpłynąć na to zachowanie za pomocą compare_direction.

docker_python_packages:
  - name: docker
    compare_direction: ">"
    version: 6.0.0

Lub zdefiniować odpowiednie okno za pomocą versions:

docker_python_packages:
  - name: docker
  - name: requests
    versions:
      - ">= 2.27.0"
      - "< 2.29.0"
  - name: urllib3
    versions:
      - ">= 1.26.0"
      - "< 2.0.0"

Przykłady

Zainstaluj najnowszą stabilną wersję dockera na swoim lokalnym serwerze centos

- hosts: localhost
  roles:
     - role: docker

Zainstaluj najnowszą wersję edge dockera na swoim lokalnym serwerze centos

- hosts: localhost
  vars:
    docker_repo:
      channel:
        nightly_enabled: true
  roles:
     - role: docker

Zaawansowany playbook z różnymi zastosowanymi zmiennymi

odniesienie konfiguracji

- hosts: localhost
  vars:
    docker_config:
      # przechowuj kontenery/obrazy dockera w /opt/docker
      data_root: /opt/docker
      # zmień domyślną podsieć mostu dockera
      bip: 172.16.77.77/24
      # ustaw domyślny sterownik logów na journald
      log_driver: journald
      # włącz tryb eksperymentalny
      experimental: true
      # udostępnij API dockera przez plik gniazda i tcp
      hosts:
        - unix:///var/run/docker.sock
        - tcp://0.0.0.0:2376
      # ustaw domyślne domeny wyszukiwania
      dns_search:
        - lab1.linuxctl.com
        - lab2.linuxctl.com
      # skonfiguruj opcje logowania
      log_opts:
        "max-size": 10m
        "max-file": "3"
        labels: molecule
        env: "os,customer"
        
  roles:
    - role: docker

Autor i Licencja

• oryginalna rola docker napisana przez:

  • George Bolo | linuxctl.com

• zmodyfikowana:

  • Bodo Schulz

Licencja

MIT

DARMOWE OPROGRAMOWANIE, HELL YEAH!