Дистрибутив

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

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

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

  • пакеты компонентов;

  • документацию и файл с описанием истории изменений по версиям продукта (ReleaseNotes.md);

  • роли Ansible для развертывания компонентов.

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

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

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

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

  • package_name — наименование пакета компонента продукта;

  • build_version — версия пакета в соответствии с принципами семантического версионирования (мажорная_версия.минорная_версия.патч-версия);

  • edition — редакция дистрибутива (необязательный элемент);

  • architecture — архитектура;

  • package_type — тип пакета (deb/rpm).

Пример:

inno-samba_1.20.4_amd64.deb
inno-samba-1.20.4-1.x86_64.rpm
dsm_2.20.0-1_amd64.deb
dsm-2.20.0-1.x86_64.rpm

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

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

  • в виде архивов в формате tar.gz, доступных для загрузки из репозитория в https://artifacts.inno.tech;

  • через apt/yum-репозиторий https://artifacts.inno.tech/repository/<client>-<edition>-<type>-packages, где:

    • client — условное обозначение клиента;

    • edition — редакция дистрибутива (astra/redos);

    • type — тип репозитория (apt/yum).

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

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

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

  • файл с публичным ключом для доступа к apt-репозиторию;

  • учетная запись для доступа к apt-репозиторию.

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

  1. Добавьте 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.
  2. Добавьте учетные данные для доступа к apt-репозиторию:

    echo -e "machine  artifacts.inno.tech login <repo_user> password <repo_password>" | sudo tee /etc/apt/auth.conf.d/innotech.conf
  3. Скачайте файл публичного ключа из каталога keys в репозитории <client>-astra-raw-packages и добавьте его:

    sudo apt-key add <client>_astra_signing.key
  4. Обновите пакеты с помощью стандартной команды:

    sudo apt update -y

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

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

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

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

  • ссылка на репозиторий с архивом;

  • учетная запись для доступа к репозиторию.

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

  1. Скачайте архив с deb/rpm-пакетами directory-service-packages-<version>.tar.gz из репозитория.

  2. При необходимости убедитесь в целостности архива, сравнив его контрольную сумму с контрольной суммой в соответствующем файле.

    Например:

    shasum -a 512 -c directory-service-packages-1.20.2.tar.gz.sha512
    directory-service-packages-1.20.2.tar.gz: OK
  3. Создайте временный каталог для распаковки и распакуйте архив:

    Например:

    mkdir directory-service
    tar xvf directory-service-packages-1.20.2.tar.gz -C directory-service

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

    • Astra Linux

    • РЕД ОС

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

    packages
    ├───dsm-2.20.0
    │       dsm_2.20.0-1_amd64.deb
    │
    ├───inno-samba-1.20.4
    │       elles-workstation_1.20.1_amd64.deb
    │       inno-samba_1.20.4_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

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

    packages
    ├───dsm-2.20.0
    │       dsm-2.20.0-1.x86_64.rpm
    │
    ├───inno-samba-1.20.4
    │       inno-samba-1.20.4-1.x86_64.rpm
    │       lmdb-libs-0.9.26.inno_18-1.x86_64.rpm
    │
    └───samba-dc-exporter-1.7.3
            python3-prometheus-client-0.18.2-1.x86_64.rpm
            samba-dc-exporter-1.7.3-1.noarch.rpm

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

    • версии компонентов могут отличаться от версии продукта;

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

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

  5. Обновите списки пакетов с помощью стандартной команды:

    • Astra Linux

    • РЕД ОС

    sudo apt update -y
    sudo dnf update -y