Antes de instalar e configurar o conector, provisione o hub de API e crie os recursos necessários no projeto do Google Cloud:
Provisionamento do hub de APIs
- Crie um projeto do Google Cloud: se você não tiver um, crie um novo usando o console ou a CLI gcloud. Verifique se todas as configurações relacionadas ao faturamento estão configuradas. Para mais informações, consulte Criar um projeto do Google Cloud.
- Provisionar o hub da API: ative as APIs do hub da API e siga o fluxo de provisionamento usando a interface do Google Cloud. Ative os direitos e complementos necessários para processar metadados/eventos de tempo de execução.
Criação de plug-ins
Esta etapa envolve a configuração de uma conta de serviço e o registro das organizações do Apigee Edge para nuvem privada no API Hub.
- Crie uma conta de serviço: crie uma conta de serviço do Google Cloud no projeto do cliente. Essa conta de serviço será usada pelo conector do Apigee API Hub para nuvem privada para gravar metadados de API e dados de tempo de execução no API Hub. Para mais informações, consulte Criar contas de serviço.
Criar uma instância de plug-in no hub de API
- Registrar organizações do Apigee Edge para nuvem privada:
Registre uma ou mais organizações do Apigee Edge para nuvem privada no hub de APIs. Cada instância de plug-in só pode oferecer suporte a uma organização. Portanto, se você precisar integrar várias organizações, crie instâncias separadas do plug-in para cada uma delas. Isso pode ser feito na interface do Hub de APIs ou usando uma solicitação de API.
- Configuração da conta de serviço:
Durante a criação da instância do plug-in, você precisa fornecer a conta de serviço criada na etapa anterior. A conta de serviço será usada pelo conector do Apigee API Hub para nuvem privada para gravar metadados de API e dados de tempo de execução no API Hub.
- Topologias possíveis para várias organizações:
- Opção 1: contas de serviço separadas por organização: para cada organização, crie uma conta de serviço dedicada. Cada instância de plug-in será vinculada à respectiva conta de serviço. Nesse caso, a conta de serviço de representação de chave vai precisar de permissões para gerar chaves em nome de cada conta de serviço individual.
- Opção 2: uma única conta de serviço para várias organizações: se você preferir uma configuração mais simples, use uma conta de serviço para todas as organizações. Esse método simplifica a configuração, já que todas as organizações compartilham a mesma conta de serviço. No entanto, essa abordagem significa que as mudanças na conta de serviço (como a rotação de chaves) vão afetar todas as organizações conectadas a ela.
- Como lidar com várias instâncias do Apigee Edge para nuvem privada: se sua configuração incluir várias instâncias do Apigee Edge para nuvem privada, os mesmos princípios serão aplicados. Para cada instância do Apigee Edge for Private Cloud, você vai precisar de uma instância de plug-in separada para cada organização. Você pode fazer o seguinte:
- Use contas de serviço separadas para cada instância do Apigee Edge para nuvem privada ou
- Use uma única conta de serviço para várias instâncias do Apigee Edge para nuvem privada, dependendo da topologia escolhida.
Após a criação bem-sucedida da instância do plug-in:
Depois de criar a instância do plug-in, você vai receber as seguintes informações importantes necessárias para configurar o conector do Apigee API Hub para nuvem privada:
- Tópico de publicação/assinatura de dados de tempo de execução: um tópico de publicação/assinatura para fazer upload de dados de tempo de execução da API (análise).
- Tópico de publicação/assinatura de metadados: um tópico de publicação/assinatura para fazer upload de metadados da API.
- ID da instância do plug-in: um identificador exclusivo do gateway do Apigee Edge para nuvem privada, no formato
projects/PROJECT_ID/locations/LOCATION/plugins/PLUGIN_ID/instances/INSTANCE_ID.