Внешняя интеграция (Service Connection)

Для поддержки ресурсов (ВМ и кластера Kubernetes) в инфраструктуре подключите облачные проекты VK Cloud или VK Private Cloud как внешнюю интеграцию (Service Connection).

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

• Управление внешними интеграциями доступно администратору VK Dev Platform и пользователям с ролями teamlead и devops (подробнее — в разделе Права и учетные записи пользователей).
• Для настройки внешней интеграции VK Dev Platform с VK Private Cloud используется сервисная учетная запись, при интеграции с VK Cloud — персональная учетная запись. Чтобы получить учетную запись, обратитесь к администратору VK Cloud или VK Private Cloud.
• Для интеграции с VK Cloud требуется токен Hoe — сервисный токен для авторизации в облачном сервисе Hoe. При интеграции с VK Private Cloud токен Hoe не используется.
• VK Dev Platform поддерживает интеграцию только с одним экземпляром VK Cloud.

1. Обратитесь в техническую поддержку VK Cloud, чтобы получить токен Hoe.

2. Настройте использование токена Hoe по инструкции в документе Руководство по установке VK Dev Platform в разделе Подготовка к установке → Дополнительные настройки → Настройка интеграции с внешними системами.

3. Убедитесь, что токен корректно работает: в логах не должно быть сообщения VK Cloud Public service token is invalid.

4. Настройте мониторинг состояния токена Hoe.

   VK Dev Platform проверяет валидность и срок действия токена Hoe с периодичностью раз в сутки. Если до окончания срока действия токена остается менее 30 дней, срок действия истек или токен невалиден, в логах отобразится одно из сообщений уровня WARN:

   • VK Cloud Public service token will expire in N days — до окончания срока действия токена осталось N дней.
   • VK Cloud Public service token has expired — срок действия токена истек.
   • VK Cloud Public service token is invalid — токен невалиден.

   Чтобы интеграция VK Dev Platform с VK Cloud работала без сбоев, отслеживайте появление этих сообщений в системном логе и своевременно обновляйте токен Hoe.

Подробнее о добавлении, редактировании и удалении внешних интеграций — в документе Руководство пользователя VK Dev Platform в разделе Внешние интеграции.

Когда в логах появилось сообщение о скором истечении срока действия токена Hoe или о том, что срок истек:

1. Обратитесь в техническую поддержку для получения нового токена Hoe.
2. Настройте использование нового токена Hoe по инструкции в документе Руководство по установке VK Dev Platform в разделе Подготовка к установке → Дополнительные настройки → Настройка интеграции с внешними системами.
3. Убедитесь, что новый токен корректно работает: в логах не должно быть сообщения VK Cloud Public service token is invalid.