Создание сервиса
Подготовка к созданию сервиса
При создании сервиса потребуются:
- шаблонный репозиторий или реально существующий репозиторий, который будет подключен к сервису. Подробнее о регистрации репозиториев.
- зарегистрированная команда, которая будет владельцем сервиса. Подробнее о регистрации команд.
Создание сервиса
1. Перейдите в пункт меню "Сервисы" и нажмите Создать
в правом верхнем углу.
2. Заполните поля "Базовая информация":
- Название — название сервиса, отображается в карточке, должно быть уникальным в рамках EDP.
- Идентификатор — идентификатор сервиса в инфраструктурных сервисах. Должен быть уникальным в рамках EDP. Допустимая длина — от 1 до 63 символов. Может содержать строчные буквы латинского алфавита, цифры и дефисы.
- Описание — описание сервиса.
- Владелец — команда, которая владеет сервисом. Команда должна быть зарегистрирована заранее.
3. Создайте "Сервис". Есть два варианта: создание нового сервиса из шаблона и подключение существующего репозитория.
Создание сервиса из шаблона:
- Включите "Создать сервис из шаблона";
- Выберите "Шаблон" из списка, шаблон должен быть создан заранее;
- При необходимости, выберите другую версию шаблона. В таком случае автообновление шаблона будет отключено.
- При необходимости отключите автообновление шаблона
- Выберите "Группу репозиториев" из списка. В выбранной группе будет создан новый репозиторий. Доступные группы репозиториев определяются исходя из настроек шаблона.
- Проверьте адрес шаблонного репозитория и адрес репозитория сервиса. Адрес репозитория сервиса генерируется автоматически, для этого должен быть выбран владелец сервиса и указано название. Адрес репозитория сервиса станет активным после создания сервиса.
- При необходимости, укажите переменные. Если в поле переменной указано, что она генерируется автоматически, переменную нельзя изменить. Для остальных переменных можно задать значение. Названия переменных неизменяемы и задаются из файла.
- При необходимости задайте переменные окружения, которые будут добавлены в GitLab, в разделе "Project-level CI/CD переменные в GitLab".
Так же при создании сервиса из шаблона можно дополнительно указывать ветки в Git, которые будут созданы в новом репозитории, actions, которые будут выполнены во время создания сервиса, а так же namespaces, в которых планируется развёртывание сервисов, включить или выключить возможность удаления подов сервиса из интерфейса EDP. Указать источник конфигурации Swagger.
Указание namespaces необходимо для работы панели Kubernetes. Подробнее.
В качестве источника конфигурации Swagger можно указать либо репозиторий сервиса, либо указать ссылки на конфигурацию для каждого отдельного окружения. Подробнее.
Пример указания ссылок:
Подробнее в сценарии Создание сервиса из шаблона
Подключение существующего репозитория:
- Отключите "Создать сервис из шаблона";
- Выберите "Существующий репозиторий", который будет привязан к сервису.
Проверка результата
1. Перейдите в пункт меню "Сервисы" и нажмите Открыть на карточке созданного сервиса.
2. Перейдите на вкладку "Операции". Если все значения колонки "Статус" отмечены зеленой галочкой — сервис создан успешно.