Este documento fornece instruções detalhadas para configurar o conector do hub de APIs da Apigee para nuvem privada e hub de APIs, o que facilita a transferência de metadados de API e análises de ambiente de execução da instalação do Apigee Edge para nuvem privada para o hub de APIs do Google Cloud.
A integração do Apigee Edge para nuvem privada e do hub de APIs foi projetada para conectar seus ambientes locais da Apigee ao hub de APIs do Google Cloud. Essa integração permite o fluxo contínuo de metadados críticos da API (como definições de proxy de API, políticas etc.) e dados de análise de ambiente de execução das instalações do Apigee para nuvem privada diretamente no hub de APIs, fornecendo uma visão centralizada e abrangente do seu cenário de APIs.
Visão geral
Basicamente, essa integração permite que os usuários do Apigee para nuvem privada incorporem as informações da API ao hub de APIs. Isso significa que você pode aproveitar os recursos do API Hub para descoberta, governança e gerenciamento centralizado de APIs originadas das suas implantações locais da Apigee.
Principais componentes
- Hub de API (Google Cloud): a plataforma central baseada na nuvem em que os metadados e os dados de tempo de execução da API são consolidados e gerenciados.
- Conector do hub do Apigee:um novo componente instalado com o ambiente do Apigee Edge para nuvem privada. Esse conector é o principal agente responsável por extrair dados do Apigee Edge para nuvem privada e publicá-los com segurança no Google Cloud.
- Processadores de mensagens (MPs): componentes atuais da Apigee que são reconfigurados para "gravação dupla" de dados de análise de tempo de execução em um sistema de arquivos de rede (NFS) compartilhado, disponibilizando-os para o conector do hub de APIs da Apigee.
- Sistema de arquivos de rede (NFS): um volume de armazenamento compartilhado usado para armazenar temporariamente dados de análise dos MPs antes que o conector do hub de APIs da Apigee os processe e faça upload.
- Google Cloud Pub/Sub:um serviço de mensagens usado pelo conector do hub de APIs da Apigee para nuvem privada para transmitir com segurança metadados de API e dados de ambiente de execução para o hub de APIs.
- Contas de serviço do Google Cloud:usadas para autenticação e autorização seguras do conector do Apigee API Hub para nuvem privada, que interage com os serviços do Pub/Sub e do API Hub.
O fluxo de integração
A integração segue um processo estruturado para garantir a transferência e a precisão dos dados:
- Configuração e provisionamento iniciais:
- Comece configurando um projeto do Google Cloud e provisionando o hub de APIs nele.
- Crie contas de serviço do Google Cloud e registre suas organizações do Apigee para nuvem privada no API Hub criando "Instâncias de plug-in". Esta etapa fornece tópicos exclusivos do Pub/Sub e IDs de instância do plug-in essenciais para a configuração.
- Instalação do conector do hub de APIs da Apigee para nuvem privada:
- O conector do hub de API do Apigee para nuvem privada, um pacote RPM, é instalado em uma VM dedicada ao lado do ambiente do Apigee para nuvem privada. Isso exige uma versão compatível da Apigee para nuvem privada.
- Configuração do conector do hub de API da Apigee para nuvem privada:
- O conector é configurado com detalhes obtidos durante a criação do plug-in do API Hub (tópicos do Pub/Sub, IDs de instância do plug-in, detalhes da conta de serviço).
- A autenticação nos serviços do Google Cloud (com chaves de conta de serviço) e no servidor de gerenciamento da Apigee (com credenciais codificadas em base64) é estabelecida.
- O caminho para o NFS compartilhado também é configurado aqui.
- Configuração do processador de mensagens (MP):
- Seus processadores de mensagens do Apigee são atualizados para ativar um mecanismo de "gravação dupla" para dados de análise. Isso significa que os registros de análise são gravados no sistema de análise tradicional e no compartilhamento de NFS designado.
- Fluxo de dados:
- Metadados da API:o conector do hub de APIs da Apigee para nuvem privada extrai metadados da API do servidor de gerenciamento da Apigee e os publica no tópico designado do Pub/Sub de metadados no Google Cloud, que então alimenta o hub de APIs.
- Dados de execução:os processadores de mensagens gravam dados de análise no NFS compartilhado. O conector do hub da Apigee monitora esse NFS, processa os dados de ambiente de execução e os publica no tópico do Pub/Sub de dados de ambiente de execução designado no Google Cloud para ingestão no hub de APIs.
- Monitoramento e solução de problemas:
- Um endpoint de status local no conector do hub de APIs da Apigee para nuvem privada permite monitorar o progresso dos uploads de metadados e dados de ambiente de execução.
- Os registros detalhados estão disponíveis para solucionar problemas relacionados à inicialização, transferência de dados ou conectividade.
Interdependências:
- O conector do hub de APIs da Apigee para nuvem privada depende de o NFS estar montado e acessível corretamente por ele mesmo e por todos os processadores de mensagens.
- Os processadores de mensagens precisam ser configurados para gravação dupla no NFS para ativar a coleta de dados de tempo de execução.
- As funções corretas da conta de serviço do Google Cloud e os detalhes da instância do plug-in do hub da API são essenciais para os recursos de autenticação e publicação de dados do conector.
Essa integração oferece um mecanismo robusto para trazer suas APIs Apigee locais para o gerenciamento e a visibilidade centralizados fornecidos pelo hub de APIs, permitindo uma melhor governança e insights de API.