В этом документе приведены подробные инструкции по настройке и конфигурированию коннектора Apigee API hub для частного облака и API hub, который обеспечивает передачу метаданных API и аналитики времени выполнения из вашей установки Apigee Edge для частного облака в API Hub Google Cloud.
Интеграция Apigee Edge для частного облака и API Hub предназначена для подключения локальных сред Apigee к API Hub от Google Cloud. Благодаря этой интеграции метаданные API (например, определения прокси-серверов API, правила и т. д.) и данные аналитики времени выполнения из ваших установок Apigee для частного облака передаются непосредственно в API Hub, что позволяет получить централизованное и полное представление о ваших API.
Обзор
Интеграция позволяет пользователям Apigee для частного облака добавлять информацию об API в API Hub. Это означает, что вы можете использовать возможности API Hub для обнаружения, управления и централизованного администрирования API, созданных в локальных развертываниях Apigee.
Основные компоненты
- Центр API (Google Cloud). Централизованная облачная платформа, на которой консолидируются и управляются метаданные API и данные времени выполнения.
- Коннектор Apigee Hub – новый компонент, который устанавливается вместе со средой Apigee Edge для частного облака. Этот коннектор – основной агент, отвечающий за извлечение данных из Apigee Edge для частного облака и их безопасную публикацию в Google Cloud.
- Обработчики сообщений (MP). Существующие компоненты Apigee, которые перенастроены на запись данных аналитики времени выполнения в общую сетевую файловую систему (NFS), чтобы они были доступны для коннектора Apigee API Hub.
- Сетевая файловая система (NFS). Общий том хранилища, используемый для временного хранения данных аналитики от процессоров сообщений до того, как коннектор Apigee API Hub обработает и загрузит их.
- Google Cloud Pub/Sub. Сервис обмена сообщениями, используемый коннектором Apigee API Hub для частного облака для безопасной передачи метаданных API и данных времени выполнения в API Hub.
- Сервисные аккаунты Google Cloud. Используются для безопасной аутентификации и авторизации коннектора Apigee API Hub для частного облака при взаимодействии с сервисами издатель-подписчик и API Hub.
Процесс интеграции
Интеграция выполняется в несколько этапов, чтобы обеспечить передачу данных и их точность:
- Первоначальная настройка и инициализация
- Для начала создайте проект Google Cloud и подготовьте в нем API Hub.
- Создайте сервисные аккаунты Google Cloud и зарегистрируйте организации Apigee для частного облака в API Hub, создав экземпляры плагинов. На этом этапе вы получите уникальные темы издателя-подписчика и идентификаторы экземпляров плагинов, необходимые для настройки.
- Apigee API hub для установки коннектора Private Cloud:
- Коннектор Apigee API Hub для частного облака, пакет RPM, устанавливается на выделенной виртуальной машине вместе со средой Apigee для частного облака. Для этого требуется совместимая версия Apigee для частного облака.
- Центр API Apigee для настройки коннектора частного облака:
- Коннектор настраивается с помощью данных, полученных при создании плагина API Hub (темы издатель-подписчик, идентификаторы экземпляров плагина, сведения о сервисном аккаунте).
- Устанавливается аутентификация как в сервисах Google Cloud (с помощью ключей сервисного аккаунта), так и на сервере управления Apigee (с помощью учетных данных в кодировке Base64).
- Здесь также настраивается путь к общему NFS.
- Конфигурация процессора сообщений:
- Ваши процессоры сообщений Apigee обновлены, чтобы включить механизм двойной записи для данных аналитики. Это означает, что записи аналитики сохраняются как в традиционной системе аналитики, так и в указанном ресурсе NFS.
- Поток данных:
- Метаданные API. Коннектор Apigee API hub для Private Cloud извлекает метаданные API с сервера управления Apigee и публикует их в указанной теме издателя-подписчика метаданных в Google Cloud, откуда они передаются в API hub.
- Данные времени выполнения. Процессоры сообщений записывают данные аналитики в общую NFS. Коннектор Apigee Hub отслеживает эту NFS, обрабатывает данные среды выполнения и публикует их в указанной теме издателя-подписчика среды выполнения данных в Google Cloud для загрузки в API Hub.
- Мониторинг и устранение неполадок:
- Локальная конечная точка статуса в центре API Apigee для коннектора Private Cloud позволяет отслеживать ход загрузки метаданных и данных времени выполнения.
- Подробные журналы доступны для устранения неполадок, связанных с запуском, передачей данных или подключением.
Взаимозависимости:
- Коннектор Apigee API Hub для частного облака зависит от того, правильно ли смонтирована и доступна ли NFS для него и всех процессоров сообщений.
- Чтобы включить сбор данных во время выполнения, необходимо настроить процессоры сообщений для двойной записи в NFS.
- Для аутентификации коннектора и публикации данных необходимы правильные роли сервисного аккаунта Google Cloud и сведения об экземпляре плагина API Hub.
Эта интеграция позволяет перенести локальные API Apigee в централизованную систему управления и мониторинга API Hub, что повышает эффективность управления API и позволяет получать более точные данные.