Прежде чем устанавливать и настраивать коннектор, вам нужно подготовить API Hub и создать необходимые ресурсы в облачном проекте Google Cloud:
Доступ к API Hub
- Создайте облачный проект Google Cloud: Если у вас его нет, создайте новый облачный проект Google Cloud с помощью консоли или gCloud CLI. Убедитесь, что все настройки, связанные с оплатой, заданы. Подробнее о том, как создать проект Google Cloud…
- Provision API Hub: включите API центра API и выполните процедуру инициализации с помощью интерфейса Google Cloud. Включите права и дополнения, необходимые для обработки метаданных и событий выполнения.
Создание плагинов
На этом этапе нужно настроить сервисный аккаунт и зарегистрировать организации Apigee Edge для частного облака в API Hub.
- Создайте сервисный аккаунт. Создайте новый сервисный аккаунт Google Cloud в проекте клиента. Этот сервисный аккаунт будет использоваться коннектором Apigee API Hub для частного облака, чтобы записывать метаданные API и данные времени выполнения в API Hub. Подробнее о создании сервисных аккаунтов…
Как создать экземпляр плагина в центре API
- Зарегистрируйте организации Apigee Edge для частного облака:
Зарегистрируйте в API Hub одну или несколько организаций Apigee Edge для частного облака. Каждый экземпляр плагина может поддерживать только одну организацию. Поэтому, если вам нужно подключить несколько организаций, создайте для каждой из них отдельный экземпляр плагина. Это можно сделать в интерфейсе API Hub или с помощью запроса к API.
- Настройка сервисного аккаунта
При создании экземпляра плагина необходимо указать сервисный аккаунт, созданный на предыдущем шаге. Сервисный аккаунт будет использоваться коннектором Apigee API Hub для частного облака, чтобы записывать метаданные API и данные времени выполнения в API Hub.
- Возможные топологии для нескольких организаций:
- Вариант 1. Отдельные сервисные аккаунты для каждой организации. Создайте отдельный сервисный аккаунт для каждой организации. Каждый экземпляр плагина будет связан со своим сервисным аккаунтом. В этом случае сервисному аккаунту, выполняющему действия от имени другого аккаунта, потребуются разрешения на создание ключей от имени каждого отдельного сервисного аккаунта.
- Вариант 2. Один сервисный аккаунт для нескольких организаций. Если вы предпочитаете более простую настройку, то можете использовать один сервисный аккаунт для всех организаций. Этот способ упрощает настройку, поскольку все организации будут использовать один и тот же сервисный аккаунт. Однако в этом случае изменения в сервисном аккаунте (например, ротация ключей) повлияют на все организации, связанные с ним.
- Работа с несколькими экземплярами Apigee Edge для частного облака. Если в вашей конфигурации несколько экземпляров Apigee Edge для частного облака, применяются те же принципы. Для каждого экземпляра Apigee Edge для частного облака потребуется отдельный экземпляр плагина для каждой организации. Вы можете:
- Используйте отдельные сервисные аккаунты для каждого экземпляра Apigee Edge для частного облака или
- Используйте один сервисный аккаунт для нескольких экземпляров Apigee Edge для частного облака в зависимости от выбранной топологии.
После успешного создания экземпляра плагина:
После создания экземпляра плагина вы получите следующую ключевую информацию, необходимую для настройки коннектора Apigee API Hub для частного облака:
- Тема Pub/Sub для данных времени выполнения – тема Pub/Sub для загрузки данных времени выполнения API (аналитики).
- Тема публикации/подписки для метаданных – тема публикации/подписки для загрузки метаданных API.
- Идентификатор экземпляра плагина – уникальный идентификатор шлюза Apigee Edge для частного облака в формате
projects/PROJECT_ID/locations/LOCATION/plugins/PLUGIN_ID/instances/INSTANCE_ID.