Paso 3: Crea un grupo de entorno

En este paso, crearás un entorno y un grupo de entornos.

En Apigee, los proxies de API se despliegan en entornos, que proporcionan contextos aislados para tus proxies. Los entornos se organizan en grupos de entornos, que proporcionan nombres de host para todos los proxies implementados en los entornos del grupo. Debes tener al menos un entorno y al menos un grupo de entornos. Para obtener más información, consulta el artículo Acerca de los entornos y los grupos de entornos.

Crear entorno

Crea el entorno antes de crear el grupo de entorno. Puedes crear un entorno con la interfaz de usuario de Apigee o con la API. Puede que quieras usar la interfaz de usuario para seguir estos pasos y familiarizarte con ella.

UI de Apigee

Para acceder a la interfaz de usuario y añadir un entorno, sigue estos pasos:

  1. Abre la interfaz de usuario de Apigee. Si es la primera vez que inicias sesión, la pantalla híbrida muestra un cuadro de diálogo de consentimiento. Si se te pide que elijas entre varias cuentas, selecciona la que sea propietaria del proyecto que has creado en el Paso 2: Crea un proyecto de Google Cloud. A continuación, haz clic en Permitir.
  2. El navegador va a la página de destino principal de la interfaz de usuario:

    La página de destino de la interfaz de usuario de Apigee, que consta de un menú de navegación a la izquierda y de imágenes grandes que son enlaces.

  3. Asegúrate de que tu organización esté seleccionada en la lista desplegable de organizaciones. Si no está seleccionado, elija uno de la lista desplegable, como se muestra en el siguiente ejemplo:

    Lista de organizaciones que tienen habilitado el modo híbrido

  4. Haga clic en Administrar > Entornos > Resumen.

    Menú de la interfaz de usuario de Apigee con las opciones Administrar, Entornos y Vista general desplegadas

    Se muestra la vista Entornos, pero aún no hay ninguno:

    La vista Entornos, que está en blanco (no hay entornos)

  5. Haz clic en +Entorno.

    Se muestra el cuadro de diálogo Nuevo entorno:

    Cuadro de diálogo de nuevo entorno

  6. Introduce la siguiente información en el cuadro de diálogo Nuevo entorno:
    1. Nombre visible (obligatorio): nombre descriptivo del entorno que se usa en la interfaz de usuario. Por ejemplo, "Mi primer entorno" o "prueba". A diferencia del nombre del entorno, el nombre visible puede incluir letras mayúsculas y otros caracteres especiales.
    2. Nombre del entorno (obligatorio): nombre programático del entorno, también conocido como ID de entorno.

      Por ejemplo, "my-environment" o "test".

      El Nombre visible y el Nombre del entorno pueden ser diferentes.

    3. Descripción (opcional): información adicional sobre el entorno que quieras añadir como recordatorio de su finalidad. Por ejemplo, "Creado durante la instalación inicial".
  7. Haz clic en Crear.

    Apigee crea el nuevo entorno e indica que está Pendiente de aprovisionamiento:

    Mensaje de estado Pendiente de aprovisionamiento

    En unos instantes, cambiará a aprovisionado:

    Mensaje de aprovisionamiento de un nuevo
    entorno

    Sin embargo, aún no has terminado. También debes añadir tu nuevo entorno al archivo overrides.yaml del tiempo de ejecución, pero primero tienes que instalar el tiempo de ejecución, así que no nos adelantemos.

API de Apigee

Para crear un entorno con la API Create environments, sigue estos pasos:

  1. Abre un terminal en el dispositivo que estés usando para gestionar Apigee.
  2. En la línea de comandos, obtén tus credenciales de autenticación de gcloud con el siguiente comando:

    Linux o macOS

    export TOKEN=$(gcloud auth print-access-token)

    Para comprobar que se ha rellenado el token, usa echo, como se muestra en el siguiente ejemplo:

    echo $TOKEN

    Debería mostrar tu token como una cadena codificada.

    Windows

    for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a

    Para comprobar que se ha rellenado el token, usa echo, como se muestra en el siguiente ejemplo:

    echo %TOKEN%

    Debería mostrar tu token como una cadena codificada.

  3. Crea la siguiente variable de entorno:

    Linux o macOS

    export ENV_NAME="YOUR_ENV_NAME"

    Windows

    set ENV_NAME="YOUR_ENV_NAME"

    Donde:

    • ENV_NAME (Obligatorio) El nombre del entorno puede contener letras minúsculas, guiones y números, y debe empezar por una letra minúscula. Este nombre se usará como identificador y no se podrá cambiar una vez creado el entorno.
  4. Llama a la siguiente API de Apigee:
    curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json"   -d '{
        "name": "'"$ENV_NAME"'"
      }'   "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

    Si la solicitud de creación se realiza correctamente, la API Environments debe responder con un mensaje similar al siguiente:

    {
      "name": "organizations/hybrid-example/operations/c2aee040-7e79-4fd4-b0cf-79ca1b7098a8",
      "metadata": {
        "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
        "operationType": "INSERT",
        "targetResourceName": "organizations/hybrid-example/environments/example-env",
        "state": "IN_PROGRESS"
      }
    }

    Como indica la propiedad state de la respuesta, Apigee ha empezado a crear el nuevo entorno, por lo que su estado es IN_PROGRESS.

  5. Comprueba que el entorno se haya creado correctamente:
    curl -H "Authorization: Bearer $TOKEN" \
              "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

    Si la solicitud de creación se realiza correctamente, la API Environments responde con un mensaje similar al siguiente:

    [
      "your-environment-name"
    ]

Crear un grupo del entorno

Ahora, crea un grupo de entornos y asígnale el entorno que acabas de crear.

UI de Apigee

Para crear un grupo de entornos con la interfaz de usuario de Apigee, sigue estos pasos:

  1. Abre la interfaz de usuario de Apigee.
  2. Tu navegador te lleva a la página de destino principal de la interfaz de usuario de Apigee.

  3. Asegúrate de que tu organización esté seleccionada en la lista desplegable de organizaciones. Si no está seleccionado, elíjalo en la lista desplegable.
  4. Haga clic en Administración > Entornos > Grupos.

    Se muestra la vista Resumen de grupos de entornos, con los grupos de entornos que haya creado:

    La vista Grupos de entornos, que muestra los grupos creados

  5. Haz clic en + Grupo de entornos.

    Se muestra el cuadro de diálogo Añadir un grupo de entornos.

    Cuadro de diálogo Añadir grupo de entornos con el campo Nombre en blanco

  6. Introduce un nombre y haz clic en Añadir.
  7. Coloca el cursor sobre el grupo de entornos que acabas de crear y haz clic en Editar .

    Añade un nombre de host que usarán todos los proxies implementados en entornos de este grupo. Debe ser un dominio al que tengas acceso de gestión. El nombre de host puede ser el propio dominio, como example.com, o puede incluir un subdominio, como my-proxies.example.com.

    Si necesitas registrar un dominio, consulta un registrador de dominios como Google Domains.

  8. Ventana Editar grupo de entornos en la que no se muestra ningún entorno asignado

  9. Haz clic en Añadir (+).
  10. Se muestra el cuadro de diálogo Añadir entorno.
  11. Cuadro de diálogo para añadir un entorno que muestra los entornos disponibles

  12. Selecciona un entorno de la lista y, a continuación, haz clic en Añadir.

API de Apigee

Para crear un grupo de entornos con la API de Apigee, sigue estos pasos:

  1. En la línea de comandos, obtén tus credenciales de autenticación de gcloud con el siguiente comando:

    Linux o macOS

    TOKEN=$(gcloud auth print-access-token)

    Windows

    for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a
  2. Crea las siguientes variables de entorno:

    Linux o macOS

    export DOMAIN="YOUR_DOMAIN"
    export ENV_GROUP="YOUR_ENVIRONMENT_GROUP"

    Windows

     data-terminal-prefix=">">set ENV_GROUP="YOUR_ENVIRONMENT_GROUP"
     data-terminal-prefix=">">set DOMAIN="YOUR_DOMAIN"

    Donde:

    • DOMAIN (Obligatorio) Es el nombre de host que usarán todos los proxies desplegados en entornos de este grupo. Debe ser un dominio que gestiones. La dirección puede ser el propio dominio, como example.com, o puede incluir un subdominio, como my-proxies.example.com. Si no tienes un dominio gestionado, puedes introducir un marcador de posición por ahora. Puedes cambiar la dirección del dominio más adelante.
    • ENV_GROUP (Obligatorio) El nombre del entorno puede contener letras minúsculas, guiones y números, y debe empezar por una letra minúscula. Este nombre se usará como identificador y no se podrá cambiar después de crearse.
  3. Crea el grupo del entorno:
    curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
       -d '{
         "name": "'"$ENV_GROUP"'",
         "hostnames":["'"$DOMAIN"'"]
       }' \
       "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"
        
  4. Asigna el entorno al nuevo grupo:
    curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
       -d '{
         "environment": "'"$ENV_NAME"'",
       }' \
       "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"
        
  5. Verifica si el grupo de entornos se ha creado correctamente con el siguiente comando CURL:
    curl -H "Authorization: Bearer $TOKEN" \ 
          "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"

    Si la solicitud de creación se realiza correctamente, la API Environments Group responde con un mensaje similar al siguiente:

          {
            "environmentGroups": [
              {
                "name": "your_envgroup_hybrid",
                "hostnames": [
                  "apigee.hybrid.com"
                ],
                "createdAt": "1677826235324",
                "lastModifiedAt": "1677826235324",
                "state": "ACTIVE"
              }
            ]
          }
        
  6. Obtén los archivos adjuntos más recientes del grupo de entornos recién creado mediante el siguiente comando CURL:
    curl -H "Authorization: Bearer $TOKEN" \ 
          "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"

    La creación y la asociación del grupo de entornos se han realizado correctamente si el resultado muestra un valor hash único, como se muestra en el siguiente ejemplo de salida de respuesta:

         
            {
              "environmentGroupAttachments": [
                {
                  "name": "c27046d1-b83e-4cba-xxxx-caaa660b2bd6",
                  "environment": "your_envtest_hybrid",
                  "createdAt": "1677826263567",
                  "environmentGroupId": "your_envgroup_hybrid"
                }
              ]
            }
            

Paso siguiente

Para continuar con la instalación, ve a la parte 2: Configuración del entorno de ejecución híbrido.