Este documento fornece instruções detalhadas para configurar o conector do API Hub da Apigee para nuvem privada e API Hub, o que facilita a transferência de metadados de API e análises de tempo de execução da sua instalação do Apigee Edge para nuvem privada para o API Hub 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 tempo de execução das instalações do Apigee para nuvem privada diretamente no hub de API, fornecendo uma visão centralizada e abrangente do seu cenário de API.
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 do 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-o para o conector do hub de API do 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 API da Apigee os processe e faça upload.
- Pub/Sub do Google Cloud:um serviço de mensagens usado pelo conector do Apigee API Hub para Private Cloud para transmitir com segurança metadados de API e dados de ambiente de execução para o API Hub.
- Contas de serviço do Google Cloud:usadas para autenticação e autorização seguras do conector do Apigee API Hub para nuvem privada, a fim de interagir 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 hub de APIs da Apigee para o conector do Private Cloud extrai metadados da API do servidor de gerenciamento da Apigee e os publica no tópico do Pub/Sub de metadados designado 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 do Apigee monitora esse NFS, processa os dados de execução e os publica no tópico do Pub/Sub de dados de execução designado no Google Cloud para ingestão no API Hub.
- Monitoramento e solução de problemas:
- Um endpoint de status local no hub de API do Apigee para o conector da 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 Apigee API Hub para nuvem privada depende de o NFS estar montado corretamente e acessível a ele e a 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 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 API Hub, permitindo uma melhor governança e insights de API.