Приложение может отдавать бизнес-метрики в формате, совместимом с 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)


Метрики

Окружение


## Установка 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

# Пример генерации самоподписанного 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

## 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

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

Требования

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

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

С чего начать

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

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

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

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

Контейнеры

Установка

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

Мониторинг

CLI (Command Line Interface, zcli)

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

Операции

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

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

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

CORS

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

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

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

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

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

Хранилища

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

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

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

Бакет (bucket)

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

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

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

Роли

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

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

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

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

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

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

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

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

Доступ

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

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

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

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

Управление

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

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

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

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

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

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

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

Расширение

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

Webhooks

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

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

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

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

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

Отказоустойчивость

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

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

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

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

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