📜 Модуль копирования Ansible [объяснение с примерами]

Модуль копирования (copy) Ansible используется в различных реальных сценариях, когда вам нужно скопировать файлы или шаблоны с хост-машины Ansible на ряд удаленных серверов.

Вот некоторые распространенные сценарии использования.

• Развертывание статического содержимого: Если у вас есть статический контент, такой как HTML, CSS, файлы JavaScript или другие активы, которые вы хотите развернуть на веб-серверах или серверах приложений, вы можете использовать модуль копирования для обеспечения того, чтобы эти файлы были скопированы в соответствующие места.
• Развертывание ключевых файлов: Иногда вам может понадобиться распространить сертификаты SSL или ключи SSH на несколько серверов. Модуль копирования позволяет безопасно распространять эти файлы, сохраняя контроль над их разрешениями и правами собственности.
• Пользовательские шаблоны: Вы можете использовать шаблоны Jinja2 с модулем копирования для динамического создания файлов конфигурации или других текстовых файлов на основе переменных или условий, специфичных для каждого управляемого узла.
• Управление конфигурационными файлами: С помощью модуля копирования можно развернуть общий файл конфигурации для Nginx, Apache или любой другой службы на нескольких серверах.

Необходимые условия

Прежде чем приступить к работе, убедитесь, что у вас есть все необходимое:

• Ansible установлен на вашем хосте управления.
• Доступ к одному или нескольким целевым хостам, на которые вы хотите скопировать файлы.
• Базовое понимание концепций Ansible, таких как инвентари, плейбуки и таски.

📜 Понимание основных компонентов Ansible – часть 1 – IT is good

Понимание модуля копирования Ansible

Модуль копирования Ansible предоставляет простой и эффективный способ распространения файлов и каталогов в вашей инфраструктуре.

Основной синтаксис модуля копирования показан ниже:

- name: Copy file from control node to managed node
  copy:
    src: /source-pth/file.txt
    dest: /destination-path/file.txt

Практические примеры использования модуля copy Ansible

Теперь, когда вы знакомы с синтаксисом, позвольте мне поделиться некоторыми практическими примерами, в которых вы, скорее всего, будете использовать этот модуль.

Пример 1: Распространение файлов конфигурации

В этом примере вы развернете файл конфигурации виртуального хоста Nginx на нескольких серверах с помощью модуля копирования Ansible и динамически измените файл конфигурации для разных доменных имен с помощью переменных Ansible.

Сначала создайте шаблон файла конфигурации Nginx (nginx.conf.j2), включающий переменные для имени домена.

Вот пример:

nano nginx.conf.j2

server {
    listen 80;
    server_name {{ domain_name }};
    root /var/www/{{ domain_name }};
    index index.html index.htm;

    access_log /var/log/nginx/{{ domain_name }}.log;
    error_log /var/log/nginx/{{ domain_name }}.log;

}

nano playbook.yml

---
- name: Deploy Nginx configuration file
  hosts: nginx_servers
  vars:
    nginx_conf_path: /etc/nginx/conf.d/
    domain_names:
      - site1.example.com
      - site2.example.com
      - site3.example.com
  tasks:
    - name: Copy Nginx configuration file
      copy:
        src: nginx.conf.j2
        dest: "{{ nginx_conf_path }}{{ item }}"
      with_items: "{{ domain_names }}"

ansible-playbook -i inventory_file playbook.yml

nano playbook.yml

---
- name: Deploy static content to web servers
  hosts: web_servers
  become: yes
  become_user: root

  tasks:
    - name: Copy HTML files
      copy:
        src: /backup/html_files/
        dest: /var/www/html/
        owner: www-data
        group: www-data
        mode: '0755'


    - name: Copy CSS files
      copy:
        src: /backup/css_files/
        dest: /var/www/html/css/
        owner: www-data
        group: www-data
        mode: '0755'

    - name: Copy JavaScript files
      copy:
        src: /backup/js_files/
        dest: /var/www/html/js/
        owner: www-data
        group: www-data
        mode: '0755'

ansible-playbook -i inventory_file playbook.yml

nano playbook.yml

---
- name: Distribute SSL certificates and SSH keys
  hosts: all
  tasks:
    - name: Copy SSL certificate file
      copy:
        src: /ssl/ssl_certificate.crt
        dest: /etc/ssl/certs/ssl_certificate.crt
        mode: '0644'
        owner: root
        group: root

    - name: Copy SSL private key file
      copy:
        src: /ssl/ssl_private_key.key
        dest: /etc/ssl/private/ssl_private_key.key
        mode: '0600'
        owner: root
        group: root

    - name: Copy SSH private key file
      copy:
        src: /ssh/ssh_private_key
        dest: /home/{{ ansible_user }}/ssh/ssh_private_key
        mode: '0600'
        owner: "{{ ansible_user }}"
        group: "{{ ansible_user }}"

ansible-playbook -i inventory_file playbook.yml

nano playbook.yml

- name: Copy example.txt to /var/tmp/
  hosts: your_target_host
  tasks:
    - name: Copy file from remote host to another location
      copy:
        src: /tmp/example.txt  
        dest: /var/tmp/example.txt  
        remote_src: yes

• 📜 Как определить группы кластеров в инвентари Ansible
• 📜 Как клонировать репозиторий Git с помощью Ansible
• 📜 Как с помощью Ansible обновить все пакеты в Ubuntu / Debian Linux
• 📜 Как поручить Ansible использовать конкретную версию Python
• 📜 Как создать шаблоны в Ansible для создания конфигураций на управляемых узлах – часть 7