Configurar el sincronizador

En esta sección se describe el sincronizador.

Información general sobre el sincronizador

En Apigee hybrid, la tarea principal del sincronizador es sondear y descargar los contratos de tiempo de ejecución que proporciona el plano de gestión. La información comunicada por contrato incluye proxies de API, productos de API, cachés y hosts virtuales. De forma predeterminada, Synchronizer almacena los datos de configuración del entorno en la base de datos de Cassandra.

Se espera que las instancias de sincronizador que se ejecutan en el plano de tiempo de ejecución sondeen el plano de gestión de forma periódica, descarguen los contratos y los pongan a disposición de las instancias de tiempo de ejecución locales.

Un sincronizador puede admitir muchos procesadores de mensajes implementados en el mismo pod.

Habilitar el acceso del sincronizador

Debe conceder el permiso Sincronizador para descargar artefactos de Apigee, como paquetes de proxy y recursos del plano de gestión. Debes llamar a una API de Apigee para autorizar al sincronizador a extraer artefactos del plano de gestión al plano de ejecución.

1. Asegúrate de que has habilitado la API Apigee tal como se explica en los pasos de configuración de Google Cloud. Para obtener más información, consulta el paso 3: Habilita las APIs.
2. Busca la clave de cuenta de servicio de Google Cloud con permiso de escritura (un archivo JSON) que descargaste en la sección Crear cuentas de servicio. La cuenta de servicio tiene el rol Administrador de la organización de Apigee y se llama "apigee-org-admin". Si no has creado esta cuenta de servicio anteriormente, debes hacerlo antes de continuar.

3. Define la variable de entorno GOOGLE_APPLICATION_CREDENTIALS con la ruta a la ubicación de la clave de cuenta de servicio:

   export GOOGLE_APPLICATION_CREDENTIALS=your_sa_credentials_file.json

4. Llama a la API setSyncAuthorization para habilitar los permisos necesarios para Synchronizer:

   curl -X POST -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type:application/json" \
     "https://apigee.googleapis.com/v1/organizations/your_org_name:setSyncAuthorization" \
      -d '{"identities":["serviceAccount:synchronizer-manager-service-account-name"]}'
   

   Donde:

   • your_org_name: nombre de la organización híbrida.
   • synchronizer-manager-service-account-name: el nombre de una cuenta de servicio con el rol Administrador del sincronizador de Apigee. El nombre tiene el formato de una dirección de correo electrónico. Por ejemplo: my-synchronizer-manager-service_account@my_project_id.iam.gserviceaccount.com

   Ejemplo:

   curl -X POST -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type:application/json" \
     "https://apigee.googleapis.com/v1/organizations/my_org:setSyncAuthorization" \
      -d '{"identities":["serviceAccount:my-synchronizer-manager-service_account@my_project_id.iam.gserviceaccount.com"]}'
   

   Para obtener más información sobre esta API, consulta la API SyncAuthorization.

5. Para verificar que se ha configurado la cuenta de servicio, llama a la siguiente API para obtener una lista de cuentas de servicio:

   curl -X POST -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type:application/json" \
     "https://apigee.googleapis.com/v1/organizations/your_org_name:getSyncAuthorization" \
      -d ''

   El resultado es similar al siguiente:

   {
      "identities":[
         "serviceAccount:my-synchronizer-manager-service_account@my_project_id.iam.gserviceaccount.com"
      ],
      "etag":"BwWJgyS8I4w="
   }