logo

Установка базового кластера

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

КомпонентОписание
Zakroma-StorageУправляющий слой, обеспечивающий S3-протокол.
Zakroma-ZDSНижний слой хранения (минимальное требование — 3 узла в режиме Erasure Coding, 1 узел - в режиме без избыточного кодирования).
KeycloakСистема управления аутентификацией и авторизацией (используется для Admin UI и доступа к Zakroma).
NginxProxy-сервер, выступающий в качестве фронтенда для Zakroma-Storage.
PostgreSQLСУБД для метаданных Zakroma-Storage и Keycloak.
СерверКомпоненты
rutherford-1.zakroma.localKeycloak
rutherford-2.zakroma.localZakroma-Storage, Zakroma-ZDS (Erasure Coding 2+1), Nginx
rutherford-3.zakroma.localZakroma-Storage, Zakroma-ZDS (Erasure Coding 2+1), Nginx
rutherford-4.zakroma.localZakroma-Storage, Zakroma-ZDS (Erasure Coding 2+1), Nginx
rutherford-5.zakroma.localPostgreSQL

Установка

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

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

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

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

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

1[certificates]  
2rutherford-1 ansible_host=192.168.1.1  
3rutherford-2 ansible_host=192.168.1.2  
4rutherford-3 ansible_host=192.168.1.3  
5rutherford-4 ansible_host=192.168.1.4  
6  
7[keycloak]  
8rutherford-1 ansible_host=192.168.1.1  
9  
10[zakroma-storage-nginx]  
11rutherford-2 ansible_host=192.168.1.2  
12rutherford-3 ansible_host=192.168.1.3  
13rutherford-4 ansible_host=192.168.1.4  
14  
15[zakroma-storage]  
16rutherford-2 ansible_host=192.168.1.2  
17rutherford-3 ansible_host=192.168.1.3  
18rutherford-4 ansible_host=192.168.1.4  
19  
20[zakroma-zds-ec]  
21rutherford-2 ansible_host=192.168.1.2  
22rutherford-3 ansible_host=192.168.1.3  
23rutherford-4 ansible_host=192.168.1.4

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

  • Необходимо отредактировать файл переменных inventories/base-cluster/group_vars/certificates.yml роли certificates для группы хостов certificates
1---  
2# Задаёт путь к каталогу, откуда копируются сертификаты и ключи.  
3certificates_copy_source_path: "files"  
4  
5# Содержит информацию о каждом хосте, на который нужно скопировать сертификаты и ключи.  
Развернутьarrow
  • Запустить playbook:
1ansible-playbook -i inventories/base-cluster/hosts playbooks/sample-play-copy-certificates.yml

4. Установка Keycloak с помощью роли keycloak

  • Необходимо отредактировать файл переменных inventories/base-cluster/group_vars/keycloak.yml роли keycloak для группы хостов keycloak
1---
2# Адрес (хост) PostgreSQL, к которому будет подключаться Keycloak.
3postgres_host: 'postgresql.zakroma.local'
4
5# Базовый домен, используемый в URL для Keycloak.
Развернутьarrow
  • Запустить playbook:
1ansible-playbook -i inventories/base-cluster/hosts playbooks/sample-play-keycloak.yml
  • После установки keycloak необходимо сконфигурировать REALM по инструкции https://zakroma.ru/knowledgeBase/storage/article/keycloack или воспользоваться плейбуком, который сделает импорт готового REALM
1ansible-playbook -i inventories/base-cluster/hosts playbooks/sample-play-keycloak-copy-realm.yml
  • Проверить доступность Web интерфейса:
    • Url - https://keycloak.zakroma.local:8443
    • Username - Какой вы указали в group_vars для роли keycloak. Если был импорт готового REALM, то username - ‘admin’
    • Password - Какой вы указали в group_vars для роли keycloak. Если был импорт готового REALM, то пароль - ‘predef1nedPassw0rd’

5. Установка Zakroma Storage

  • Подготовить файл с лицензией licence, положить его в директорию ./files и запустить playbook playbooks/sample-play-copy-licence-file.yaml для группы хостов zakroma-storage

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

1# ---------------------------------------------------ОБЩИЕ НАСТРОЙКИ---------------------------------------------------
2# Выполнить удаление старых пакетов ничего больше
3zakroma_storage_delete_packages_only: false
4
5# Выполнить только рестарт сервисов и ничего больше
Развернутьarrow
  • Запустить playbook:
1ansible-playbook -i inventories/base-cluster/hosts playbooks/sample-play-zakroma-storage.yml

6. Установка Nginx (на хосты с Zakroma Storage)

  • Необходимо отредактировать файл переменных inventories/base-cluster/group_vars/zakroma-storage-nginx.yml роли nginx для группы хостов zakroma-storage-nginx
1---  
2# Перезапустить nginx, даже если не было изменений  
3flush_restart_nginx: false  
4  
5# Используется только для установки на Debian/Ubuntu, так как используется опция -t для apt.  
Развернутьarrow
  • Запустить playbook:
1ansible-playbook -i inventories/base-cluster/hosts playbooks/sample-play-zakroma-storage-nginx.yml
  • Проверить доступность Web интерфейса:
    • Url - https://zakroma-admin.zakroma.local
    • Username - Какой вы указали на этапе создания пользователя в Keycloak. Если был импорт готового REALM, то username - ‘zakromaadmin’
    • Password - Какой вы указали на этапе создания пользователя в Keycloak. Если был импорт готового REALM, то пароль - ‘zakromaadmin’

7. Установка Zakroma ZDS в режиме EC (Erasure coding, минимум 3 хоста) (нижний слой хранения)

  • Необходимо отредактировать файл переменных inventories/base-cluster/group_vars/zakroma-storage-zds-ec.yml роли zakroma-zds для группы хостов zakroma-zds-ec
1# Выполнить удаление старых пакетов ничего больше
2zakroma_zds_delete_packages_only: false
3
4# Выполнить только рестарт сервисов и ничего больше
5zakroma_zds_restart_services_only: false
Развернутьarrow
  • Запустить playbook:
1ansible-playbook -i inventories/base-cluster/hosts playbooks/sample-play-zakroma-zds-ec.yml