# Модули
# Общая информация
Модули - созданный на python скрипт, упрощающий конкретную задачу.
Модули возвращают значения, название модуля должно быть под name. Есть общие переменные и специфичные для модулей
Справка по модулю
```bash
ansible-doc apt
```
Список модулей
```bash
ansible-doc -l
```
Пример проверки необходимости перезагрузки
```yaml
- name: check if reboot is required
become: yes
become_method: sudo
shell: "[ -f /var/run/reboot-required ]"
failed_when: False
register: reboot_required
changed_when: reboot_required.rc == 0
notify: reboot
handlers:
- name: reboot
command: shutdown -r now "Ansible triggered reboot after system updated"
async: 0
poll: 0
ignore_errors: true
```
Ссылки
[Информация на русском языке о модулях](https://runebook.dev/ru/docs/ansible/-index-)
# Системные модули и скрипты
Установка и/или проверка установки apt пакета
**Название модуля:** apt
**Переменные:**
- name: ntp #имя проверяемого и устанавливаемого модуля
- state: present #состояние после завершения
- update\_cache: yes # обновлять ли кэш
```yaml
- name: Install module
apt:
name: ntp
state: present
update_cache: yes
```
Добавить ключ стороннего репозитория
```yaml
- name: Add Docker GPG key
apt_key:
url: https://download.docker.com/linux/ubuntu/gpg
```
Добавить сторонний репозиторий
```yaml
- name: Add Docker repository
apt_repository:
repo: deb [arch=amd64] https://download.docker.com/linux/ubuntu bionic stable
```
Обновить apt кэш
```yaml
- name: Update apt cache
apt: update_cache=yes
```
Копирование файлов
Копирование с локального на удаленный
```yaml
- name: Copy from server to client
copy:
src: /home/user/file.txt
dest: /home/setup/file.txt
owner: foo
group: foo
mode: '0644'
```
Копирование с удаленного на локальный
```yaml
- name: Copy from client to server
fetch:
src: /var/log/access.log
dest: /var/log/fetched
flat: true удалить структуру родительских папок для файла
```
Создание пользователя и группы
Создание пользователя
```yaml
- name: Create and/or check presence user
user:
name: install
state: present
shell: /bin/bash
group: sudo
system: yes
hidden: yes
ssh_key_file: .ssh/id_rsa
expires: -1
```
Создание группы
```yaml
- name: Create check group
group:
name: clustergroup
state: present
gid: 1040
```
Управление сервисами (daemon)
```yaml
- name: Update sysctl
sysctl:
name: net.ipv4.ip_forward
value: 1
sysctrl_set: yes
state: present
reload: yes
```
```yaml
- name: Set or check service
service:
name: ntp
state: started
enabled: yes
```
```yaml
- name: Set check daemon starting
systemd:
name: ntp
state: started
enabled: yes
masked: no
daemon_reload: yes
register: systemd
```
cron:
Скрипты и консольные команды
```yaml
- name: Raw command
raw: echo "this was written by a raw Ansible module!!" >> ~/raw.txt
```
```yaml
- name: Executing script
shell: ./shell_script.sh >> ~/shell.txt
args:
chdir: /usr/local/
creates: ~/shell.txt
executable: /bin/csh
```
```yaml
- name: Executing python script
script: ./shell_script.py –some-argumets "42"
args:
creates: ~/shell.txt
executable: python
```
Для исполнения expect скриптов нужно сначала проверить и установить пакет expect
```yaml
- name: Expect module
expect:
command: passwd user1
responses:
(?i)password: "Ju5tAn07herP@55w0rd":
```
Git
```yaml
- name: Clone update repo
git:
repo: https://github.com/ansible/ansible.git
dest: /usr/local/ansible
clone: yes
update: yes
```
Pip
Из официального репозитория:
```yaml
- name: Install python package
pip:
name: numpy
version: 0.3
```
Из внешнего источника
```yaml
- name: install a python library from a github
pip:
name: https://github.com/jakubroztocil/httpie
```
Создание контейнера
```yaml
- name: create a container
docker_container:
name: debianlinux
image: debian:9
pull: yes
state: present
```
Запуск контейнера
```yaml
- name: start a container
docker_container:
name: debianlinux
state: started
devices:
- "/dev/sda:/dev/xvda:rwm"
```
Остановка контейнера
```yaml
- name: stop a container
docker_container:
name: debianlinux
state: stopped
```
Удаление образа из локального хранилища
```yaml
- name: remove a container image
docker_image:
name: labimages/ubuntu
state: absent
tag: lab16
```
Авторизация на docker hub
```yaml
- name: login to DockerHub
docker_login:
username: labuser1
password: "L@bp@55w0rd"
email: user1@lab.edu
```
Скачать образ из docker hub
```yaml
- name: pull a container image
docker_image:
name: ubuntu:18.04
pull: yes
```
Сохранить образ в docker hub
```yaml
- name: push a container image to docker hub
docker_image:
name: labimages/ubuntu
repository: labimages/ubuntu
tag: lab18
push: yes
```