Дистрибутив

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

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

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

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

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

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

<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.11.1
    ├── directory-service-all-1.11.1.tar.gz
    ├── directory-service-all-1.11.1.tar.gz.sha512
    ├── directory-service-docs-1.11.1.tar.gz
    ├── directory-service-docs-1.11.1.tar.gz.sha512
    ├── directory-service-packages-1.11.1.tar.gz
    ├── directory-service-packages-1.11.1.tar.gz.sha512
    ├── directory-service-reports-1.11.1.tar.gz
    └── directory-service-reports-1.11.1.tar.gz.sha512

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

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

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

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

Добавьте apt-репозиторий:

echo -e "deb https://artifacts.inno.tech/repository/<client>-astra-apt-packages/ 1.7_x86-64 main" | sudo tee /etc/apt/sources.list.d/innotech.list

См. инструкцию в официальной документации ОС Astra Linux.

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

echo -e "machine  artifacts.inno.tech login <repo_user> password <repo_password>" | sudo tee /etc/apt/auth.conf.d/innotech.conf

Скачайте файл публичного ключа из каталога keys в репозитории <client>-astra-raw-packages и добавьте его:
```
sudo apt-key add <client>_astra_signing.key
```
Обновите пакеты с помощью стандартной команды:
```
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.11.1.tar.gz.sha512
directory-service-all-1.11.1.tar.gz: OK
```

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

Например:

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

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

Astra Linux
РЕД ОС

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

directory-service
├── installer # Инсталлятор
│   ├── 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.7.0
│   │   └── dsm_2.7.0-1_amd64.deb
│   ├── inno-samba-1.11.1
│   │   ├── inno-samba_1.11.1_amd64.deb
│   │   ├── libgnutls30_3.6.16_amd64.deb
│   │   └── liblmdb0_0.9.21-1-inno-18_amd64.deb
│   └── inno-samba-dc-exporter-1.7.3
│       ├── inno-samba-dc-exporter_1.7.3_amd64.deb
│       └── python3-prometheus-client_0.18.2_amd64.deb
│
├── reports # Отчеты Allure по результатам тестирования
│   ├── elles-1.11.1-dsm-2.7.0-auth-functional.pdf # Отчет по DSM Auth
│   ├── elles-1.11.1-dsm-2.7.0-dat-functional.pdf # Отчет по DSM DAT
│   ├── elles-1.11.1-dsm-2.7.0-dnsm-functional.pdf # Отчет по DSM DNSM
│   ├── elles-1.11.1-dsm-2.7.0-gpm-functional.pdf # Отчет по DSM GPM
│   ├── elles-1.11.1-dsm-2.7.0-uac-functional.pdf # Отчет по DSM UAC
│   ├── elles-1.11.1-dsm-2.7.0.pdf # Отчет по DSM
│   ├── elles-1.11.1-elles-1.11.1-functional.pdf # Отчет по функц. тестам Эллес
│   └── elles-1.11.1-elles-1.11.1-performance.pdf # Отчет по тестам произв. Эллес
│
├── docs # История изменений в продукте и документация
│   ├── installer-1.0.5 # Документация на роли 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
│   ├── MetricsExporter-AdminGuide-Ru.pdf
│   └── ReleaseNotes.md # История изменений в продукте
│
└── ReleaseNotes.md # История изменений в продукте

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

directory-service
├── installer # Инсталлятор
│   ├── 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.7.0
│   │   └── dsm_2.7.0-1.x86_64.rpm
│   ├── inno-samba-1.11.1
│   │   └── inno-samba_1.11.1-1.x86_64.rpm
│   └── samba-dc-exporter-1.7.3
│       ├── samba-dc-exporter_1.7.3-1.noarch.rpm
│       └── python3-prometheus-client_0.18.2-1.x86_64.rpm
│
├── docs # История изменений в продукте и документация
│   ├── installer-1.0.5 # Документация на роли 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
│   ├── MetricsExporter-AdminGuide-Ru.pdf
│   └── ReleaseNotes.md # История изменений в продукте
│
└── ReleaseNotes.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