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