Initial commit: interview prep repo (resume, legend, stack cases, Kubernetes course)

2026-07-18 00:37:41 +03:00
commit 9bb7f6263f
47 changed files with 3548 additions and 0 deletions
--- a/stack/ansible/CASE.md
+++ b/stack/ansible/CASE.md
@@ -0,0 +1,148 @@
+# Кейс: роль Ansible + тестирование в Molecule
+
+Связь с легендой: [../../legend/LEGEND.md](../../legend/LEGEND.md) — раздел «АО ТНИИС», автоматизация установки/настройки серверов, роли и плейбуки, тестирование через Molecule перед CI (TeamCity).
+
+## Что нужно реально сделать (домашний стенд)
+
+Написать Ansible-роль, разворачивающую и конфигурирующую Nginx, и протестировать её через Molecule (Docker-драйвер) — без реальных серверов, но с реальным прогоном роли и проверкой результата.
+
+### 1. Структура
+
+```
+ansible-lab/
+├── ansible.cfg
+├── inventory/
+│   └── hosts.ini
+├── playbook.yml
+└── roles/
+    └── nginx_deploy/
+        ├── defaults/main.yml
+        ├── tasks/main.yml
+        ├── handlers/main.yml
+        ├── templates/nginx.conf.j2
+        └── molecule/
+            └── default/
+                ├── molecule.yml
+                ├── converge.yml
+                └── verify.yml
+```
+
+### 2. roles/nginx_deploy/defaults/main.yml
+
+```yaml
+nginx_worker_connections: 1024
+nginx_server_name: lab.local
+```
+
+### 3. roles/nginx_deploy/tasks/main.yml
+
+```yaml
+- name: Установить nginx
+  ansible.builtin.package:
+    name: nginx
+    state: present
+
+- name: Развернуть конфиг nginx из шаблона
+  ansible.builtin.template:
+    src: nginx.conf.j2
+    dest: /etc/nginx/nginx.conf
+    mode: "0644"
+  notify: reload nginx
+
+- name: Убедиться, что nginx запущен и в автозагрузке
+  ansible.builtin.service:
+    name: nginx
+    state: started
+    enabled: true
+```
+
+### 4. roles/nginx_deploy/handlers/main.yml
+
+```yaml
+- name: reload nginx
+  ansible.builtin.service:
+    name: nginx
+    state: reloaded
+```
+
+### 5. roles/nginx_deploy/templates/nginx.conf.j2
+
+```nginx
+events {
+    worker_connections {{ nginx_worker_connections }};
+}
+
+http {
+    server {
+        listen 80;
+        server_name {{ nginx_server_name }};
+
+        location / {
+            return 200 'ok';
+        }
+    }
+}
+```
+
+### 6. molecule/default/molecule.yml
+
+```yaml
+driver:
+  name: docker
+platforms:
+  - name: nginx-instance
+    image: geerlingguy/docker-ubuntu2204-ansible:latest
+    pre_build_image: true
+provisioner:
+  name: ansible
+verifier:
+  name: ansible
+```
+
+### 7. molecule/default/converge.yml
+
+```yaml
+- name: Converge
+  hosts: all
+  roles:
+    - role: nginx_deploy
+```
+
+### 8. molecule/default/verify.yml
+
+```yaml
+- name: Verify
+  hosts: all
+  tasks:
+    - name: Проверить, что nginx слушает 80 порт
+      ansible.builtin.wait_for:
+        port: 80
+        timeout: 5
+
+    - name: Проверить HTTP-ответ
+      ansible.builtin.uri:
+        url: http://localhost/
+        status_code: 200
+```
+
+### 9. Шаги воспроизведения
+
+1. `pip install molecule molecule-plugins[docker] ansible`.
+2. `cd roles/nginx_deploy && molecule test` — это прогоняет полный цикл: create (поднять Docker-инстанс) → converge (применить роль) → idempotence (повторный прогон роли не должен ничего менять) → verify (проверки из verify.yml) → destroy.
+3. Специально сломать что-то в шаблоне (например, опечатку в директиве nginx) и посмотреть, как `molecule test` падает на этапе converge или verify — это и есть демонстрация того, зачем нужен этот шаг перед CI.
+4. Убедиться, что повторный прогон роли (idempotence check) не репортит изменений — если репортит, значит роль не идемпотентна, и это тоже частый вопрос на собеседовании.
+
+### 10. Что это даёт в разговоре с интервьюером
+
+- Реальное понимание, зачем нужен Molecule: тестировать роль в изолированном контейнере до того, как она попадёт в реальную инфраструктуру через CI.
+- Понимание идемпотентности — краеугольного принципа Ansible.
+- Практика с handlers, templates, defaults — стандартной структурой роли.
+- Понимание, как Molecule встраивается в CI-конвейер (у меня локально `molecule test`, в TeamCity — тот же шаг, но в build step с прогоном перед деплоем).
+
+## Нагрузка и цифры
+
+Ansible сам по себе не «нагрузочная» технология в смысле RPS/TPS — релевантная метрика тут время прогона плейбука на N хостов (параллелизм через `forks` в `ansible.cfg`). Цифры не зафиксированы отдельно — общий подход к честным цифрам масштаба (три слоя: публичные ориентиры / лабные замеры / реальные факты с работы) описан в [../../legend/CAPACITY.md](../../legend/CAPACITY.md).
+
+## Как это ложится в легенду
+
+В реальной работе (АО ТНИИС) — 15 скриптов/ролей Ansible с управлением конфигурациями через роли и модули, тестирование в CI/CD через Molecule и TeamCity. Домашний кейс воспроизводит тот же цикл в миниатюре на одной роли вместо полного набора инфраструктурных ролей.