Paso 3: Crea un grupo de entorno

Version 1.16 (latest)

   Versiones compatibles:

• v1.16 (última)                        
• v1.15                         
• v1.14                        
• Lista de versiones admitidas

   Versiones no compatibles:

• v1.13                         
• v1.12                         
• v1.11                         
• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• Versión 1.6                                         
• v1.5                                         
• Versión 1.4                                         
• Versión 1.3                                         
• v1.2                                         
• v1.1                                         

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 crear un entorno en la interfaz de usuario de Apigee, sigue estos pasos:

1. En la interfaz de usuario de Apigee, ve a Gestión > Entornos.

   Ir a Entornos

2. En el panel Entornos, haz clic en + Crear entorno.
3. 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.
     Nota: El tipo de implementación que se usa con este entorno no se puede cambiar una vez creado el entorno.
4. Haz clic en Crear.

Nota: Esta operación para crear el entorno puede tardar hasta cinco minutos.

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

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/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/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 ha 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"
   ]

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 en la interfaz de usuario de Apigee, sigue estos pasos:

1. En la interfaz de usuario de Apigee, vaya a Management > Environments > Environment Groups (Gestión > Entornos > Grupos de entornos).

   Ir a Grupos de entornos

2. Haz clic en + Crear grupo de entornos.
3. 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.

     Nota: Los nombres asignados a un grupo de entornos deben ser únicos en ese grupo. No pueden usarse en otros grupos de entornos.

     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 Cloud, donde podrá configurar el balanceo de carga para los nombres de host.

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

Nota: Esta operación puede tardar hasta cinco minutos.

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/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/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-1234-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.