app_image: добавлена роль (сборка и доставка docker-образа)

2026-07-24 18:47:39 +03:00
parent aca0d03772
commit db72932f0d
5 changed files with 217 additions and 0 deletions
@@ -0,0 +1,98 @@
+---
+# tasks file for app_image
+#
+# Роль-инициатор сборки. Гоняет команду сборки приложения на control-хосте и
+# доставляет получившийся образ на сервер через docker save/load. Тулчейн сборки
+# (Go, node, …) на сервере не нужен — туда едет готовый образ.
+#
+# Контракт приложения (app_image_command): команда в app_image_src_dir получает
+# BUILD_ID из окружения и собирает полный образ <app_image_name>:$BUILD_ID.
+#
+# Тег образа = случайный BUILD_ID (роль его генерит). Дедупликации по содержимому
+# нет — каждый деплой везёт образ и пересоздаёт контейнер. Для ручного нечастого
+# деплоя это осознанный выбор: простота важнее экономии рестарта. Старые образы
+# на сервере чистит `docker image prune -af` по крону (см. playbook-system.yml).
+#
+# Рассчитана на один целевой хост за прогон: сборка делегируется на control-хост,
+# при нескольких хостах в play повторится на каждый (мы деплоим последовательно).
+#
+# Выход: факт app_image_tag (= BUILD_ID) + образ <app_image_name>:<app_image_tag>
+# на сервере. Тег забирает следующий кирпичик (рендер compose).
+
+- name: "Validate role input"
+  ansible.builtin.assert:
+    that:
+      # Формат имени docker-образа: он же идёт в имя tar-файла (vars/main.yml),
+      # поэтому '/' и прочее ломало бы путь и docker-референс.
+      - app_image_name is string and app_image_name is match('^[a-z0-9][a-z0-9._-]*$')
+      - app_image_src_dir is string and app_image_src_dir | length > 0
+      - app_image_command is string and app_image_command | length > 0
+    fail_msg: >-
+      app_image_name — валидное имя docker-образа (^[a-z0-9][a-z0-9._-]*$);
+      app_image_src_dir и app_image_command — непустые строки
+    quiet: true
+
+- name: "Generate build id (image tag)"
+  ansible.builtin.set_fact:
+    app_image_tag: "{{ lookup('ansible.builtin.password', '/dev/null chars=ascii_lowercase,digits length=16') }}"
+
+- name: "Build image and deliver it to server"
+  # В --check command-таски пропускаются, tar не создаётся и copy упал бы «нет
+  # файла на контроллере». Пропускаем всю доставку — факт app_image_tag уже
+  # выставлен, поэтому рендер compose ниже честно покажет diff со своим тегом.
+  when: "not ansible_check_mode"
+  block:
+    - name: "Build image locally via app contract"
+      delegate_to: localhost
+      # Сборка идёт от локального юзера. Инвентарь включает become глобально, но
+      # локальная сборка под root не нужна — фиксируем инвариант явно.
+      become: false
+      ansible.builtin.command:
+        cmd: "{{ app_image_command }}"
+        chdir: "{{ app_image_src_dir }}"
+      environment:
+        BUILD_ID: "{{ app_image_tag }}"
+      # Локальная сборка — средство доставки; факт изменения системы (сервера)
+      # отражает загрузка образа ниже.
+      changed_when: false
+
+    - name: "Save image to tar locally"
+      delegate_to: localhost
+      become: false
+      ansible.builtin.command:
+        cmd: "docker save --output {{ app_image_local_tar }} {{ app_image_name }}:{{ app_image_tag }}"
+      changed_when: false
+
+    - name: "Copy image tar to server"
+      ansible.builtin.copy:
+        src: "{{ app_image_local_tar }}"
+        dest: "{{ app_image_remote_tar }}"
+        mode: "0644"
+
+    - name: "Load image on server"
+      ansible.builtin.command:
+        cmd: "docker load --input {{ app_image_remote_tar }}"
+      changed_when: true
+
+  always:
+    - name: "Remove local image tar"
+      delegate_to: localhost
+      become: false
+      ansible.builtin.file:
+        path: "{{ app_image_local_tar }}"
+        state: absent
+
+    - name: "Remove remote image tar"
+      ansible.builtin.file:
+        path: "{{ app_image_remote_tar }}"
+        state: absent
+
+    # Локальный тег — временная ручка (на сервер образ уехал через save/load).
+    # Снимаем, чтобы control-хост не копил <app>:<random> от каждого прогона.
+    - name: "Remove transient local image tag"
+      delegate_to: localhost
+      become: false
+      ansible.builtin.command:
+        cmd: "docker image rm {{ app_image_name }}:{{ app_image_tag }}"
+      changed_when: false
+      failed_when: false