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