# Пример генерации самоподписанного SSL
1. Перейти в директорию с ssl сертификатами
```shell
cd /etc/nginx/zakroma-nginx/zakroma-ssl
```

2. Корневой открытый сертификат, выполнить команду, а потом прописать в common : <HOST_NAME> например s3.rpm.spiritcloud.digital-spirit.ru
```shell
sudo openssl genrsa -out CAPrivate.key 2048
sudo openssl req -x509 -new -nodes -key CAPrivate.key -sha256 -days 3650 -out CAPrivate.pem
```

3.1 Создать конфиг ssl
```shell
sudo vi openssl.ss.cnf 
```
Содержимое openssl.ss.cnf поменять базовое днс имя
```
basicConstraints=CA:FALSE
subjectAltName=DNS:*.s3.rpm.spiritcloud.digital-spirit.ru
extendedKeyUsage=serverAuth
```
Задать переменную среды которая отвечает за название файлов, вписать имя своей рабочей области:
```
export WORKSPACE_NAME="test-workspace-fs"
```

3.2 Генерация для имя рабочей области выполнить команду, а потом прописать common : <HOST_NAME> например test-workspace-fs.s3.rpm.spiritcloud.digital-spirit.ru, где test-workspace-fs - имя имя рабочей области

```
sudo mkdir -p "./$WORKSPACE_NAME" && sudo openssl genrsa -out $WORKSPACE_NAME/s3.key 2048 && sudo openssl req -new -key $WORKSPACE_NAME/s3.key -extensions v3_ca -out $WORKSPACE_NAME/s3.csr && sudo openssl x509 -req -in $WORKSPACE_NAME/s3.csr -CA CAPrivate.pem -CAkey CAPrivate.key -CAcreateserial -extfile openssl.ss.cnf -out $WORKSPACE_NAME/s3.crt -days 365 -sha256
 ```
 
3.3 Генерация для бакетов выполнить команду, а потом прописать common : <HOST_NAME> например *.test-workspace-fs.s3.rpm.spiritcloud.digital-spirit.ru ,  где test-workspace-fs - имя рабочей области, если не хочется использовать wild card сертефикат  * - имя бакета
```
sudo mkdir -p "./$WORKSPACE_NAME" && sudo openssl genrsa -out $WORKSPACE_NAME/s3--b.key 2048 && sudo openssl req -new -key $WORKSPACE_NAME/s3--b.key -extensions v3_ca -out $WORKSPACE_NAME/s3--b.csr && sudo openssl x509 -req -in $WORKSPACE_NAME/s3--b.csr -CA CAPrivate.pem -CAkey CAPrivate.key -CAcreateserial -extfile openssl.ss.cnf -out $WORKSPACE_NAME/s3--b.crt -days 365 -sha256
```

Self signed ssl certificate

Окружение

Приложение может отдавать бизнес-метрики в формате, совместимом с Prometheus, что позволяет настроить стек Prometheus+Grafana для анализа и мониторинга.

Приложение построено на микросервисной архитектуре и каждый сервис отдаёт свой набор метрик с порта, который в конфигурации обозначен как `http_aux`.
Порт по умолчанию - 8081 (при установки с помощью Ansible-роли).

Точка подключения: endpoint/metrics, 
пример localhost:8081/metrics

Доступные метрики:
- Операции на http (url, код, тип запроса)
- Количество запросов на чтение и на запись
- Количество запросов в секунду
- Общий объём хранимых данных
- Объём в разрезе рабочих областей (workspace) и бакетов.
- Среднее время ответа на запрос.
- Состояние сервисов.

![image](https://storage.yandexcloud.net/zakroma-ru/media/577c08087e7ec564e136e864b9a26676.png)

![image](https://storage.yandexcloud.net/zakroma-ru/media/29863c73d60f55156d9f33f9aed39bb8.png)


Метрики

## Zakroma.Storage

**Zakroma.Storage** - это вариант использования в качестве ресурса хранения серверов с дисками. Архитектура поддерживает отказоустойчивое хранение как на уровне дисков (при применении Erasure coding), так и на уровне узлов хранилища.

![image | 500](https://storage.yandexcloud.net/zakroma-ru/media/e31e60eef8f0a4f88408a44c272022af.png)

> [!info] Для каждого узла хранения требуется установить/настроить пакет zakroma-ds-agent

## Установка

>[!info] Ansible
>Ниже описана ручная установка пакетов. Рекомендуем воспользоваться поставляемой актуальной версией Ansible-роли, которая позволяет установить пакеты быстрее и сразу на несколько узлов. См. [Установка через Ansible](https://zakroma.ru/knowledgeBase/storage/article/ustanovka-cherez-ansible-role?version=2.3)


* Скачать rpm/dep пакет для установки zakroma-ds-agent, сохранить в домашнюю папку (в качестве примера)
  ```bash
  wget --user <LOGIN> --password <PASSWORD> https://nexus.digital-spirit.ru/repository/zakroma-deb/zakroma/zakroma-agent/zakroma-ds-agent-X.X.X-Y.deb 
  ```
* Выполнить установку пакета 
  * для apt
    ```bash
    sudo apt install ./zakroma-ds-agent-X.X.X-Y.deb
    ```
  * для apt-get
    ```bash
    sudo dpkg -i ./zakroma-ds-agent-X.X.X-Y.deb
    sudo apt-get install -f
    ```
  * для yum
    ```bash
    sudo yum localinstall ./zakroma-ds-agent-X.X.X-Y.rpm
    ```
* Выполнить настройку пакета
  * конфигурация располагается по пути `/opt/zakroma/zakroma-ds-agent/cfg/config.yaml`
> Необходимо предоставить права на запись для пользователя `zakroma-ds-agent` для  пути, указанного для `volumes.path` {.is-warning}

  * пример конфигурации (3 ноды, в каждой ноде по 1 volume, EC 3:1):

    ```yaml
      log:
        level: INFO #уровень логирования
      server:
        port: 8080 #порт для работы приложения
      tls: #настройка tls
        enable: false #по умолчанию отключена
        key: /opt/zakroma/zakroma-ds-agent/tls/key.key # путь до закрытого ключа, необходимо сгенерировать
        crt: /opt/zakroma/zakroma-ds-agent/tls/crt.key # путь до открытого ключа, необходимо сгенерировать,  добавить сертификат в список доверенных (добавить .crt в /etc/ssl/certs)
      logic:
        statusConfigPath: /opt/zakroma/zakroma-ds-agent/bin/node_status.yaml # расположение служебного файла текущего статуса ноды
        changelog:
          changelogPath: /opt/zakroma/zakroma-ds-agent/bin/changelog #расположение служебного файла changelog
      auth:
        username: #Логин для доступа, нужно сгенерировать
        password: #Пароль для доступа, нужно сгенерировать
      nodeName: node1 #имя текущей ноды
      dataPart: 2 #кол-во частей для данных
      parityPart: 1 #кол-во частей для востановления 
      nodes: # приведена конфигурация для 3 нод, по одному volume на каждой ноде
        - name: node1
          hostPort: 10.1.0.16:8080 #host + port для ноды, значение указано в качестве примера
          volumeCount: 1
        - name: node2
          hostPort: 10.1.0.17:8080 #host + port для ноды, значение указано в качестве примера
          volumeCount: 1
        - name: node3
          hostPort: 10.1.0.18:8080 #host + port для ноды, значение указано в качестве примера
          volumeCount: 1
      volumes:
        - index: 1 #индексы для volume, начинаются с 1
          path: /mnt/agent/volume1 #расположения места для хранения файлов
    ```
    
    * пример конфигурации для однонодовой конфигурации:
    ```yaml
      log:
        level: INFO #уровень логирования
      server:
        port: 8080 #порт для работы приложения
      tls: #настройка tls
        enable: false #по умолчанию отключена
        key: /opt/zakroma/zakroma-ds-agent/tls/key.key # путь до закрытого ключа, необходимо сгенерировать
        crt: /opt/zakroma/zakroma-ds-agent/tls/crt.key # путь до открытого ключа, необходимо сгенерировать, добавить сертификат в список доверенных (добавить .crt в /etc/ssl/certs)
      auth:
        username: #Логин для доступа, нужно сгенерировать
        password: #Пароль для доступа, нужно сгенерировать
      logic:
        mode: FS
      volumes:
        - index: 1 #индексы для volume, начинаются с 1
          path: /mnt/agent/volume1 #расположения места для хранения файлов
    ```
* Перезапустить службу
  ```bash
  sudo systemctl restart zakroma-ds-agent.service --now
  ```

## Что дальше?
Добавьте в административной консоли новое хранилище, указав путь к установленной службе Zakroma.Storage (ZDS) (см. [Настройка хранилища](https://zakroma.ru/knowledgeBase/storage/article/storages?version=2.2))


Настройка Zakroma.Storage (ZDS)

## Настройка на версии keycloak  >= 19.X.X

1. Заходим в keycloak.
Выбираем существующий или создаём новый realm. 
2. Необходимо создать нового клиента. Переходим в Clients, в открывшимся окне нажимаем create и создаем нового Client ID с именем zakroma В новом окне настройки меняем:
        - `Client authentication: On`
        - `Authorization: On`

3. Настраиваем сервисный аккаунт
**Clients -> Zakroma -> Service Account Roles**.  
Нажать `Assign role` -> Выбрать `admin` -> `Assign`

4. Настраиваем маппинг для пользователей
**Clients -> Zakroma -> Сlient Scopes -> zakroma-dedicated** . 
**Add mapper -> By configuraton -> User Attribute**.
        - `Mapper Type: User Attribute`     
        - `Name: username-mapper`
        - `User Attribute: username`
        - `Token Claim Name: username`
        - `Claim JSON Type: String`
        - `Add to access token: ON`   

1. `Realm Settings -> Keys` копируем kid и pyblic_key ключа с алгоритмом RS256 в настройки уствновки zakroma. 

2. `Clients -> zakroma -> Credentials` копируем clientSecret в настройки уствновки zakroma. 

3. Увеличим время жизни токена. Переходим на вкладки слева `Realm Settings -> Tokens`. Проставим следующее значение:
	
	- `Access Token Lifespan: 10 minute`
  

4. Настройка реестра пользователей

> [!info] Для тестов без LDAP
> Для тестового использования возможно использовать внутренний реестр пользователей keycloak, без интеграции с ldap.

<button tabpanelId="test" tabId="ldap-tab" isActive="true"> LDAP </button>
<button tabpanelId="test" tabId="keycloak-tab"> Keycloak inner </button>
<details tabpanelId="test" tabId="ldap-tab" isActive="true">
   <summary></summary>

#### Используется при хранеии пользователей в LDAP репозитории

#### На вкладке User Federation -> Add new provider -> ldap 
--------------

Далее заполняем значения (на примере OpenLdap):

	- `Vendor: other #other если используется OpenLdap и Active Directory если Active Directory`
	- `Connection URL: ldap://openldap.openldap.svc.cluster.local:389`
	- `Bind Type: simple`
	- `Bind DN: cn=admin,dc=demo,dc=zakroma,dc=ru`
	- `Bind Credential: xxx`
	- `Edit Mode: UNSYNCED`
	- `Users DN: ou=users,dc=demo,dc=zakroma,dc=ru`
	- `Username LDAP attribute: cn`
	- `RDN LDAP attribute: cn`
	- `UUID LDAP attribute: cn`
	- `User Object Classes: person, organizationalPerson`


и нажимаем <kbd>Save</kbd>. 

#### Далее создаём маппер из Ldap в Keycloak: Mappers -> Add mapper
--------------
Создаем mapper c именем role-mapper c типом `role-ldap-mapper`.
Общая суть сводится к синхронизацию групп AD с ролями пользователей в keycloak. Пример настроек:
	- `LDAP Roles DN: ou=groups,dc=demo,dc=zakroma,dc=ru`
	- `Role Name LDAP Attribute: cn`
	- `Role Object Classes: groupOfUniqueNames`
	- `Membership LDAP Attribute: uniqueMember`
	- `Membership Attribute Type: DN`
	- `Membership User LDAP Attribute: uid`
	- `Mode: LDAP_ONLY`
	- `User Role Retrieve Strategy: LOAD_ROLES_BY_MEMBER_ATTRIBUTE`
	- `Member-Of LDAP Attribute: memberOf`
	- `ClientID: zakroma`


#### Создаём ещё один mapper c именем username-mapper c типом `user-attribute-ldap-mapper`:
--------------
	- `User Model Attribute: username`
	- `LDAP Attribute: uid`


####  Синхронизируем пользователей.
--------------
Возвращаемся к настройкам на вкладке `User Federation -> ldap -> settings` и жмем на синхронизацию всех пользователей, тут должны увидеть что пользователи были добавлены. 

####  В необходимых настройках Zakroma необходимо выставить значение свойства userRoleName в то название роли, в которая присутствует у всех нужных пользователей. Т.е. только пользователи с даной ролью смогут пользоваться системой Zakroma.

</details>

<details tabpanelId="test" tabId="keycloak-tab">
<summary></summary>

#### Используется для тестироания, либо нестандартной конфигурации

#### Создаём роли: Clients -> Zakroma -> Roles
--------------
По кнопке `Create role` добавить роль:
        - `clouduser`
   
#### Создаём польвателей в Keycloak: Users -> Add user
--------------
```
Username: zakromaadmin
First name: Admin
Last name: Zakroma
```

#### Задаём пароль: Users -> zakromaadmin -> Credentials -> Set password
--------------
        - `Temporary: off`

#### Назначаем роль: User -> zakromaadmin -> Role mapping -> Assign Role
--------------
Переключить в режим Filter by Clients  -> в поиске написать "zakroma"
        - `clouduser`      

</details>







Настройка Keycloak

# Настройка Virtual-hosted–style


Virtual-hosted-style ([посмотреть в документации AWS](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html)) позволяет настроить обращение к данным вида:

```
https://workspace-name.hostname.ru
https://bucket-name.workspace-name.hostname.ru/key-name
```

Ниже приведены шаги для настройки сервиса Nginx, поставляемого вместе с пакетом zakroma-admin.

## 1 Настройка zakroma-gateway

Предположим, что у Вас:
- **hostname.ru** - доменный путь до сервиса gateway 
- **workspace-name** - имя рабочей области, в которой распологается бакет(ы)
- **bucket-name** - имя бакета, к которому настраивается доступ в Virtual-hosted–style

### 1.1 Добавить в конфигурацию zakroma-gateway s3_domain
```
sudo vi /opt/zakroma/zakroma-gateway/cfg/config.yaml
```
Указать параметр s3_domain:
```
s3_domain: hostname.ru
```

###  1.2 Перезапустить zakroma-gateway 
```
sudo systemctl restart zakroma-gateway.service --now
sudo systemctl status zakroma-gateway.service
```

## 2. Cоздание нужных папок
```sh
sudo mkdir -p /etc/nginx/zakroma-nginx
sudo mkdir -p /etc/nginx/zakroma-nginx/zakroma-proxy
sudo mkdir -p /etc/nginx/zakroma-nginx/zakroma-ssl
sudo mkdir -p /etc/nginx/zakroma-nginx/logs
```
## 3. Сгенерировать SSL сертификаты

Необходимо сгенерировать SSL-сертификаты и разместить их в следующей директории:
```sh 
cd /etc/nginx/zakroma-nginx/zakroma-ssl
```
3.1 Сертификат для рабочей области: 
**workspace-name.hostname.ru**
3.2 Wild card cертификат для бакетов:
***.workspace-name.hostname.ru**, где вместо * можно подставить имя бакета, если не хочется использовать wild card сертификат.

Путь сертификата формируется следующим образом:
key путь: /etc/nginx/zakroma-nginx/zakroma-ssl/workspace_name/s3.key
crt путь: /etc/nginx/zakroma-nginx/zakroma-ssl/workspace_name/s3.crt
```
для бакета тот же путь но с постфиксом --b после имени воркспейса (workspace_name/s3--b.crt)
```
> [!info] Настройку самоподписанных сертификатов можно посмотреть [здесь](https://zakroma.ru/knowledgeBase/storage/article/self-signed-ssl-certificate?version=2.2).

## 4. Cоздание конфигурации nginx

### 4.1 Создание общей конфигурации 

Для принудительной переадресации на https нужно настроить файл конфигурации:

```shell
sudo vi /etc/nginx/zakroma-nginx/zakroma-proxy/force-ssl.conf
```
Добавить в файл force-ssl.conf:
```
if ($scheme = "http") {
         return 301 https://$host$request_uri;
}
```
Для настройки логирования входящих запросов нужно настроить файл конфигурации:

```
sudo vi /etc/nginx/zakroma-nginx/zakroma-proxy/proxy-log.conf
```
Добавить в файл proxy-log.conf:
```
server_names_hash_bucket_size  128;
map "" $server {
    default       "0.0.0.0";
}
map "" $port {
    default       0000;
}
 
log_format proxy '[$time_local] $upstream_cache_status $upstream_status $status - $request_method $scheme $host "$request_uri" [Client $remote_addr] [Length $body_bytes_sent] [Gzip $gzip_ratio] [Sent-to $server : $port] "$http_user_agent" "$http_referer"'; 
```

### 4.2 Импорт настроек в nginx 

Добавить импорт настроек в корневой файл nginx:
```sh 
sudo vi /etc/nginx/nginx.conf
```
Добавить **внутрь блока http, перед блоком server** следующие строчки:

```shell
include /etc/nginx/zakroma-nginx/zakroma-proxy/proxy-log.conf;
include /etc/nginx/zakroma-nginx/zakroma-proxy/zakroma-proxy-*.conf;
```
Все конфигурационные файлы с префиксом "zakroma-proxy-" в директории **zakroma-proxy** будут подтягиваться автоматически.

### 4.3 Настройка перенаправления

Для каждой рабочей области (workspace), для которой нужен Virtual-hosted–style, необходимо добавить параметры перенаправления, указанные в двух файлах конфигурации в директорию **/etc/nginx/zakroma-nginx/zakroma-proxy/**:

> [!warning] Порты
Для текущей версии используйте только стандартные порты для http 80, для https 443


Взяв пример конфигурации (см ниже), необходимо поменять следующие параметры, для каждой из двух конфигураций (**для рабочей области, для бакетов в рабочей области**): 
- измените test-workspace-fs на название своей рабочей области в названии файла
- $server - ip/host до zakroma-gateway
- $port - port до zakroma-gateway
- $workspace_name   имя рабочей области
- $base_host_name   базовый доменный адрес
- client_max_body_size - размер максимального парта (взять из конфигурации zakroma-gateway "max_request_body")
- заменить workspace_name в **ssl_certificate, ssl_certificate_key, access_log, error_log** на имя вашей рабочей области


- **Конфигурация для рабочей области** (см. пример zakroma-proxy-test-workspace-fs.conf)

<details>
<summary>Содержимое файла zakroma-proxy-test-workspace-fs.conf</summary>
  
``` sh
sudo vi /etc/nginx/zakroma-nginx/zakroma-proxy/zakroma-proxy-test-workspace-fs.conf
```
  
```
# ------------------------------------------------------------
# workspace-name.hostname.ru
# ------------------------------------------------------------

server {
  # change this variables
  set $server           "127.0.0.1";
  set $port             8081;
  set $workspace_name   workspace-name;
  set $base_host_name   hostname;
  client_max_body_size 8M;
  
  # Custom SSL
  ssl_certificate /etc/nginx/zakroma-nginx/zakroma-ssl/workspace_name/s3.crt;
  ssl_certificate_key /etc/nginx/zakroma-nginx/zakroma-ssl/workspace_name/s3.key;
  
  access_log "/etc/nginx/zakroma-nginx/logs/workspace_name/access.log" proxy;
  error_log "/etc/nginx/zakroma-nginx/logs/workspace_name/error.log" warn;
  
  
  
  
  
  
  listen 443 ssl;
  listen [::]:443 ssl;
  server_name "$workspace_name.$base_host_name";

  # Force SSL
  include /etc/nginx/zakroma-nginx/zakroma-proxy/force-ssl.conf;

  location ~ ^/(.*) {
	proxy_set_header Host $http_host;
	proxy_set_header X-Forwarded-Scheme $scheme;
	proxy_set_header X-Forwarded-Proto  $scheme;
	proxy_set_header X-Forwarded-For    $remote_addr;
	proxy_set_header X-Real-IP          $remote_addr;
	proxy_pass       http://$server:$port/s3/$1$is_args$args;

	# Force SSL
	include /etc/nginx/zakroma-nginx/zakroma-proxy/force-ssl.conf;

	add_header x-forwarded-path $request_uri;
  }

}
```

</details>


- **Конфигурация для бакетов текущей рабочей области** (см. пример zakroma-proxy-test-workspace-fs--b.conf)

<details>
<summary>Содержимое файла zakroma-proxy-test-workspace-fs--b.conf</summary>

``` sh
sudo vi /etc/nginx/zakroma-nginx/zakroma-proxy/zakroma-proxy-test-workspace-fs--b.conf
```

```
# ------------------------------------------------------------
# *.workspace-name.hostname.ru
# ------------------------------------------------------------

server {
  # change this variables
  set $server           "127.0.0.1";
  set $port             8081;
  set $workspace_name   workspace-name;
  set $base_host_name   hostname;
  client_max_body_size 8M;
  
	# Custom SSL
  ssl_certificate /etc/nginx/zakroma-nginx/zakroma-ssl/workspace_name/s3--b.crt;
  ssl_certificate_key /etc/nginx/zakroma-nginx/zakroma-ssl/workspace_name/s3--b.key;
  
  access_log "/etc/nginx/zakroma-nginx/logs/workspace_name/access--b.log" proxy;
  error_log "/etc/nginx/zakroma-nginx/logs/workspace_name/error--b.log" warn;
  
  
  
  
  
  
  
  
  listen 443 ssl;
  listen [::]:443 ssl;
  server_name "*.$workspace_name.$base_host_name";
  

  # Force SSL
  include /etc/nginx/zakroma-nginx/zakroma-proxy/force-ssl.conf;
 

  location ~ ^/(.*) {
	proxy_set_header Host $http_host;
	proxy_set_header X-Forwarded-Scheme $scheme;
	proxy_set_header X-Forwarded-Proto  $scheme;
	proxy_set_header X-Forwarded-For    $remote_addr;
	proxy_set_header X-Real-IP          $remote_addr;
	proxy_pass       http://$server:$port/s3/$1$is_args$args;

	# Force SSL
	include /etc/nginx/zakroma-nginx/zakroma-proxy/force-ssl.conf;

	add_header x-forwarded-path $request_uri;
  }

}

```
</details>

> [!info] Чтобы конфигурации автоматически подтягивались необходимо их называть по шаблону zakroma-proxy-*.conf Рекомендация для конфигурации бакетов называть с таким же именем, добавляя в конце постфикс --b например zakroma-proxy-test-workspace-fs--b.conf

 
> [!info] Расположение логов:
>
> access_log /etc/nginx/zakroma-nginx/logs/workspace-name/access.log 
> error_log /etc/nginx/zakroma-nginx/logs/workspace-name/error.log 
> 
> где workspace_name - имя рабочей области, для бакета тот же путь но с постфиксом --b  (workspace_name/access--b.log )


**Cоздать папки для логов:**
Измените название на имя вашей рабочей области и выполните команду:
```
export WORKSPACE_NAME="your-workspace-name"
```
Команда для создания папки логов
```shell
sudo mkdir -p /etc/nginx/zakroma-nginx/logs/$WORKSPACE_NAME
```


## 5. Перезапуск nginx 
```shell
sudo systemctl restart nginx.service --now
sudo systemctl status nginx.service
```




Настройка Virtual-hosted–style


## Установка PostgreSQL

При установке лучше ориентироваться на рекомендации по установке конкретной версии PostgreSQL (рекомендуемая версия - 16).

### Вариант установки и настройки PostgreSQL

Установить **postgresql-server (v16+):**

```sh 
sudo yum install -y postgresql-server
```

Запустить сервис базы данных:
```sh 
sudo /usr/bin/postgresql-setup --initdb
sudo systemctl enable postgresql.service --now
```

Установить **postgresql-contrib (v12+):**
```sh 
sudo yum install -y postgresql-contrib
```

Настроить доступ к базе с требуемых узлов в файле **/var/lib/pgsql/data/pg_hba.conf**, закомментировать строки содержащие **ident** и добавить следующее:
```text
host    all             all             127.0.0.1/32            md5
host    all             all             ::1/128                 md5
local   all             all                                     md5
```

Перезапустить сервис:
```sh
sudo systemctl restart postgresql.service --now
```

### Создать базу(ы) данных и схемы

1. Зайти под пользователем с админ. правами (по умолчанию - postgres):
```sh 
sudo su - postgres
```

2. Подключиться к базе через psql:
```sh 
psql -U postgres -d postgres
```
1. Выполнить SQL команды для создания пользователя и cхем. Заменить значение **zakroma_password** на своё:
```sql
-- Zakroma
CREATE USER zakroma_user LOGIN PASSWORD 'zakroma_password';
create DATABASE permission WITH OWNER zakroma_user;
create DATABASE core WITH OWNER zakroma_user;
create DATABASE seclog WITH OWNER zakroma_user;
create DATABASE notification WITH OWNER zakroma_user;
create DATABASE worker1 WITH OWNER zakroma_user;
```



> [!info] Базы или Схемы
> Вы можете использовать одну общую базу данных с разными схемами или создать отдельные базы данных и в каждой одну схему. Главное корректно прописать эти базы и схемы в конфигурации при инсталляции сервисов ЗАКРОМА.


```sql
-- Zakroma
CREATE USER zakroma_user LOGIN PASSWORD 'zakroma_password';
CREATE DATABASE zakroma WITH OWNER zakroma_user;
\c zakroma
DROP SCHEMA public;
CREATE SCHEMA core AUTHORIZATION zakroma_user;
CREATE SCHEMA permission AUTHORIZATION zakroma_user;
CREATE SCHEMA seclog AUTHORIZATION zakroma_user;
CREATE SCHEMA notification AUTHORIZATION zakroma_user;
CREATE SCHEMA worker1 AUTHORIZATION zakroma_user;
```

2. Добавить схемы в каждую из созданных баз (или в одной базе postgres) :

На примере базы `permission`:
```sh 
\c permission;
```
Создать схему:
```sh 
CREATE SCHEMA if not exists  public;
```
3. Дополнительно необходимо создать extension в схеме `worker1`
``` sql
\c worker1

CREATE EXTENSION if not exists pgcrypto CASCADE;
```
4. После создания баз и схем выйти из учетной psql:
```sh
exit
```
Затем выйти из учетной записи postgres:
```sh
exit
```

## Дальнейшие шаги

- Оптимизировать параметры PostgreSQL (опционально):
     - Проверить и установить параметр sharedbuffers = 1024MB ( или 25% от общего размера ОЗУ системы) в файле конфигурации `postgresql.conf`



Настройка PostgreSQL

Расчет требований к инфраструктуре

Требования

Первые шаги в приложении

Начало работы

С чего начать

Установка через ansible

Бинарные пакеты

Подготовка инфраструктуры

Установка helm-чартами

Контейнеры

Установка

Описание работы страницы с операциями

Операции

Отслеживание задач и статуса системы

Мониторинг

CLI (Command Line Interface, zcli)

CORS

Подключение ресурса хранения

Хранилища

Просмотр бакета

Управление рабочими областями

Рабочие области

Как создавать и настраивать бакеты

Бакет (bucket)

Публичные бакеты

Шардирование

Описание типов хранилищ

Тип Хранилища

Удаление бакета

Версионирование бакета

Версионирование

Настройка хранения

Политики доступа предназначены для создания правил разграничения доступа пользователей к операциям S3.

Политики доступа

Редактирование информации о пользователях

Пользователи

Роли

Администраторы workspace/bucket

Профиль пользователя

Управление ключами доступа

Фильтрация по IP

Группы пользователей

Доступ

Принцип работы кластерного режима

Мультикластер

Включение кластерного режима

Добавление кластера

Управление

Механизм оповещения других систем о событиях в хранилище.

Webhooks

Как подключить хранилище с уже имеющимися данными в нем

Подключение хранилища с данными

Путь хранения объектов бакета на подключенном хранилище

Формирование пути хранения данных

Правила жизненного цикла данных

Жизненный цикл

Политика Расширение позволяет объединить несколько ресурсов хранения

Расширение

Политика Зеркалирование позволяет настроить синхронную и асинхронную репликацию бакета

Зеркалирование

Политики хранения

Перенос данных бакета из одного Хранилища в другое

Миграция данных

Настройка подключения к Закрома Хранение

Подключение к Закрома.Хранение

Таблица поддерживаемых методов AWS S3

Поддержка методов AWS S3

Описание возможностей масштабирования объёма хранения кластера