Проект по автоматизации настройки PostgreSQL

Этот проект предназначен для автоматизации установки, настройки и управления базой данных PostgreSQL с использованием Ansible и Jenkins. Он включает пайплайн Jenkins и Ansible плейбук с ролью для управления PostgreSQL.

Структура проекта

• Jenkinsfile — скрипт для автоматизации пайплайна Jenkins, который позволяет клонировать репозиторий, расшифровывать SSH-ключи, запускать Ansible плейбук и выполнять определенные задачи роли PostgreSQL.
• ansible.cfg — конфигурационный файл Ansible, где указаны настройки по умолчанию для выполнения плейбуков.
• inventory.yml — файл инвентаря Ansible, который определяет хосты, на которых будут выполняться плейбуки.
• playbooks/install_postgresql.yml — основной Ansible плейбук для установки и настройки PostgreSQL.
• roles/postgresql — Ansible роль для управления PostgreSQL, которая содержит:
  • tasks/ — каталог с задачами:
    • setup.yml — установка необходимых пакетов PostgreSQL.
    • open_firewall.yml — настройка правил брандмауэра для доступа к базе данных.
    • initialize.yml — инициализация новой базы данных.
    • configure.yml — настройка параметров конфигурации PostgreSQL.
    • databases.yml — создание и управление базами данных.
    • users.yml — создание и управление пользователями базы данных.
    • backup.yml — резервное копирование базы данных.
  • templates/ — шаблоны конфигурационных файлов для PostgreSQL:
    • pg_hba.conf.j2 — шаблон файла для управления доступом к базе данных.
    • postgresql.conf.j2 — шаблон основного конфигурационного файла PostgreSQL.
  • vars/ — переменные, используемые в роли PostgreSQL.

Запуск проекта

Предварительные требования

• Jenkins с установленным Ansible плагином
• Доступ к хостам, указанным в inventory.yml

Пайплайн Jenkins

Файл Jenkinsfile определяет этапы пайплайна для автоматизированного развертывания PostgreSQL:

1. Клонирование репозитория — загрузка кода проекта.
2. Расшифровка SSH-ключа — декодирование зашифрованного ключа с использованием Ansible Vault.
3. Запуск плейбука PostgreSQL — выполнение Ansible плейбука для развертывания и настройки PostgreSQL на целевых хостах.

Параметры запуска

Пайплайн поддерживает следующие параметры:

• DB_USER — имя пользователя PostgreSQL.
• DB_NAME — название базы данных.
• BACKUP_DIR — директория для хранения резервных копий.
• TASKS — список задач для выполнения, указанный через запятую (например, setup,backup).

Порядок задач

По умолчанию задачи выполняются в следующем порядке:

1. setup — установка необходимых пакетов.
2. firewall — настройка брандмауэра.
3. init — инициализация базы данных.
4. configure — конфигурация базы данных.
5. database — создание базы данных.
6. user — управление пользователями.
7. backup — резервное копирование данных.

При указании параметра TASKS, можно выбрать конкретные задачи, и они будут выполнены в этом порядке.