Paso 3: Crea un grupo de entorno

Apigee en la consola de Cloud

Para crear un entorno en Apigee en la consola de Cloud, sigue estos pasos:

1. Abre la interfaz de Apigee en la consola de Cloud en un navegador.
2. En el panel de navegación de la izquierda, seleccione Gestión > Entornos.
3. En el panel Entornos, haz clic en + Crear entorno.
4. En el panel Crear un entorno, introduce lo siguiente:

   • Nombre: el nombre del entorno programático. El nombre no se puede cambiar una vez creado.

     El nombre debe tener entre 2 y 32 caracteres, que pueden ser letras en minúscula, números o guiones. El nombre debe empezar por una letra y no puede acabar en guion. El nombre debe ser diferente de cualquier otro nombre de entorno de tu organización.

   • Nombre visible: el nombre del entorno que se muestra en la interfaz de usuario.
   • Descripción: opcional. Descripción del entorno.
   • Instancia: deja el campo Instancia en blanco. Las instancias no se aplican a las instalaciones de Apigee Hybrid.
   • Grupo del entorno: deja el campo Grupo del entorno en blanco por ahora. Creará un grupo de entornos en el siguiente procedimiento.
   • Tipo de despliegue: en la mayoría de las instalaciones de Apigee Hybrid, seleccione la opción para desplegar proxies de API individuales. También puedes desplegar un archivo de tu entorno de configuración del proxy de API. Para obtener más información, consulta Tipos de implementaciones admitidos.
5. Haz clic en Crear.

Una vez completado el proceso, el nuevo entorno se mostrará en la tabla del panel Entornos.

UI clásica 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 cuenta propietaria del proyecto de Google Cloud que estés usando para instalar Apigee hybrid. A continuación, haz clic en Permitir.

El navegador va a la página de destino principal de la interfaz de usuario:



2. 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:

   

3. Haga clic en Administrar > Entornos > Resumen.

   

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

4. Haz clic en +Entorno.

   Se muestra el cuadro de diálogo Nuevo entorno:

   

5. 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".
6. Mantén los demás valores predeterminados y haz clic en Crear.

   Apigee crea el nuevo entorno.

   Ahora debe crear un grupo de entornos y añadir su nuevo entorno al grupo.

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:

   Sin residencia de datos

   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"

   Residencia de datos

   curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json"   -d '{
       "name": "'"$ENV_NAME"'"
     }'   "https://$CONTROL_PLANE_LOCATION-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:

   Sin residencia de datos

   curl -H "Authorization: Bearer $TOKEN" \
             "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

   Residencia de datos

   curl -H "Authorization: Bearer $TOKEN" \
             "https://$CONTROL_PLANE_LOCATION-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"
   ]

Apigee en la consola de Cloud

Para crear un grupo de entornos en Apigee en la consola de Cloud, sigue estos pasos:

1. Abre la interfaz de Apigee en la consola de Cloud en un navegador.
2. En el panel de navegación de la izquierda, seleccione Gestión > Entornos.
3. En el panel Entornos, selecciona Grupos de entornos.
4. Haz clic en + Crear grupo de entornos.
5. Introduce lo siguiente:
   • Nombre del grupo de entornos: nombre del grupo de entornos. El nombre debe empezar y terminar con un carácter alfanumérico. Puede tener hasta 63 caracteres alfanuméricos y guiones. El nombre debe ser diferente de cualquier nombre de grupo de entornos que ya exista en tu organización.

   • Nombres de host: lista de nombres de host que se pueden usar para llamar a proxies. Cada nombre de host debe estar en una línea independiente.

     También puedes hacer clic en Configurar el balanceador de carga de Google con estos dominios. Se abrirá la página Balanceo de carga en la consola de Google Cloud , donde podrás configurar el balanceo de carga para los nombres de host.

   • Entornos: lista opcional de entornos que se incluirán en el grupo del entorno.
6. Haz clic en Crear.

UI clásica 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.

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

2. 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.
3. Haga clic en Administración > Entornos > Grupos.

   Se muestra la vista Información general de grupos de entornos:

   

4. Haz clic en + Grupo de entornos.

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

   

5. Escribe un nombre y haz clic en Añadir.

6. Coloca el cursor sobre el grupo de entornos que acabas de crear y haz clic en Editar edit.

   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.

   También puedes configurar un balanceador de carga para el dominio. Para obtener más información sobre los balanceadores de carga, consulta la descripción general de Cloud Load Balancing.

   

7. Haz clic en Añadir (+) en el cuadro Entornos.
8. Se muestra el cuadro de diálogo Añadir entorno.

   

9. Selecciona un entorno de la lista y haz clic en Añadir.
10. Haz clic en Guardar.

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:

   Sin residencia de datos

   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"
       

   Residencia de datos

   curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
      -d '{
        "name": "'"$ENV_GROUP"'",
        "hostnames":["'"$DOMAIN"'"]
      }' \
      "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"
       

4. Asigna el entorno al nuevo grupo:

   Sin residencia de datos

   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"
       

   Residencia de datos

   curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
      -d '{
        "environment": "'"$ENV_NAME"'",
      }' \
      "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"
       

5. Comprueba si el grupo de entornos se ha creado correctamente con el siguiente comando CURL:

   Sin residencia de datos

   curl -H "Authorization: Bearer $TOKEN" \
     "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"

   Residencia de datos

   curl -H "Authorization: Bearer $TOKEN" \
     "https://$CONTROL_PLANE_LOCATION-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 con el siguiente comando CURL:

   Sin residencia de datos

   curl -H "Authorization: Bearer $TOKEN" \
     "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"

   Residencia de datos

   curl -H "Authorization: Bearer $TOKEN" \
     "https://$CONTROL_PLANE_LOCATION-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"
               }
             ]
           }