1. Общие сведения о программе
1.1. Обозначение и наименование программы
Полное наименование: «Типовое тиражируемое программное обеспечение Витрина данных НСУД».
Условное обозначение: ПО «Витрина данных».
1.2. Назначение программы
Национальная система управления данными (далее – НСУД) представляет собой систему, состоящую из взаимосвязанных элементов информационно-технологического, организационного, методологического, кадрового и нормативно-правового характера и обеспечивающую достижение целей и выполнение задач, обозначенных в Концепции Национальной системы управления данными, утвержденной распоряжением Правительства Российской Федерации от 3 июня 2019 года № 1189-р.
НСУД предназначена для управления информацией, содержащейся в информационных системах органов и организаций государственного сектора, а также в информационных ресурсах, созданных в целях реализации полномочий органов и организаций государственного сектора (далее – государственные данные) и для осуществления информационного обмена между Поставщиками и Получателями данных, присоединившимися к НСУД (далее – Участники НСУД).
Управление процессами информационного обмена между Участниками НСУД осуществляется средствами федеральной государственной информационной системы «Единая информационная платформа Национальной системы управления данными» (далее – ФГИС «ЕИП НСУД»).
Для передачи данных между Участниками НСУД используется среда взаимодействия НСУД, состоящая из Системы межведомственного электронного взаимодействия 3.0 (далее – СМЭВ) и (или) подсистемы обеспечения доступа к данным СМЭВ (далее – ПОДД СМЭВ) (СМЭВ 4.0), обеспечивающих транспорт и процессинг данных, а также агентов ПОДД СМЭВ, устанавливаемых на стороне Участников НСУД.
Для формирования и (или) для получения данных с использованием среды взаимодействия НСУД необходим комплекс программных и технических средств в составе информационно-телекоммуникационной инфраструктуры участника НСУД, описываемое в данном документе «Витрина данных НСУД», но возможно и применение «Витрина данных НСУД». Данный документ описывает применение именно ПО среды взаимодействия НСУД.
Программа «Витрина данных НСУД» является частью НСУД и предназначена для загрузки публикуемых данных в отдельную БД на стороне Поставщика данных. Программа представляет собой типовое программное обеспечение, устанавливаемое на стороне поставщиков/потребителей данных.
1.3. Возможности программы
В настоящий момент реализовано две конфигурации Программы:
Стандарт;
Лайт.
Программа обеспечивает выполнение следующих задач:
описание логической модели данных;
настройка программы и структуры таблиц в ее БД для хранения публикуемых данных;
загрузка и хранение публикуемых данных в БД программы;
извлечение данных из внешних систем (внешних ИС по отношению к Витрине данных НСУД);
выполнение запросов в соответствии с протоколом ПОДД через механизмы ПОДД СМЭВ:
поддержка протокола коммуникации Агента СМЭВ4;
предоставление публикуемых данных (в т. ч. BLOB-объектов и/или с использованием табличных параметров);
генерация формируемых документов на основании публикуемых данных;
репликация публикуемых данных (в качестве витрины-поставщика);
получение реплицируемых данных (в качестве витрины-получателя).
обмен в соответствии с протоколом СМЭВ3:
подключение к СМЭВ3 как информационной системы участника взаимодействия;
обработку запросов на предоставление публикуемых данных (видов сведений), в т.ч. BLOB-объектов;
инициативная рассылка оповещений об обновлении публикуемых данных.
публикация конечных точек API для обработки запросов с использованием спецификации OpenAPI версии 3;
предоставление публикуемых данных информационным системам с использованием интерфейса REST-запросов;
восстановление данных в непротиворечивое состояние после сбоев;
поддержка языка SQL (см. Приложение 2 «Поддержка функций SQL»);
журналирование событий функциональных блоков;
мониторинг информации о работоспособности экземпляра Программы.
Программа обеспечивает выполнение следующих задач:
автоматическая настройка взаимосвязей между компонентами программы;
автоматический запуск всех необходимых компонентов программы после установки;
автоматическая настройка витрины и структуры ее таблиц на основании содержимого XML-файла, загружаемого через пользовательский web-интерфейс;
выгрузка шаблона через графический интерфейс (для упрощения процесса подготовки загружаемых данных);
загрузка данных в витрину:
через графический интерфейс;
REST API;
файловый обмен.
настройка параметров работы витрины через графический интерфейс;
выполнение запросов на предоставление данных в соответствии с протоколом ПОДД через механизмы СМЭВ ПОДД.
1.4. Операционная система
Операционная система устанавливается на сервер, где будет развернута программа.
Программа может функционировать под одной из следующих операционных систем:
CentOS 7.9 (далее - CentOS);
РЕД ОС версии 7.2 (далее - РЕД ОС);
АЛЬТ Сервер 8 СП (далее - АЛЬТ ОС);
Astra Linux 1.7 (уровень защищенности «Воронеж»).
1.5. Рекомендуемые технические и программные средства
В разделе приведены рекомендации по аппаратному и программному обеспечению, а также необходимая конфигурация сети для оптимального баланса между производительностью и стабильностью работы всех компонентов программы.
Рекомендация основана на использовании программы в режиме стандартной рабочей нагрузки на тестовом стенде (см Раздел 9).
Примечание
Следует учитывать, что невозможно дать универсальной рекомендации для развертывания программы т.к. вариантов конфигурации оборудования, характера нагрузки и других факторов может быть очень много. Предварительный расчет параметров оборудования на этапе внедрения для каждой организации должен быть рассчитан индивидуально. Советуем установить программу с приведенными ниже рекомендациями на тестовом стенде для того чтобы определить оптимальную конфигурацию для ваших сценариев работы.
Рекомендуем выполнить следующее:
продумайте сценарии работы с программой необходимые для достижения ваших целей;
установите программу (см. Руководство по установке) на тестовом стенде с рекомендуемыми техническими характеристиками (Таблица 1.4 и Таблица 1.5);
создайте структуру Витрины;
подготовьте тестовые данные для загрузки и определите количество загружаемых данных;
в процессе загрузки данных проведите измерение ключевых параметров нагрузки серверного оборудования;
линейно экстраполируйте эти данные на целевую систему, получив таким образом загруженность целевого оборудования;
выберете оборудование, которое будет соответствовать нагрузке для ваших задач.
Ниже приведены параметры тестового стенда, на котором проверялась работоспособность программы.
Рекомендованные требования к серверному оборудования приведены в Таблица 1.4.
Сервер |
Назначение |
CPU |
RAM, ГБ |
HDD |
Количество |
|---|---|---|---|---|---|
Prostore |
Сервис исполнения запросов |
4 |
8 |
50 |
1 |
BLOB- адаптер |
BLOB- адаптер |
4 |
16 |
50 |
2 |
Сервис формирования документов |
2 |
8 |
50 |
2 |
|
СМЭВ QL Сервер |
4 |
8 |
50 |
1 |
|
СМЭВ3-адаптер |
СМЭВ3-адаптер |
4 |
8 |
50 |
1 |
CSV-Uploader |
4 |
8 |
50 |
1 |
|
СМЭВ4-адаптер - Модуль исполнения запросов |
4 |
8 |
50 |
2 |
|
СМЭВ4-адаптер - Модуль MPPR |
4 |
8 |
50 |
2 |
|
СМЭВ4-адаптер - Модуль MPPW |
4 |
16 |
50 |
2 |
|
СМЭВ4-адаптер - Модуль импорта данных ТП |
2 |
4 |
50 |
2 |
|
СМЭВ4-адаптер - Модуль группировки данных ТП |
2 |
4 |
50 |
2 |
|
СМЭВ4-адаптер - Модуль дефрагментации чанков табличных параметров |
4 |
8 |
50 |
2 |
|
СМЭВ4-адаптер - Модуль подписок |
4 |
8 |
50 |
2 |
|
СМЭВ4-адаптер - Модуль Группировки чанков репликаций |
2 |
4 |
50 |
2 |
|
Data-Uploader |
4 |
8 |
50 |
1 |
|
REST-Uploader |
4 |
8 |
50 |
1 |
|
Counter-provider |
2 |
4 |
50 |
1 |
|
REST-адаптер |
REST-адаптер |
2 |
4 |
50 |
1 |
ETL |
4 |
8 |
50 |
1 |
|
Backup manager |
2 |
4 |
50 |
1 |
|
Arenadata Cluster Manager (ADCM) |
4 |
16 |
200 |
1 |
|
Arenadata Streaming (ADS) |
Apache ZooKeeper |
4 |
4 |
5 |
1 |
Apache Kafka |
4 |
4 |
5 |
2 |
|
Мониторинг и администрирование (установка опциональна) |
Grafana |
32 |
32 |
1000 |
3 |
Prometheus |
|||||
Graylog |
|||||
МongoDB |
|||||
Elasticsearch (master) |
|||||
Elasticsearch (data) |
|||||
Filebeat |
|||||
Node Exporter |
Рекомендованные требования к серверному оборудования приведены в Таблица 1.5.
Требования |
Минимальные |
Рекомендуемые |
|---|---|---|
Процессор (CPU) |
4 ядра |
24 ядра |
Оперативная память (RAM) |
16 Гб |
128 Гб |
Жесткий диск (HDD) |
100 Гб |
500 Гб |
Рекомендованные требования к программному обеспечению приведены в Таблица 1.6.
Название |
Описание |
Версия |
|---|---|---|
Операционная система (выбор опционален) |
CentOS РЕД ОС АЛЬТ Сервер 8 СП Astra Linux 1.7 (уровень защищенности «Воронеж») |
7.9 7.2 8 1.7 |
Docker |
Программное обеспечение для автоматизации развёртывания и управления приложениями |
20.10.2 |
Java SE 17 |
Среда разработки для создания приложений с использованием языка программирования Java |
17.0.7 |
Рекомендованные требования к программному обеспечению приведены в Таблица 1.7.
Название |
Описание |
Версия |
|---|---|---|
Операционная система (выбор опционален) |
CentOS РЕД ОС АЛЬТ Сервер 8 СП Astra Linux 1.7 (уровень защищенности «Воронеж») |
7.9 7.2 8 1.7 |
Docker |
Программное обеспечение для автоматизации развёртывания и управления приложениями |
20.10.2 |
1.6. Компоненты программы
Состав компонентов дистрибутива программы приведен в разделе Состав компонентов в дистрибутиве документа «Техническое описание программы ПО «Витрина данных НСУД»».
2. Подготовка к установке
2.1. Предварительные действия
Примечание
Установка Программы производится в закрытом контуре (без необходимости доступа к сети Интернет).
Установить на серверы одну из поддерживаемых операционных систем (см. раздел Установка операционной системы).
Проверить настройки Firewall и отключить при необходимости (см. раздел Настройка межсетевого экрана).
Выключить SELinux (см. раздел Отключение SELinux (только для CentOS)).
Указать соответствующий местоположению сервера часовой пояс (см. раздел Выбор часового пояса).
Проверить, что на всех серверах установлен сервис синхронизации времени (см. раздел Установка сервиса синхронизации времени).
Проверить, что имена хостов (FQDN) серверов могут получать IP по имени со всех машин (см. раздел Настройка имен хостов (FQDN) на серверах);
Установить/обновить Java SE Development Kit 17.0.7 (см. раздел Установка Java SE Development Kit 17.0.7)
Дополнительно устанавливаются:
компонент сбора данных запросов и ответов Витрины (см. раздел Установка компонента сбора данных запросов и ответов Витрины данных);
сервис журналирования (см. раздел Настройка сервиса журналирования);
подсистему мониторинга (см. раздел Настройка сервиса мониторинга).
Установить на серверы одну из поддерживаемых операционных систем (см. раздел Установка операционной системы).
Создать пользователя datamart с правами
sudo(см. раздел Создание пользователя datamart).Проверить настройки Firewall и отключить при необходимости (см. раздел Настройка межсетевого экрана).
Выключить SELinux (см. раздел Отключение SELinux (только для CentOS)).
Указать соответствующий местоположению сервера часовой пояс (см. раздел Выбор часового пояса).
Настроить SSH-подключение к серверу, на котором планируется установка (см. раздел Подключение к серверу через SSH-клиент PuTTY).
Создать приватный и публичный SSH-ключ для пользователя datamart (см. раздел Создание SSH-ключей).
Скопировать публичный ключ на сервер (см. раздел Копирование SSH-ключей на сервер).
Скопировать архив программы (см. раздел Копирование архива программы).
Установить Docker (см. раздел Установка Docker).
Установить библиотеку python-docker-py (см. раздел Установка библиотеки python-docker-py).
Настроить логирование (см. раздел Настройка логирования в Docker).
Перезапустить Docker (см. раздел Перезапуск Docker).
Добавить пользователя datamart в группу docker (см. раздел Добавление пользователя в группу docker).
Настроить Ansible (см. раздел Настройка Ansible).
2.1.1. Установка операционной системы
Программа может работать на одной из операционных систем:
Centos 7.9;
Astra Linux Special Edition 1.7 (уровень защищенности «Воронеж»);
Alt 8 SP Server;
РЕД ОС, версии 7.2.
Подробная инструкция по установке операционной системы Centos 7.9 приведена на официальном сайте разработчика: https://docs.centos.org/en-US/centos/install-guide/.
Подробная инструкция по установке операционной системы Astra Linux Special Edition 1.7 приведена на официальном сайте разработчика: https://astralinux.ru/products/astra-linux-special-edition/documents-astra-se/
Подробная инструкция по установке операционной системы Alt 8 SP Server приведена на официальном сайте разработчика: https://www.basealt.ru/alt-8-sp-sertifikat-fstehk/docs
Подробная инструкция по установке операционной системы РЕД ОС, версии 7.2 приведена в документе «Руководство администратора по РЕД ОС 7.2»
2.1.2. Создание пользователя datamart
Внимание
Данный пункт только для конфигурации Лайт
Для установки программы конфигурации Лайт рекомендуется создать отдельного пользователя, для этого следует выполнить следующие действия:
создать пользователя datamart;
отключить для пользователя пароль при вызове
sudo(необходимо для автоматической установки);добавление пользователя в группу администраторов
sudo.
2.1.2.1. Создание пользователя
Чтобы создать пользователя datamart и установить для него пароль, выполните команды:
sudo useradd datamart
sudo password for user:
sudo passwd datamart
sudo password for user:
Changing password for user datamart.
New password:
Retype new password:
После успешных действий система выведет сообщение:
passwd: all authentication tokens updated successfully.
2.1.2.2. Отключение пароля
Чтобы отключить пароль sudo для пользователя datamart, надо добавить в настройки (пользователя или группы) директиву
NOPASSWD. Для этого последовательно выполните команду:
sudo visudo
В открывшемся конфигурационном файле, с помощью команд редактора vim
Для CentOS и РЕД ОС
Отредактируйте следующие записи:
datamart ALL=(ALL) NOPASSWD: ALL
Для АЛЬТ ОС
Отредактируйте следующие записи:
# uncomment line
WHEEL_USERS ALL=(ALL) NOPASSWD: ALL
Сохраните изменения и закройте файл.
2.1.2.3. Добавление пользователя в группу администраторов
Чтобы добавить пользователя в группу администраторов, у которых есть права выполнения команды sudo, выполните следующую команду:
sudo usermod -aG wheel datamart
Для проверки вы можете переключиться в учетную запись datamart и вывести список содержимого директории /root, которое обычно
доступно только для пользователя root user:
su -datamart
Password:
sudo ls -la /root
2.1.3. Настройка межсетевого экрана
2.1.3.1. Для CentOS и RedOS
Для корректной установки потребуется отключить службу FirewallD операционной системы CentOS.
Что просмотреть текущий статус работы приложения используйте команду firewall-cmd:
sudo firewall-cmd --state
В случае, если служба FirewallD запущена, команда выше выведет следующее сообщение:
running
Вы можете временно остановить службу FirewallD для этого выполните следующую команду:
sudo systemctl stop firewalld
Следует учитывать, что данная команда только временно отключит службу, при последующей перезагрузке служба FirewallD снова
будет запущена.
Чтобы отключить автоматический запуск службы FirewallD при загрузке операционной системы выполните команду:
sudo systemctl disable firewalld
После отключения проверьте, что статус службы изменился на not running, для этого выполните команду:
sudo firewall-cmd --state
not running
2.1.3.2. Для AltOS
По умолчанию выключен. Никаких действий не требуется.
2.1.4. Отключение SELinux (только для CentOS)
Для корректной установки CentOS необходимо отключить SELinux, для этого выполните следующие действия:
1. Проверьте параметры запуска SELinux при загрузке системы.
Для этого выполните следующую команду:
cat /etc/selinux/config
2. Если параметр SELINUX имеет значение enforcing, отключите запуск SELinux при загрузке системы.
Для этого следует в файле /etc/selinux/config указать значение SELINUX=disabled и перезагрузите сервер. SELinux будет отключен.
Открыть и отредактировать файл /etc/selinux/config можно с помощью редактора Vim, для этого выполните команду:
sudo vi /etc/selinux/config
Проверьте, что служба отключена. Для этого выполните команду
sestatus
В ответ вы должны получить
SELinux status: disabled
2.1.5. Выбор часового пояса
Проверьте, что установлен нужный часовой пояс. В нашем случае, на
команду timedatectl, должна выводиться строка Time zone: Europe/Moscow (MSK, +0300).
Пример команды:
timedatectl
Пример ответа:
Local time: Mon 2021-12-20 12:06:39 MSK
Universal time: Mon 2021-12-20 09:06:39 UTC
RTC time: Mon 2021-12-20 09:06:49
Time zone: Europe/Moscow (MSK, +0300)
NTP enabled: n/a
NTP synchronized: no
RTC in local TZ: no
DST active: n/a
Если результат отличается, укажите соответствующий местоположению сервера часовой пояс.
Пример команды для московского часового пояса:
sudo timedatectl set-timezone Europe/Moscow
2.1.6. Установка сервиса синхронизации времени
Внимание
Данный пункт только для конфигурации Стандарт
Для корректной установки программы необходимо убедиться, что на всех серверах установлен сервис синхронизации времени.
2.1.7. Настройка имен хостов (FQDN) на серверах
Внимание
Данный пункт только для конфигурации Стандарт
Для корректной установки программы необходимо проверить, что имена хостов (FQDN) серверов могут взаимно получать IP по имени со всех машин. Имена хостов меняются согласно документации установленной ОС.
2.1.8. Установка Java SE Development Kit 17.0.7
Внимание
JДанный пункт только для конфигурации Стандарт
Установка Java SE Development Kit 17.0.7 осуществляется согласно официальной документации: https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html
2.1.9. Подключение к серверу через SSH-клиент PuTTY
Внимание
Данный пункт только для конфигурации Лайт
Настройку SSH-подключения к серверу можно выполнить, используя клиент удалённого доступа - PuTTY.
2.1.10. Создание SSH-ключей
Внимание
Данный пункт для конфигурации Лайт
Внимание
В данном разделе описана генерация ключей: приватного и публичного. Приватный ключ использует Ansible для подключения по SSH при выполнении скриптов. Действия этого раздела необходимо выполнять под созданной учетной записью datamart (см. раздел Создание пользователя datamart).
Для переключения на учетную запись datamart выполните команду:
sudo su - datamart
Для подключения Ansible к серверу по протоколу SSH необходимо создать SSH-ключи.
Для аутентификации пользователя на сервере используются два ключа:
приватный;
публичный.
Чтобы сгенерировать SSH-ключи для операционной системы Linux, выполните следующие действия:
Откройте терминал на компьютере и выполните команду:
ssh-keygen -t rsa
Следует оставить все значения по умолчанию.
Примечание
Если команда ssh-keygen не найдена, установите пакет openssh.
После выполнения команды будет предложено указать имена файлов, в которые будут сохранены ключи и ввести пароль для закрытого ключа. По умолчанию используется имя
id_rsa, ключи будут созданы в директории~/.ssh.
Публичная часть ключа будет сохранена в файле с названием <имя_ключа>.pub.
Будет выведено следующее сообщение:
Generating public/private rsa key pair.
Enter file in which to save the key (/home/datamart/.ssh/id_rsa).
Нажмите клавишу Enter. После этого ключ будет сохранен в указанную директорию по умолчанию. Далее вам будет предложено ввести кодовое слово для дополнительной защиты ключа. Вы можете пропустить данный шаг и нажать Enter.
На запрос указать кодовое слово, не вводя его нажмите клавишу Enter.
Процедура создания ключей завершена, ключи сохранены в директории ~/.ssh/ `` в файлах ``id_rsa и id_rsa.pub.
2.1.11. Копирование SSH-ключей на сервер
Внимание
Данный пункт для конфигурации Лайт
Внимание
В разделе описано добавление публичного ключа в список разрешенных, чтобы дать право Ansible на подключение. Действия этого раздела необходимо выполнять под созданной учетной записью datamart (см. раздел Создание пользователя datamart).
Для переключения на учетную запись datamart выполните команду:
sudo su - datamart
Для копирования SSH-ключей в список разрешенных ключей выполните команды:
cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys
2.1.12. Копирование архива программы
Внимание
Данный пункт для конфигурации Лайт
Для загрузки на сервер файла с архивом программы используйте SFTP-клиент (например, WinSCP или Filezilla). Для авторизации используйте логин и пароль учетной записи администратора (datamart) созданной при установке ОС (см. раздел Раздел 2.1.2). Загрузите файл с архивом программы в домашнюю директорию администратора (
~/).Подключитесь по SSH к серверу (см. раздел ssh_connect), используя логин и пароль учетной записи администратора.
Переместите файл с архивом программы в домашнюю директорию пользователя datamart командой:
mv ~/dtm-lite-1.17.1.tgz /home/datamart/
где,
dtm-lite-1.17.1.tgz- название архива программы.datamart- имя пользователя.
Примечание
Обратите внимание, что название и версия файла с архивом может отличаться в зависимости от версии программы.
2.1.13. Распаковка архива
Внимание
Данный пункт для конфигурации Лайт
Внимание
Действия этого раздела необходимо выполнять под созданной учетной записью datamart (см. раздел Создание пользователя datamart).
Для переключения на учетную запись datamart выполните команду:
sudo su - datamart
Чтобы распаковать архив, выполните команду:
tar -xzvf dtm-lite-1.17.1.tgz
Примечание
Обратите внимание, что название и версия файла с архивом может отличаться в зависимости от версии программы.
2.1.14. Установка Docker
2.1.14.1. Установка Docker в CentOS
Внимание
Действия этого раздела необходимо выполнять под созданной учетной записью datamart (см. раздел Создание пользователя datamart).
Для переключения на учетную запись datamart выполните команду:
sudo su - datamart
Полную инструкцию по установке Docker можно просмотреть на официальном сайте разработчиков: https://docs.docker.com/engine/install/centos/.
Приведем описание основных шагов инструкции.
Проверяем, установлен ли Docker командой:
sudo systemctl status docker
Если ответ содержит сообщение:
"Unit docker.service could not be found."
Значит Docker не найден и нужно его установить.
Добавляем *ocker в автозагрузку:
sudo systemctl enable docker
Запускаем Docker:
sudo systemctl start docker
Проверяем работоспособность Docker командой:
sudo systemctl status docker
2.1.14.2. Установка Docker в RedOS
Внимание
Действия этого раздела необходимо выполнять под созданной учетной записью datamart (см. раздел Создание пользователя datamart).
Для переключения на учетную запись datamart выполните команду:
sudo su - datamart
Для установки Docker выполните команду:
sudo yum install docker-ce
Добавляем Docker в автозагрузку:
sudo systemctl enable docker
Запускаем Docker:
sudo systemctl start docker
2.1.14.3. Установка Docker в AltOS
Внимание
Действия этого раздела необходимо выполнять под созданной учетной записью datamart (см. раздел Создание пользователя datamart).
Для переключения на учетную запись datamart выполните команду:
sudo su - datamart
Установить docker можно следующей командой:
sudo apt-get install docker-ce
Удалить сервис containerd:
sudo rm -f /lib/systemd/system/containerd.service
Затем необходимо запустить соответствующую службу:
sudo systemctl unmask docker
sudo systemctl start docker
2.1.15. Установка библиотеки python-docker-py
Внимание
Данный пункт для конфигурации Лайт
Для CentOS
Для установки библиотек python-docker-py выполните следующие команды:
sudo yum install epel-release
sudo yum install python-docker-py
Для РЕД ОС
Для установки библиотек python2-docker выполните следующую команду:
sudo yum install python2-docker
Для АЛЬТ ОС
Внимание
В некоторых версиях «АЛЬТ Сервер 8 СП» (например, АЛЬТ Сервер 8.4 СП) в лицензионный диск с операционной системой не входят пакеты python3-module-docker и python3-websocket-client, поэтому они будут установлены из сертифицированного репозитория компании-разработчика операционной системы, для этого необходим доступ в Интернет!
Для установки выполните следующую команду:
sudo apt-get install python3-module-docker
2.1.16. Настройка логирования в Docker
Внимание
Данный пункт для конфигурации Лайт
Для CentOS и РЕД ОС
Настройка логирования в Docker осуществляется с помощью файла конфигурации. Путь к файлу конфигурации — /etc/docker/daemon.json.
Если этого файла не существует, его необходимо создать.
Добавьте в файл следующие настройки логирования:
{
"log-opts": {
"max-file": "1",
"max-size": "300m"
}
}
где,
max-file- ограничение по количеству файлов (настройки ротации). Максимальное количество файлов журнала, которые могут быть созданы. Если при просмотре журналов создаются лишние файлы, самый старый файл удаляется. Действует только тогда, когдаmax-size(см. ниже) также установлен. Положительное целое число. По умолчанию1.
max-size- устанавливает ограничение по размеру лог-файла (k,mилиg). По умолчанию -1(неограниченно).
Для АЛЬТ ОС
Выполните команду:
sudo sed -i 's/journald/json-file/' /etc/docker/daemon.json
2.1.17. Перезапуск Docker
Внимание
Данный пункт для конфигурации Лайт
Для применения настроек, выполненных на предыдущем шаге необходимо перезапустите Docker.
Для CentOS и РЕД ОС
Выполните команду:
sudo systemctl restart docker
Для АЛЬТ ОС
Выполните команду:
sudo systemctl restart docker
2.1.18. Добавление пользователя в группу docker
Внимание
Данный пункт для конфигурации Лайт
Далее, нужно добавить пользователя datamart в группу docker. Для этого подключитесь к серверу по SSH
(например, через Putty) и выполните команду:
sudo usermod -aG docker datamart
Внимание
Для применения настроек изменения группы выполните повторную авторизацию под пользователем datamart!
2.1.19. Настройка Ansible
Внимание
Данный пункт для конфигурации Лайт
Внимание
Действия этого раздела необходимо выполнять под созданной в учетной записью datamart (см. раздел Создание пользователя datamart).
Для переключения на учетную запись datamart выполните команду:
sudo su - datamart
Для загрузки docker-образа выполните команду:
docker image load -i images/ansible-2.9-centos-7.tar
Чтобы создать alias для вызова Ansible выполните команду:
echo "alias docker-ansible-cmd='docker run --rm -it -v $(pwd)/ansible:/ansible -v ~/.ssh/id_rsa:/root/.ssh/id_rsa --workdir=/ansible registry.gosuslugi.local/dtm-dev/ansible:2.9-centos-7 '" >> .bashrc
. .bashrc
Далее нужно перечитать конфигурационный файл, чтобы применить созданные alias. для этого выполните команду:
source .bashrc
Чтобы проверить установку Ansible в контейнере, выполните команду Ansible, позволяющую вывести номер версии:
docker-ansible-cmd ansible --version