push

docs/2. Настройка Ansible и первый playbook.md

@@ -0,0 +1,141 @@
+## Установка Ansible
+Ansible работает через питон, по этому необходимо установить его:
+```
+apt update && apt upgrade -y
+apt install python3 python3-pip python3-venv -y
+```
+Установка виртуального окружения:
+```
+python3 -m venv 
+source venv/bin/activate
+```
+И устанавливаем Ansible:
+```
+pip install ansible
+ansible --version
+```
+<img src="assets/image_1777451283920.jpg" width="auto">
+
+## Настройка Ansible
+Готово. 
+Ansible используем ssh для подключения, лучше всего и безопаснее использовать ssh-ключ, создадим его:
+```
+ssh-keygen 
+```
+<img src="assets/image_1777451977808.jpg" width="auto">
+
+У меня ключ уже создан
+Расположение:
+```
+/home/<user>/.ssh/id_ed25519.pub # публичный ключ
+/home/<user>/.ssh/id_ed25519 # приватный ключ
+```
+
+Перекидываем публичный ssh-ключ на наш тестовый стенд:
+```
+ssh-copy-id -i ~/.ssh/ed25519.pub ansible@172.16.13.101
+```
+<img src="assets/image_1777454341479.jpg" width="auto">
+
+Готово.
+
+## Первые шаги
+Мы можем сделать начальную структуру проекта Ansible через команду:
+```
+ansible-galaxy role init my-project
+```
+<img src="./assets/image_1777454975978.jpg" width="auto">
+
+Коротко про каждую:
+1. defaults - в main.yml хранятся дефолтные переменные с которыми запускается роль
+2. vars - main.yml задаются переменные
+3. tasks - сами задачи, плейбуки
+4. handlers - это обработчики изменений, если ваша роль выполнялась, что-то изменила, потому что оно не соответствовало описанию плейбука, то будет вызван хендлер, если его описали
+5. templates - шаблоны
+6. files - хранение файлов, конфигов
+7. tests - тесты, можно проверять работу плейбуков, не применяя к серверам, локально в среде
+
+После подключения Ansible делает сбор фактов, узнает полную информацию о системе, какая ОС, архитектура, ip адреса и так далее.
+
+## Подключение Ansible 
+Как Ansible понять, куда ему подключаться? Для этого существует инвентарный файл hosts.yml
+
+<img src="./assets/image_1777458099510.jpg" width="auto">
+
+Это файл, где Ansible хранит список управляемых машин, пример:
+
+```
+all:
+	hosts:             # сервера
+		web:
+			ansible_host: 172.16.13.11
+		db:
+			ansible_host: 172.16.13.12
+			ansible_user: postres
+		git:
+			ansible_host: 172.16.13.12
+			ansible_user: gitea
+		
+	children:          # группа серверов
+		storage-service:
+			hosts:
+				db:
+				git:
+	
+	vars:
+		ansible_ssh_private_key_file: ~/.ssh/id_25519
+		ansible_become_password: P@ssw0rd
+```
+
+Это один из возможных вариантов использования hosts. 
+Мой hosts, на котором буду показывать пример:
+```
+all:  
+ hosts:  
+   my-vm:  
+     ansible_host: 172.16.13.101  
+     ansible_user: ansible  
+  
+ vars:  
+   ansible_ssh_private_key_file: ~/.ssh/id_ed25519
+   ansible_become_password: P@ssw0rd
+```
+
+Так же мы будем писать playbook в yml формате, вот простой пример:
+```
+---  
+- name: Обновление пакетов  
+ hosts: all        # все хосты из hosts.yml, можно 
+ become: true      # получение root прав
+ roles:  
+   - update-packages 
+```
+
+Мы указали роль update-packages, значит нужно в папке roles ее сделать, вот какая структура должна получится:
+
+<img src="./assets/image_1777459628010.jpg" width="auto">
+
+В роле update-packages мы создаем tasks "main.yml":
+```
+---  
+- name: Обновить все пакеты через apt    
+  ansible.builtin.apt:  
+   upgrade: yes             # выполнит обновление всего  
+   update_cache: yes        # обновить кэш пакетов
+
+```
+
+Идет вызов модуля "ansible.buildin.<font color="#f79646">apt</font>" под названием <font color="#f79646">apt</font>, он принимает 2 параметра:
+`upgrade` и `update_cache`
+
+Всё хорошо, но при запуске playbook будет искать roles относительно папки с ним `/ansible/playbooks/roles/`, наше же расположение `/ansible/roles/`, чтобы Ansible знал, где искать мы сделаем ansible.cfg в корневой папке, в которой пропишем полный
+```
+[defaults]  
+roles_path = /home/chase/file-fg/ansible/roles  
+inventory   = inventory/hosts.yml
+```
+
+Теперь запустим наш playbook.yml:
+
+<img src="./assets/image_1777543685692.jpg" width="auto">
+