Skip to main content

Как создать приложение с нуля

Шаг 1. Настройте права в тенанте​

Тенант — сущность, которая объединяет ресурсы разработки. Скорее всего он уже есть у вашей команды, и вам не нужно ничего создавать.

1. Найдите тенант​

  1. Перейдите в Spirit.
  2. Нажмите Выбрать тенант или название тенанта в правом верхнем углу.
  3. Найдите тенант с помощью поиска.

2. Получите роли​

info

Изучите список ролей и назначьте все необходимые роли на группу или пользователя

Роль — это набор прав, которые назначают пользователю. Подробности.

Если вы сами создали тенант, у вас роль Project Lead в нём.

Если не вы создали тенант и у вас нет ролей

Если её ещё не выдали:

  1. Нажмите Управление → Участники и роли в левом меню.
  2. Найдите участника с ролью Project Lead и попросите его выдать её вам.

Шаг 2. Настройте репозиторий​

Создавайте, редактируйте и удаляйте репозитории только в интерфейсе Spirit.

Репозиторий — это проект на Gitlab, в котором хранится код проекта. Скорее всего у вашей команды уже есть репозитории, в которых вы будете работать.

1. Создайте репозиторий​

Как создать репозиторий

Пример карточки репозитория в Spirit

caution

По умолчанию все репозитории публичные. Код будет доступен всем пользователям платформы Spirit. Если вы не хотите публиковать код своего сервиса:

2. Настройте политики​

Политики в Gitlab — это ограничения, которые помогают обезопасить ваш проект. Например, с помощью политики approvers вы можете выбирать, кто из пользователей может согласовать merge request.

Как настроить политики

Рекомендуем первым делом настроить:

Когда создаётся репозиторий, наши политики в Gitlab добавляют в него файлы:

3. Настройте переменные CI/CD​

О переменных, как и зачем их создавать

4. Настройте конвейер сборки CI/CD​

Документация Gitlab про пайплайны

5. Настройте инфраструктуру сборки​

Инфраструктура сборки в Gitlab

Шаг 3. Зарегистрируйте приложения в каталоге сервисов​

Что такое каталог сервисов

Для этого создайте в репозитории файл с именем service.yaml и не забудьте указать

  • env-переменные, если есть
  • imageStream в формате <docker-registry>/<tenant>/<repo>
  • порт для метрик (если порт для метрик и приложения совпадает, оставьте только метрики)
  • пробы

Пример файла - service.yaml. Как заполнять

important

  1. Чтобы в каталоге ПО появилась версия сервиса, тег должен быть создан на ветке master и соответствовать маске release-*.

  2. docker-registry:

  • acr.polygon.t-technologies.ru - адрес для работы локально и из CI/CD, указывается в imageStream в service.yaml

Шаг 4. Настройте работу с артефактами​

  1. Создайте сервис-аккаунт.
  2. Настройте локальное окружение Artifactory.
  3. Соберите Docker-образ сервиса средствами ci/cd или локально
    • ❗ укажите релизный тег, который совпадает с тегом на ветке master
    • ❗ при билде образа локально укажите платформу linux --platform=linux/amd64
  4. Опубликуйте образ в Container Registry acr.polygon.t-technologies.ru, выполнив push

Шаг 5. Создайте релизный тег​

Создайте тег с именем release-* на ветке master. Тег должен совпадать с тегом docker-образа.

Шаг 6. Создайте базу данных, если она нужна вашему приложению​

  1. Как создать инстанс БД
  2. Укажите БД в сетевых доступах при создании компонента приложения на Шаге 7

Шаг 7. Задеплойте приложение​

Как задеплоить приложение