Установка Single Node

Устанавливаемые компоненты

Установка

1. Получить и распаковать архив

Copy
1tar -xvzf zakroma-roles-<ВЕРСИЯ_РЕЛИЗА_АРХИВА_С_ANSIBLE_РОЛЯМИ>.tar.gz

1.1. Перейти в директорию с ролями

Copy
1cd zakroma-roles-<ВЕРСИЯ_РЕЛИЗА_АРХИВА_С_ANSIBLE_РОЛЯМИ>

2. Создать inventory, включающий хостнейм в соответствующих хост-группах, как пример можно использовать файл inventories/single-node/hosts

Copy
1[certificates]  
2plank ansible_host=10.40.0.10  
3  
4[keycloak]  
5plank ansible_host=10.40.0.10  
6  
7[zakroma-storage-nginx]  
8plank ansible_host=10.40.0.10 
9
10[zakroma-archive]  
11plank ansible_host=10.40.0.10

3. Скопировать сертификаты на целевые хосты с помощью роли certificates

• Необходимо отредактировать файл переменных inventories/single-node/group_vars/certificates.yml роли certificates для группы хостов certificates

Copy
1---  
2# Задаёт путь к каталогу, откуда копируются сертификаты и ключи.  
3certificates_copy_source_path: "files"  
4  
5# Содержит информацию о каждом хосте, на который нужно скопировать сертификаты и ключи.  
6# Ключ словаря — это имя хоста из вашего inventory, а значение — ещё один словарь, который включает в себя список сертификатов для копирования.  
7# Внутри host_cert_config для каждого хоста объявляется массив certs, в котором можно описать разные сертификаты и ключи (если нужно скопировать несколько файлов)  
8host_cert_config:  
9  # Имя хоста из inventory файла  
10  plank:  
11    certs:  
12      # Каталог, из которого копируются файлы сертификата и ключа. Обычно совпадает со значением переменной certificates_copy_source_path, но может быть переопределён для отдельных хостов.  
13      - src_dir: "{{ certificates_copy_source_path }}"  
14  
15        # Целевой каталог на хосте, в который нужно скопировать сертификаты и ключи.  
16        dest_dir: "/opt/keycloak/"  
17  
18        # Имя файла сертификата, который будет скопирован.  
19        cert_file: "keycloak.crt"  
20  
21        # Имя файла закрытого ключа (private key), который будет скопирован.  
22        key_file: "keycloak.key"  
23  
24        # Владелец (пользователь) файлов сертификата и ключа на целевом хосте.  
25        owner: "keycloak"  
26  
27        # Группа владельца файлов сертификата и ключа на целевом хосте.  
28        group: "keycloak"  
29  
30        # Права (в формате UNIX, например, 0644) на файл сертификата.  
31        cert_permissions: "0644"  
32  
33        #  Права (в формате UNIX, например, 0600) на файл ключа  
34        key_permissions: "0600"  
35  
36      - src_dir: "{{ certificates_copy_source_path }}"  
37        dest_dir: "/opt/certs/"  
38        cert_file: "zakroma.crt"  
39        key_file: "zakroma.key"  
40        owner: "nginx"  
41        group: "nginx"  
42        cert_permissions: "0644"  
43        key_permissions: "0600"

• Запустить playbook:

Copy
1ansible-playbook -i inventories/single-node/hosts playbooks/sample-play-copy-certificates.yml

4. Установка Nginx (на хосты с Zakroma Archive)

• Необходимо отредактировать файл переменных inventories/single-node/group_vars/zakroma-storage-nginx.yml роли nginx для группы хостов zakroma-storage-nginx

Copy
1---  
2# Перезапустить nginx, даже если не было изменений  
3flush_restart_nginx: false  
4  
5# Используется только для установки на Debian/Ubuntu, так как используется опция -t для apt.  
Развернуть

• Запустить playbook:

Copy
1ansible-playbook -i inventories/single-node/hosts playbooks/sample-play-zakroma-storage-nginx.yml

• Проверить доступность Web интерфейса:
  • Url - https://zakroma-admin.zakroma.local
  • Username - Какой вы указали на этапе создания пользователя в Keycloak. Если был импорт готового REALM, то username - ‘zakromaadmin’
  • Password - Какой вы указали на этапе создания пользователя в Keycloak. Если был импорт готового REALM, то пароль - ‘zakromaadmin’

5. Установить Закрома.Архив (Zakroma Archive)

• Необходимо скопировать zakroma_archive_s3_secret_key для пользователя zakromaadmin (по умолчанию) из настроек вашего S3-хранилища.
• Необходимо отредактировать файл переменных inventories/single-node/group_vars/zakroma-archive.yml роли zakroma-archive для группы хостов zakroma-archive

Copy
1---
2# =============================================================================
3# Основные настройки для установки Закрома Архив
4# =============================================================================
Развернуть

• Запустить playbook:

Copy
1ansible-playbook -i inventories/single-node/hosts playbooks/sample-play-zakroma-archive.yml