Antes de instalar y configurar el conector, debes aprovisionar el centro de APIs y crear los recursos necesarios en el proyecto de Google Cloud:
Aprovisionamiento del Centro de APIs
- Crea un proyecto de Google Cloud: Si no tienes uno, crea un proyecto de Google Cloud nuevo con la consola o gcloud CLI. Asegúrate de que estén configurados todos los parámetros de configuración relacionados con la facturación. Para obtener más información, consulta Cómo crear un proyecto de Google Cloud.
- Provision API Hub: Habilita las APIs del centro de APIs y sigue el flujo de aprovisionamiento con la IU de Google Cloud. Habilita los derechos y los complementos necesarios para procesar los metadatos y los eventos de tiempo de ejecución.
Creación de complementos
En este paso, se configura una cuenta de servicio y se registran tus organizaciones de Apigee Edge para la nube privada en el centro de APIs.
- Crea una cuenta de servicio: Crea una nueva cuenta de servicio de Google Cloud en tu proyecto del cliente. El conector de Apigee API Hub para Private Cloud usará esta cuenta de servicio para escribir metadatos de la API y datos del entorno de ejecución en API Hub. Para obtener más información, consulta Crea cuentas de servicio.
Crea una instancia de complemento en el concentrador de APIs
- Registra organizaciones de Apigee Edge para la nube privada:
Registra una o más organizaciones de Apigee Edge para la nube privada en el concentrador de API. Cada instancia del complemento solo puede admitir una organización. Por lo tanto, si necesitas incorporar varias organizaciones, deberás crear instancias de complementos independientes para cada una de ellas. Esto se puede hacer a través de la IU del centro de APIs o con una solicitud a la API.
- Configuración de la cuenta de servicio:
Durante la creación de la instancia del complemento, debes proporcionar la cuenta de servicio que creaste en el paso anterior. El conector de Apigee API Hub para Private Cloud usará la cuenta de servicio para escribir metadatos de la API y datos de tiempo de ejecución en API Hub.
- Topologías posibles para varias organizaciones::
- Opción 1: Cuentas de servicio separadas por organización: Para cada organización, crea una cuenta de servicio dedicada. Cada instancia del complemento se vinculará a su respectiva cuenta de servicio. En este caso, la cuenta de servicio de suplantación de identidad de la clave necesitará permisos para generar claves en nombre de cada cuenta de servicio individual.
- Opción 2: Una sola cuenta de servicio para varias organizaciones: Si prefieres una configuración más simple, puedes usar una cuenta de servicio para todas las organizaciones. Este método simplifica la configuración, ya que todas las organizaciones compartirán la misma cuenta de servicio. Sin embargo, este enfoque significa que los cambios en la cuenta de servicio (como la rotación de claves) afectarán a todas las organizaciones conectadas a ella.
- Cómo controlar varias instancias de Apigee Edge para la nube privada: Si tu configuración incluye varias instancias de Apigee Edge para la nube privada, se aplican los mismos principios. Para cada instancia de Apigee Edge para la nube privada, necesitarás una instancia de complemento independiente para cada organización. Puedes realizar una de las siguientes acciones:
- Usar cuentas de servicio separadas para cada instancia de Apigee Edge para nubes privadas
- Usa una sola cuenta de servicio para varias instancias de Apigee Edge para la Nube privada, según la topología elegida.
Una vez que se cree correctamente la instancia del complemento, haz lo siguiente:
Después de crear la instancia del complemento, recibirás la siguiente información clave necesaria para configurar el conector de Apigee API Hub para Private Cloud:
- Tema de Pub/Sub de datos de tiempo de ejecución: Es un tema de Pub/Sub para subir datos de tiempo de ejecución (análisis) de la API.
- Tema de Pub/Sub de metadatos: Es un tema de Pub/Sub para subir metadatos de la API.
- ID de instancia del complemento: Es un identificador único para tu puerta de enlace de Apigee Edge para la nube privada, con el formato
projects/PROJECT_ID/locations/LOCATION/plugins/PLUGIN_ID/instances/INSTANCE_ID.