Дистрибутив

Компоненты продукта поставляются в виде deb/rpm-пакетов.

Состав дистрибутива

Дистрибутив продукта включает:

роли Ansible для развертывания компонентов;
пакеты компонентов:
- пакет inno-samba;
- пакет inno-samba-dc-exporter;
- пакет dsm;
документацию, файл с описанием истории изменений по версиям продукта (CHANGELOG.md), файл с описанием известных проблем (KNOWNISSUES.md) и файл с информацией об особенностях настройки функциональности при развертывании (DEPLOYMENTPLAN.md);
отчеты по результатам тестирования компонентов.

Формат именования пакетов

Имена пакетов формируются по шаблону:

<package_name>_<build_version>-<edition>_<architecture>.<package_type>

Элементы шаблона:

package_name — наименование пакета компонента продукта;
build_version — версия пакета в соответствии с принципами семантического версионирования (мажорная_версия.минорная_версия.патч-версия);
edition — редакция дистрибутива (необязательный элемент);
architecture — архитектура;
package_type — тип пакета (deb/rpm).

Пример:

inno-samba_1.6.0_amd64.deb
inno-samba-1.4.5-1.x86_64.rpm
dsm_2.0.0-1_amd64.deb
dsm-1.8.0-1.x86_64.rpm

Получение доступа к дистрибутиву

Дистрибутив распространяется:

через apt/yum-репозиторий https://artifacts.inno.tech/repository/<client>-<edition>-<type>-packages, где:
- client — условное обозначение клиента;
- edition — редакция дистрибутива (astra/redos);
- type — тип репозитория (apt/yum).

в виде архивов в формате tar.gz, доступных для загрузки из репозитория https://artifacts.inno.tech/repository/<client>-<edition>-raw-packages, где:

client — условное обозначение клиента;
edition — редакция дистрибутива.

Пример структуры репозитория с архивами:

directory-service
└── 1.4.0
    ├── directory-service-all-1.4.0.tar.gz
    ├── directory-service-all-1.4.0.tar.gz.sha512
    ├── directory-service-docs-1.4.0.tar.gz
    ├── directory-service-docs-1.4.0.tar.gz.sha512
    ├── directory-service-packages-1.4.0.tar.gz
    ├── directory-service-packages-1.4.0.tar.gz.sha512
    ├── directory-service-reports-1.4.0.tar.gz
    └── directory-service-reports-1.4.0.tar.gz.sha512

Подключение apt-репозитория

Для установки deb-пакетов компонентов продукта и зависимостей из публичного apt-репозитория ГК «Иннотех» требуются:

ссылка на apt-репозиторий в формате https://artifacts.inno.tech/repository/<client>-<edition>-apt-packages;
файл с публичным ключом для доступа к apt-репозиторию;
учетная запись для доступа к apt-репозиторию.

Для подключения apt-репозитория на сервере, на котором будет выполняться установка компонентов продукта:

Добавьте публичный ключ для доступа к apt-репозиторию с пакетом стандартным способом:

sudo apt-key add <key-file-name>

При необходимости установки ключа для проверки подписи исполняемых файлов в защищенном режиме работы Astra Linux SE 1.7 следуйте инструкции в официальной документации.

Создайте файл /etc/apt/auth.conf.d/innotech.conf и укажите в нем данные для доступа к репозиторию в стандартном формате:
```
machine <repo_host> login <repo_user> password <repo_password>
```
Добавьте apt-репозиторий в список:
```
echo -e "deb https://artifacts.inno.tech/repository/<client>-<edition>-apt-packages main" | sudo tee /etc/apt/sources.list.d/innotech.list
```
См. инструкцию в официальной документации ОС Astra Linux.
Обновите пакеты с помощью стандартной команды.
```
sudo apt update -y
```

Подключение yum-репозитория

В текущей версии продукта дистрибутив для РЕД ОС поставляется в виде архивов для скачивания по ссылке вида:

https://artifacts.inno.tech/repository/<client>-redos-raw-packages/directory-service/<version>/directory-service-all-<version>.tar.gz

Скачивание архива

Для скачивания архива с deb/rpm-пакетами требуются:

ссылка на репозиторий с архивом в формате https://artifacts.inno.tech/repository/<client>-<edition>-raw-packages;
учетная запись для доступа к репозиторию.

Для установки пакетов на сервере из архива:

Скачайте архив с полным дистрибутивом directory-service-all-<version>.tar.gz или только с deb/rpm-пакетами directory-service-packages-<version>.tar.gz из репозитория https://artifacts.inno.tech/repository/<client>-<edition>-raw-packages.
При необходимости убедитесь в целостности архива, сравнив его контрольную сумму с контрольной суммой в соответствующем файле.

Например:
```
shasum -a 512 -c directory-service-all-1.6.0.tar.gz.sha512
directory-service-all-1.6.0.tar.gz: OK
```

Создайте временный каталог для распаковки и распакуйте архив:

Например:

mkdir directory-service
tar xvf directory-service-all-1.6.0.tar.gz -C directory-service

Пример содержимого архива:

Astra Linux
РЕД ОС

Пример содержимого архива для ОС Astra Linux:

directory-service
├── installer-1.0.2 # Инсталлятор
│   ├── inventory # Примеры схем развертывания
│   │   ├── example_1.yaml # Ввод в домен AD
│   │   └── example_2.yaml # Создание домена с двумя контроллерами
│   ├── roles # Роли Ansible
│   │   ├── bind # Роль для развертывания DNS-сервера BIND 9
│   │   ├── dsm # Роль для развертывания приложения DSM
│   │   ├── robocopy # Роль для настройки синхронизации SYSVOL
│   │   ├── samba # Роль для установки inno-samba
│   │   └── samba-dc-exporter # Роль для развертывания сервиса мониторинга
│   ├── install.yaml # Сценарий развертывания (playbook)
│   └── README.MD
│
├── packages # Пакеты компонентов продукта и некоторые обязательные зависимости
│   ├── dsm-2.0.0
│   │   └── dsm_2.0.0-1_amd64.deb
│   └── inno-samba-1.6.0
│       ├── inno-samba_1.6.0_amd64.deb
│       ├── inno-samba-dc-exporter_1.7.3_amd64.deb
│       ├── libgnutls30_3.6.16_amd64.deb
│       ├── liblmdb0_0.9.21-1-inno-18_amd64.deb
│       └── python3-prometheus-client_0.18.2_amd64.deb
│
├── reports # Отчеты по результатам тестирования
│   ├── directory_service_e2e_v1.6.0.pdf # Отчет Allure по сквозным тестам
│   ├── directory-service-pmi_v1.6.0.pdf # Отчет Allure по тестам в рамках ПМИ
│   ├── dsm_v2.0.0.pdf # Отчет Allure по тестам DSM
│   ├── samba_core_perfomance_v1.6.0.pdf # Отчет по нагрузочному тестированию Эллес
│   └── samba_core_v1.6.0.pdf # Отчет Allure по тестам Эллес
│
└── docs # История изменений в продукте и документация
    ├── installer-1.0.2 # Документация на роли Ansible
    │   ├── bind
    │   │   └── README.md
    │   ├── dsm
    │   │   └── README.md
    │   ├── robocopy
    │   │   └── README.md
    │   ├── samba
    │   │   └── README.md
    │   ├── samba-dc-exporter
    │   │   └── README.md
    │   ├── CHANGELOG.md
    │   └── README.md
    ├── DirectoryService-AdminGuideCLI-Ru.pdf
    ├── DirectoryService-AdminGuideDSM-Ru.pdf
    ├── DirectoryService-Desc-Ru.pdf
    ├── DirectoryService-InstallGuide-Ru.pdf
    ├── DirectoryService-MaintenanceGuide-Ru.pdf
    ├── SambaDCExporter-AdminGuide-Ru.pdf
    ├── CHANGELOG.md # История изменений в продукте
    ├── KNOWNISSUES.md # Известные проблемы
    └── DEPLOYMENTPLAN.md # Настройка функциональности при развертывании

Пример содержимого архива для РЕД ОС:

directory-service
├── packages # Пакеты компонентов продукта и некоторые обязательные зависимости
│   ├── dsm-1.8.0-1.x86_64.rpm
│   ├── inno-samba-1.4.5-1.x86_64.rpm
│   ├── python3-prometheus-client-0.18.2-1.x86_64.rpm
│   └── samba-dc-exporter-1.7.3-1.noarch.rpm
│
└── docs # История изменений в продукте и документация
    ├── DirectoryService-AdminGuideCLI-Ru.pdf
    ├── DirectoryService-AdminGuideDSM-Ru.pdf
    ├── DirectoryService-Desc-Ru.pdf
    ├── DirectoryService-InstallGuide-Ru.pdf
    ├── DirectoryService-MaintenanceGuide-Ru.pdf
    ├── SambaDCExporter-AdminGuide-Ru.pdf
    └── CHANGELOG.md # История изменений в продукте

Обратите внимание:

версии компонентов могут отличаться от версии продукта;
для удобства в состав архива включены некоторые дополнительные пакеты, которые должны устанавливаться в качестве обязательных зависимостей и которые могут отсутствовать во внешних репозиториях ОС.

Для корректной установки зависимостей убедитесь, что на сервере доступны стандартные репозитории операционной системы:

по умолчанию после установки ОС Astra Linux файл /etc/apt/sources.list должен содержать следующие ссылки:

deb https://download.astralinux.ru/astra/stable/1.7_x86-64/repository-main/ 1.7_x86-64 main contrib non-free
deb https://download.astralinux.ru/astra/stable/1.7_x86-64/repository-update/ 1.7_x86-64 main contrib non-free
deb https://download.astralinux.ru/astra/stable/1.7_x86-64/repository-base/ 1.7_x86-64 main contrib non-free
deb https://download.astralinux.ru/astra/stable/1.7_x86-64/repository-extended/ 1.7_x86-64 main contrib non-free

для просмотра всех доступных репозиториев на РЕД ОС используйте команду:

dnf repolist all
идентификатор репозитория       имя репозитория                        состояние
base                            RedOS - Base                           включено
kernels6                        Repositories for kernels6              включено
updates                         RedOS - Updates                        включено
yandex-browser-release          Repositories for Yandex Browser        включено

Обновите пакеты с помощью стандартной команды:
- Astra Linux
- РЕД ОС
sudo apt update -y
sudo dnf update -y