ver 2
This commit is contained in:
parent
015d96995e
commit
66471a8a89
12
Jenkinsfile
vendored
12
Jenkinsfile
vendored
@ -11,6 +11,7 @@ pipeline {
|
|||||||
string(name: 'DB_USER', defaultValue: 'postgres', description: 'Имя пользователя базы данных')
|
string(name: 'DB_USER', defaultValue: 'postgres', description: 'Имя пользователя базы данных')
|
||||||
string(name: 'DB_NAME', defaultValue: 'mydb', description: 'Имя базы данных')
|
string(name: 'DB_NAME', defaultValue: 'mydb', description: 'Имя базы данных')
|
||||||
string(name: 'BACKUP_DIR', defaultValue: '/var/backups/postgresql', description: 'Директория для бэкапа')
|
string(name: 'BACKUP_DIR', defaultValue: '/var/backups/postgresql', description: 'Директория для бэкапа')
|
||||||
|
string(name: 'TASKS', defaultValue: '', description: 'Список тегов задач для выполнения (setup,firewall,init,configure,database,user,backup)')
|
||||||
}
|
}
|
||||||
stages {
|
stages {
|
||||||
stage('Clone repository') {
|
stage('Clone repository') {
|
||||||
@ -37,10 +38,13 @@ pipeline {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
stage('Install PostgreSQL') {
|
stage('Run PostgreSQL Playbook') {
|
||||||
steps {
|
steps {
|
||||||
|
script {
|
||||||
|
def tagsString = params.TASKS ? params.TASKS.split(',').join(',') : ''
|
||||||
|
|
||||||
ansiblePlaybook(
|
ansiblePlaybook(
|
||||||
playbook: 'install_postgresql.yml',
|
playbook: 'playbooks/install_postgresql.yml',
|
||||||
inventory: "inventory.yml",
|
inventory: "inventory.yml",
|
||||||
extraVars: [
|
extraVars: [
|
||||||
postgres_user: params.DB_USER,
|
postgres_user: params.DB_USER,
|
||||||
@ -48,11 +52,13 @@ pipeline {
|
|||||||
postgres_db: params.DB_NAME,
|
postgres_db: params.DB_NAME,
|
||||||
backup_dir: params.BACKUP_DIR,
|
backup_dir: params.BACKUP_DIR,
|
||||||
ansible_ssh_private_key_file: env.DECRYPTED_KEY_FILE
|
ansible_ssh_private_key_file: env.DECRYPTED_KEY_FILE
|
||||||
]
|
],
|
||||||
|
tags: tagsString
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
}
|
||||||
post {
|
post {
|
||||||
always {
|
always {
|
||||||
script {
|
script {
|
||||||
|
61
README.md
61
README.md
@ -0,0 +1,61 @@
|
|||||||
|
# Проект по автоматизации настройки 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`, можно выбрать конкретные задачи, и они будут выполнены в этом порядке.
|
3
ansible.cfg
Normal file
3
ansible.cfg
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
[defaults]
|
||||||
|
inventory = inventory.yml
|
||||||
|
roles_path = ./roles
|
@ -1,125 +0,0 @@
|
|||||||
- name: Install PostgreSQL and Backup
|
|
||||||
hosts: all
|
|
||||||
become: true
|
|
||||||
vars:
|
|
||||||
postgres_user: '{{ postgres_user }}'
|
|
||||||
postgres_password: '{{ postgres_password }}'
|
|
||||||
postgres_db: '{{ postgres_db }}'
|
|
||||||
backup_dir: '{{ backup_dir }}'
|
|
||||||
|
|
||||||
tasks:
|
|
||||||
- name: Update zypper
|
|
||||||
command: zypper refresh
|
|
||||||
register: zypper_refresh
|
|
||||||
changed_when: "'Refreshing' in zypper_refresh.stdout"
|
|
||||||
|
|
||||||
- name: Update System
|
|
||||||
zypper:
|
|
||||||
name: '*'
|
|
||||||
state: latest
|
|
||||||
when: zypper_refresh.changed
|
|
||||||
|
|
||||||
- name: Update PostgreSQL package
|
|
||||||
zypper:
|
|
||||||
name:
|
|
||||||
- postgresql-server
|
|
||||||
- postgresql-contrib
|
|
||||||
state: present
|
|
||||||
|
|
||||||
- name: PostgreSQL initdb
|
|
||||||
command: sudo -u postgres initdb -D /var/lib/pgsql/data
|
|
||||||
args:
|
|
||||||
creates: /var/lib/pgsql/data/PG_VERSION
|
|
||||||
|
|
||||||
- name: Systemctl start and enable PostgreSQL
|
|
||||||
service:
|
|
||||||
name: postgresql
|
|
||||||
state: started
|
|
||||||
enabled: true
|
|
||||||
|
|
||||||
- name: python3-psycopg2 install
|
|
||||||
zypper:
|
|
||||||
name: python3-psycopg2
|
|
||||||
state: present
|
|
||||||
|
|
||||||
- name: Change listen_addresses in postgresql.conf
|
|
||||||
lineinfile:
|
|
||||||
path: /var/lib/pgsql/data/postgresql.conf
|
|
||||||
regexp: '^#?listen_addresses\\s*='
|
|
||||||
line: "listen_addresses = '*'"
|
|
||||||
notify: Restart PostgreSQL
|
|
||||||
|
|
||||||
- name: Change pg_hba.conf
|
|
||||||
lineinfile:
|
|
||||||
path: /var/lib/pgsql/data/pg_hba.conf
|
|
||||||
regexp: '^host\\s+all\\s+all\\s+0\\.0\\.0\\.0/0\\s+md5'
|
|
||||||
line: 'host all all 0.0.0.0/0 md5'
|
|
||||||
notify: Restart PostgreSQL
|
|
||||||
|
|
||||||
- name: Create User PostgreSQL
|
|
||||||
community.postgresql.postgresql_user:
|
|
||||||
name: '{{ postgres_user }}'
|
|
||||||
password: '{{ postgres_password }}'
|
|
||||||
state: present
|
|
||||||
|
|
||||||
- name: Create Base PostgreSQL
|
|
||||||
community.postgresql.postgresql_db:
|
|
||||||
name: '{{ postgres_db }}'
|
|
||||||
owner: '{{ postgres_user }}'
|
|
||||||
encoding: UTF8
|
|
||||||
state: present
|
|
||||||
|
|
||||||
- name: Create a table
|
|
||||||
community.postgresql.postgresql_query:
|
|
||||||
db: '{{ postgres_db }}'
|
|
||||||
query: 'CREATE TABLE IF NOT EXISTS contacts (id SERIAL PRIMARY KEY, name VARCHAR(100), phone_number VARCHAR(15));'
|
|
||||||
login_user: '{{ postgres_user }}'
|
|
||||||
login_password: '{{ postgres_password }}'
|
|
||||||
|
|
||||||
- name: Open firewall 5432 port
|
|
||||||
command: firewall-cmd --add-port=5432/tcp --permanent
|
|
||||||
become: true
|
|
||||||
|
|
||||||
- name: Restart Firewall
|
|
||||||
command: firewall-cmd --reload
|
|
||||||
become: true
|
|
||||||
|
|
||||||
- name: Create backup directory
|
|
||||||
file:
|
|
||||||
path: '{{ backup_dir }}'
|
|
||||||
state: directory
|
|
||||||
owner: postgres
|
|
||||||
group: postgres
|
|
||||||
mode: '0755'
|
|
||||||
|
|
||||||
- name: PostgreSQL database backup
|
|
||||||
become_user: postgres
|
|
||||||
command: 'pg_dump -U {{ postgres_user }} -F c -f "{{ backup_dir }}/db_backup_{{ postgres_db }}_{{ ansible_date_time.iso8601 }}.sql" {{ postgres_db }}'
|
|
||||||
environment:
|
|
||||||
PGPASSWORD: '{{ postgres_password }}'
|
|
||||||
|
|
||||||
- name: Create cron for daily full backup
|
|
||||||
cron:
|
|
||||||
name: 'PostgreSQL daily full backup'
|
|
||||||
user: postgres
|
|
||||||
minute: '0'
|
|
||||||
hour: '1'
|
|
||||||
job: 'pg_dump -U {{ postgres_user }} -F c {{ postgres_db }} > {{ backup_dir }}/full_db_backup_{{ postgres_db }}_$(date +\\\\%F-\\\\%H-%M).sql'
|
|
||||||
environment:
|
|
||||||
PGPASSWORD: '{{ postgres_password }}'
|
|
||||||
|
|
||||||
- name: Create cron backup script
|
|
||||||
cron:
|
|
||||||
name: 'PostgreSQL hourly backup'
|
|
||||||
user: postgres
|
|
||||||
minute: '0'
|
|
||||||
hour: '*'
|
|
||||||
job: 'pg_dump -U {{ postgres_user }} -F c {{ postgres_db }} > {{ backup_dir }}/db_backup_{{ postgres_db }}_$(date +\\\\%F-\\\\%H-%M).sql'
|
|
||||||
environment:
|
|
||||||
PGPASSWORD: '{{ postgres_password }}'
|
|
||||||
|
|
||||||
handlers:
|
|
||||||
- name: Restart PostgreSQL
|
|
||||||
service:
|
|
||||||
name: postgresql
|
|
||||||
state: restarted
|
|
4
playbooks/install_postgresql.yml
Normal file
4
playbooks/install_postgresql.yml
Normal file
@ -0,0 +1,4 @@
|
|||||||
|
- hosts: all
|
||||||
|
become: true
|
||||||
|
roles:
|
||||||
|
- postgresql
|
4
roles/postgresql/handlers/main.yml
Normal file
4
roles/postgresql/handlers/main.yml
Normal file
@ -0,0 +1,4 @@
|
|||||||
|
- name: Restart PostgreSQL
|
||||||
|
service:
|
||||||
|
name: postgresql
|
||||||
|
state: restarted
|
41
roles/postgresql/tasks/backup.yml
Normal file
41
roles/postgresql/tasks/backup.yml
Normal file
@ -0,0 +1,41 @@
|
|||||||
|
- name: Create backup directory
|
||||||
|
file:
|
||||||
|
path: '{{ backup_dir }}'
|
||||||
|
state: directory
|
||||||
|
owner: postgres
|
||||||
|
group: postgres
|
||||||
|
mode: '0755'
|
||||||
|
tags:
|
||||||
|
- backup
|
||||||
|
|
||||||
|
- name: Perform database backup
|
||||||
|
command: >
|
||||||
|
pg_dump -U {{ postgres_user }} -F c -f "{{ backup_dir }}/db_backup_{{ postgres_db }}_{{ ansible_date_time.iso8601 }}.sql" {{ postgres_db }}
|
||||||
|
become_user: postgres
|
||||||
|
environment:
|
||||||
|
PGPASSWORD: '{{ postgres_password }}'
|
||||||
|
tags:
|
||||||
|
- backup
|
||||||
|
|
||||||
|
- name: Daily cron full backup
|
||||||
|
cron:
|
||||||
|
name: 'PostgreSQL daily full backup'
|
||||||
|
user: postgres
|
||||||
|
minute: '0'
|
||||||
|
hour: '1'
|
||||||
|
job: "pg_dump -U {{ postgres_user }} -F c {{ postgres_db }} > {{ backup_dir }}/full_db_backup_{{ postgres_db }}_$(date +\\%F-\\%H-%M).sql"
|
||||||
|
environment:
|
||||||
|
PGPASSWORD: '{{ postgres_password }}'
|
||||||
|
tags:
|
||||||
|
- backup
|
||||||
|
|
||||||
|
- name: Hourly cron incremental backup
|
||||||
|
cron:
|
||||||
|
name: 'PostgreSQL hourly incremental backup'
|
||||||
|
user: postgres
|
||||||
|
minute: '0'
|
||||||
|
job: "pg_dump -U {{ postgres_user }} -F c --data-only --file=\"{{ backup_dir }}/incremental_db_backup_{{ postgres_db }}_$(date +\\%F-\\%H-%M).sql\" {{ postgres_db }}"
|
||||||
|
environment:
|
||||||
|
PGPASSWORD: '{{ postgres_password }}'
|
||||||
|
tags:
|
||||||
|
- backup
|
21
roles/postgresql/tasks/configure.yml
Normal file
21
roles/postgresql/tasks/configure.yml
Normal file
@ -0,0 +1,21 @@
|
|||||||
|
- name: Configure postgresql.conf with template
|
||||||
|
template:
|
||||||
|
src: postgresql.conf.j2
|
||||||
|
dest: /var/lib/pgsql/data/postgresql.conf
|
||||||
|
owner: postgres
|
||||||
|
group: postgres
|
||||||
|
mode: '0644'
|
||||||
|
notify: Restart PostgreSQL
|
||||||
|
tags:
|
||||||
|
- configure
|
||||||
|
|
||||||
|
- name: Configure pg_hba.conf with template
|
||||||
|
template:
|
||||||
|
src: pg_hba.conf.j2
|
||||||
|
dest: /var/lib/pgsql/data/pg_hba.conf
|
||||||
|
owner: postgres
|
||||||
|
group: postgres
|
||||||
|
mode: '0644'
|
||||||
|
notify: Restart PostgreSQL
|
||||||
|
tags:
|
||||||
|
- configure
|
17
roles/postgresql/tasks/databases.yml
Normal file
17
roles/postgresql/tasks/databases.yml
Normal file
@ -0,0 +1,17 @@
|
|||||||
|
- name: Create PostgreSQL database
|
||||||
|
community.postgresql.postgresql_db:
|
||||||
|
name: '{{ postgres_db }}'
|
||||||
|
owner: '{{ postgres_user }}'
|
||||||
|
encoding: UTF8
|
||||||
|
state: present
|
||||||
|
tags:
|
||||||
|
- database
|
||||||
|
|
||||||
|
- name: Create contacts table in PostgreSQL
|
||||||
|
community.postgresql.postgresql_query:
|
||||||
|
db: '{{ postgres_db }}'
|
||||||
|
query: 'CREATE TABLE IF NOT EXISTS contacts (id SERIAL PRIMARY KEY, name VARCHAR(100), phone_number VARCHAR(15));'
|
||||||
|
login_user: '{{ postgres_user }}'
|
||||||
|
login_password: '{{ postgres_password }}'
|
||||||
|
tags:
|
||||||
|
- database
|
14
roles/postgresql/tasks/initialize.yml
Normal file
14
roles/postgresql/tasks/initialize.yml
Normal file
@ -0,0 +1,14 @@
|
|||||||
|
- name: PostgreSQL initdb
|
||||||
|
command: sudo -u postgres initdb -D /var/lib/pgsql/data
|
||||||
|
args:
|
||||||
|
creates: /var/lib/pgsql/data/PG_VERSION
|
||||||
|
tags:
|
||||||
|
- init
|
||||||
|
|
||||||
|
- name: Systemctl start and enable PostgreSQL
|
||||||
|
service:
|
||||||
|
name: postgresql
|
||||||
|
state: started
|
||||||
|
enabled: true
|
||||||
|
tags:
|
||||||
|
- init
|
7
roles/postgresql/tasks/main.yml
Normal file
7
roles/postgresql/tasks/main.yml
Normal file
@ -0,0 +1,7 @@
|
|||||||
|
- import_tasks: setup.yml
|
||||||
|
- import_tasks: initialize.yml
|
||||||
|
- import_tasks: configure.yml
|
||||||
|
- import_tasks: users.yml
|
||||||
|
- import_tasks: databases.yml
|
||||||
|
- import_tasks: open_firewall.yml
|
||||||
|
- import_tasks: backup.yml
|
14
roles/postgresql/tasks/open_firewall.yml
Normal file
14
roles/postgresql/tasks/open_firewall.yml
Normal file
@ -0,0 +1,14 @@
|
|||||||
|
- name: Open PostgreSQL port in firewall
|
||||||
|
firewalld:
|
||||||
|
port: 5432/tcp
|
||||||
|
permanent: true
|
||||||
|
state: enabled
|
||||||
|
become: true
|
||||||
|
tags:
|
||||||
|
- firewall
|
||||||
|
|
||||||
|
- name: Reload firewall using command
|
||||||
|
command: firewall-cmd --reload
|
||||||
|
become: true
|
||||||
|
tags:
|
||||||
|
- firewall
|
15
roles/postgresql/tasks/setup.yml
Normal file
15
roles/postgresql/tasks/setup.yml
Normal file
@ -0,0 +1,15 @@
|
|||||||
|
- name: Install PostgreSQL packages
|
||||||
|
zypper:
|
||||||
|
name:
|
||||||
|
- postgresql-server
|
||||||
|
- postgresql-contrib
|
||||||
|
state: present
|
||||||
|
tags:
|
||||||
|
- setup
|
||||||
|
|
||||||
|
- name: Install python3-psycopg2
|
||||||
|
zypper:
|
||||||
|
name: python3-psycopg2
|
||||||
|
state: present
|
||||||
|
tags:
|
||||||
|
- setup
|
7
roles/postgresql/tasks/users.yml
Normal file
7
roles/postgresql/tasks/users.yml
Normal file
@ -0,0 +1,7 @@
|
|||||||
|
- name: Create PostgreSQL user
|
||||||
|
community.postgresql.postgresql_user:
|
||||||
|
name: '{{ postgres_user }}'
|
||||||
|
password: '{{ postgres_password }}'
|
||||||
|
state: present
|
||||||
|
tags:
|
||||||
|
- users
|
3
roles/postgresql/templates/pg_hba.conf.j2
Normal file
3
roles/postgresql/templates/pg_hba.conf.j2
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
{% for entry in postgres_hba_entries %}
|
||||||
|
{{ entry.type }} {{ entry.database }} {{ entry.user }} {{ entry.address }} {{ entry.method }}
|
||||||
|
{% endfor %}
|
12
roles/postgresql/templates/postgresql.conf.j2
Normal file
12
roles/postgresql/templates/postgresql.conf.j2
Normal file
@ -0,0 +1,12 @@
|
|||||||
|
listen_addresses = '{{ postgres_listen_addresses | default("*") }}'
|
||||||
|
|
||||||
|
port = {{ postgres_port | default(5432) }}
|
||||||
|
|
||||||
|
|
||||||
|
max_connections = {{ postgres_max_connections | default(100) }}
|
||||||
|
shared_buffers = {{ postgres_shared_buffers | default("128MB") }}
|
||||||
|
effective_cache_size = {{ postgres_effective_cache_size | default("4GB") }}
|
||||||
|
maintenance_work_mem = {{ postgres_maintenance_work_mem | default("64MB") }}
|
||||||
|
checkpoint_completion_target = {{ postgres_checkpoint_completion_target | default(0.7) }}
|
||||||
|
wal_buffers = {{ postgres_wal_buffers | default("16MB") }}
|
||||||
|
default_statistics_target = {{ postgres_default_statistics_target | default(100) }}
|
11
roles/postgresql/vars/main.yml
Normal file
11
roles/postgresql/vars/main.yml
Normal file
@ -0,0 +1,11 @@
|
|||||||
|
postgres_listen_addresses: '*'
|
||||||
|
postgres_port: 5432
|
||||||
|
|
||||||
|
postgres_hba_entries:
|
||||||
|
- { type: 'host', database: 'all', user: 'all', address: '0.0.0.0/0', method: 'md5' }
|
||||||
|
- { type: 'local', database: 'all', user: 'all', address: '', method: 'trust' }
|
||||||
|
|
||||||
|
backup_dir: "/var/lib/pgsql/backups"
|
||||||
|
postgres_user: "postgres"
|
||||||
|
postgres_password: "your_password"
|
||||||
|
postgres_db: "your_database"
|
Loading…
Reference in New Issue
Block a user