Настройка интеграции облачного шаблона GitLab в Cloud Assembly

Эта процедура позволяет настроить интеграцию GitLab в Cloud Assembly, чтобы можно было работать с облачными шаблонами в репозитории и автоматически загружать сохраненные шаблоны, связанные с указанными проектами. Для доступа к возможностям GitLab при работе с облачными шаблонами необходимо настроить подключение к соответствующему экземпляру GitLab, а затем сохранить нужные шаблоны в этом экземпляре.

Если при настройке интеграции с GitLab используется существующий репозиторий, все облачные шаблоны, связанные с выбранными проектами, становятся доступными пользователям с соответствующими правами. Эти шаблоны можно использовать в существующих развертываниях или в качестве основы для нового развертывания. При добавлении проекта необходимо указать определенные свойства, касающиеся места и способа его хранения в GitLab.

Примечание: Отправка новых или обновленных облачных шаблонов из службы Cloud Assembly в репозиторий Git не поддерживается. Отправка новых шаблонов из службы Cloud Assembly в репозиторий также не поддерживается. Для добавления облачных шаблонов в репозиторий разработчики должны использовать интерфейс Git.

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

После настройки облачных шаблонов для использования с GitLab и сбора обязательных сведений следует настроить интеграцию с экземпляром GitLab. После этого можно импортировать в GitLab указанные облачные шаблоны. Видеоролик с демонстрацией этой процедуры можно посмотреть здесь: https://www.youtube.com/watch?v=h0vqo63Sdgg.

Необходимые условия

• Извлеките ключ API для соответствующего репозитория. Откройте учетную запись GitLab, щелкните имя пользователя в правом верхнем углу и перейдите в меню настроек. Нажмите кнопку «Маркеры доступа», введите имя маркера и задайте срок действия. Затем выберите API и создайте маркер. Скопируйте и сохраните полученное значение.

Для настройки интеграции Git со службой Cloud Assembly требуется наличие соответствующего локального репозитория Git, открытого для доступа всем назначенным пользователям. Кроме того, чтобы платформа GitLab могла распознать облачные шаблоны, они должны быть созданы и сохранены с использованием определенной структуры.

• Убедитесь, что все облачные шаблоны, которые планируется интегрировать с GitLab, настроены и сохранены требуемым образом. В GitLab импортируются только соответствующие требованиям шаблоны. См. раздел Как использовать интеграцию Git в Cloud Assembly.

Процедура

1. Настройте интеграцию со средой GitLab в службе Cloud Assembly.
   1. а. Выберите Инфраструктура > Интеграции > Добавить новый элемент, а затем GitLab.
   2. б. Введите URL-адрес для экземпляра GitLab. Для экземпляров GitLab в формате «программное обеспечение как услуга» данный адрес в большинстве случае будет иметь вид gitlab.com.
   3. в. В поле Маркер введите маркер, также называемый ключом API-интерфейса, для заданного экземпляра GitLab. Дополнительные сведения о получении маркера из экземпляра GitLab см. в приведенных выше требованиях.
   4. г. Введите подходящее имя и описание.
   5. д. Нажмите Проверить, чтобы проверить подключение.
   6. е. При необходимости добавьте теги возможностей. Дополнительные сведения см. в разделе Использование тегов возможностей в Cloud Assembly.
   7. ё. Нажмите кнопку Добавить.
2. Настройте подключение GitLab, чтобы система принимала облачные шаблоны в соответствующем репозитории.
   1. а. Выберите Инфраструктура > Интеграции, а затем соответствующую интеграцию GitLab.
   2. б. Нажмите Проекты.
   3. в. Нажмите Создать проект и введите имя проекта.
   4. г. В поле Репозиторий укажите путь к репозиторию в системе GitLab. Как правило, путь к репозиторию состоит из имени пользователя основной учетной записи и имени репозитория.
   5. д. В поле Ветвь укажите нужную ветвь GitLab, которую требуется использовать.
   6. е. При необходимости введите имя папки. Если оставить это поле пустым, будут доступны все папки.
   7. ё. Введите соответствующий тип в поле Тип. При необходимости введите имя папки. Если оставить это поле пустым, будут доступны все папки.
   8. ж. Нажмите Далее, чтобы завершить процесс добавления репозитория.
      При нажатии кнопки Далее запускается автоматическая синхронизация, которая импортирует облачные шаблоны на платформу.
      После выполнения задач синхронизации появляется сообщение о том, что облачные шаблоны импортированы.

Результаты

Теперь облачные шаблоны можно извлекать из GitLab.