Trabajar con grupos del entorno

Apigee en la consola de Cloud

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

1. En la Google Cloud consola, ve a la página Gestión > Entornos.

   Ir a Entornos

2. En el panel Entornos, selecciona Grupos de entornos.
3. Haz clic en + Crear grupo de entornos.
4. 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 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.
5. Haz clic en Crear.

Apigee Classic

Para crear un grupo de entornos en la interfaz de usuario clásica de Apigee, sigue estos pasos:

1. En la interfaz de Apigee, selecciona Administrar > Entornos > Grupos.
2. Haga clic en + Grupo de entornos:

   

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

3. Introduce un nombre para el nuevo grupo de entornos:

   

   El nombre solo puede contener letras minúsculas, números y guiones. Además, debe empezar por una letra, tener al menos dos caracteres y no puede acabar en un guion. Los nombres válidos son my-env-group y prod2.

4. Haz clic en Añadir.

   Apigee crea un nuevo grupo de entornos. Suele ser una operación muy rápida.

   Si la operación se realiza correctamente, Apigee confirma que el grupo se ha creado con un banner similar al siguiente:

   

   Apigee también asigna un nombre de host predeterminado al nuevo grupo.

5. (Opcional) Asigna nombres de host adicionales al nuevo grupo haciendo clic en create en ese grupo.

   Apigee muestra el panel Detalles del grupo de entornos:

   

6. Añade nombres de host al campo Nombres de host. Cada nombre de host debe estar en una línea independiente.

7. Haz clic en Guardar cuando hayas terminado.

   Puedes añadir y quitar nombres de host de esta lista en cualquier momento siguiendo el mismo procedimiento.

API de Apigee

Para crear un grupo de entornos con la API de Apigee, envía una solicitud POST a la API Create environment groups. Antes de llamar a la API, asegúrate de tener un token válido, tal como se describe en la sección Obtener un token de acceso OAuth 2.0.

El siguiente comando curl muestra la sintaxis para crear un grupo:

curl -i $TOKEN -X POST \
  https://apigee.googleapis.com/v1/organizations/ORG_NAME/envgroups?name=new-group-name

Cuando especifiques el nombre del nuevo grupo, solo debes usar letras minúsculas, números y guiones (a-z, A-Z y -). No puedes usar letras mayúsculas ni ningún carácter especial que no sea un guion. El nombre también debe empezar por una letra minúscula.

Si no especifica ningún parámetro adicional, este comando crea un grupo sin nombres de host asignados.

También puedes asignar nombres de host al crear el grupo especificándolos como una matriz en el cuerpo de la solicitud.

En el siguiente ejemplo se crea un grupo my-group y se le asignan tres nombres de host nuevos:

curl -i $TOKEN -X POST \
  https://apigee.googleapis.com/v1/organizations/org_name/envgroups?name=my-group \
  -d '{ \
    "hostnames": ["server1.mycompany.com", "server2.mycompany.com", "10.1.142.8"] \
  }'

Puedes cambiar los nombres de host de la lista más adelante enviando una solicitud PATCH a la API Patch environment groups.

Apigee en la consola de Cloud

Para añadir un entorno a un grupo de entornos en la consola de Apigee en Cloud, sigue estos pasos:

1. Crea el entorno tal como se describe en Crear entornos.

2. En la Google Cloud consola, ve a la página Gestión > Entornos.

   Ir a Entornos

3. En el panel Entornos, selecciona Grupos de entornos.
4. En la fila del grupo de entornos, haga clic en more_vert Acciones y seleccione Editar.
5. En el panel Editar grupo de entornos, en Entornos (opcional), seleccione el entorno que quiera añadir al grupo de entornos.
6. Haz clic en Actualizar.

Apigee Classic

Para añadir un entorno a un grupo de entornos en la interfaz de usuario clásica de Apigee, sigue estos pasos:

1. Crea el entorno tal como se describe en Crear entornos.
2. En la interfaz de Apigee, selecciona Administrar > Entornos > Grupos.
3. En Sin asignar, verás una lista de los entornos que no forman parte de ningún grupo de entornos:

   

   Anota los entornos que no estén asignados para asignarlos.

4. Haz clic en create junto al grupo de entornos al que quieras añadir entornos.

   Se muestra el panel Detalles del grupo de entornos:

   

5. Para añadir un nuevo entorno a este grupo, haz clic en + en la lista Entornos.

   Se muestra el panel Añadir entorno:

   

6. Selecciona el entorno que quieras añadir al grupo y haz clic en Añadir.

   Apigee añade el entorno al grupo.

API de Apigee

Para añadir un nuevo entorno a un grupo de entornos mediante la API de Apigee, envía una solicitud POST a la API de adjuntos de grupos de entornos, como se muestra en el siguiente ejemplo:

curl -H "Authorization: Bearer $TOKEN" -X POST
  "https://apigee.googleapis.com/v1/organizations/my-org/envgroups/test-group/attachments"
  -d '{
    "name": "my-attachment",
    "environment": "test"
  }'

Donde:

• $TOKEN se define como tu token de acceso OAuth 2.0, tal como se describe en Obtener un token de acceso OAuth 2.0.
• El cuerpo de la solicitud contiene el nombre del archivo adjunto, así como el nombre del nuevo entorno.

El cuerpo de la solicitud contiene una instancia de un recurso EnvironmentGroupAttachment, que es un envoltorio sencillo de un solo entorno.

Si la solicitud se completa correctamente, la respuesta contiene detalles sobre el nuevo archivo adjunto, incluida la marca de tiempo en la que se creó. Por ejemplo:

{
  "name": "my-attachment",
  "environment": "test"
  "createdAt": "42"
}

Apigee en la consola de Cloud

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

1. En la Google Cloud consola, ve a la página Gestión > Entornos.

   Ir a Entornos

2. En el panel Entornos, selecciona Grupos de entornos.
3. En la fila del grupo de entornos, haga clic en more_vert Acciones y seleccione Editar.
4. En el panel Editar grupo de entornos, en Entornos (opcional), deseleccione el entorno que quiera quitar del grupo de entornos.
5. Haz clic en Actualizar.

Apigee Classic

Para quitar un entorno de un grupo de entornos en la interfaz de usuario clásica de Apigee, sigue estos pasos:

1. En la interfaz de usuario de Apigee, selecciona Administrar > Entornos > Vista general.
2. Selecciona el entorno que quieras quitar.
3. En el panel Grupos, mueve el cursor hasta el final de la fila del grupo del que quieras quitar el entorno y haz clic en .

API de Apigee

Para quitar un entorno de un grupo de entornos mediante la API de Apigee, usa el método delete en el recurso EnvironmentGroupAttachment para eliminar el archivo adjunto correspondiente al entorno.

Apigee en la consola de Cloud

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

1. En la Google Cloud consola, ve a la página Gestión > Entornos.

   Ir a Entornos

2. En el panel Entornos, selecciona Grupos de entornos.
3. En la fila del grupo de entornos, haga clic en more_vert Acciones y seleccione Editar.

Apigee Classic

Para eliminar un grupo de entornos en la interfaz de usuario clásica de Apigee, sigue estos pasos:

1. En la interfaz de Apigee, selecciona Administrar > Entornos > Grupos.
2. Mueve el cursor al panel del grupo que quieras eliminar.
3. Haz clic en el icono .

API de Apigee

Para eliminar un grupo de entornos mediante la API de Apigee, usa el método delete del recurso EnvironmentGroup.

Apigee en la consola de Cloud

Para añadir un nombre de host a un grupo de entornos en la consola de Apigee en Cloud, sigue estos pasos:

1. En la Google Cloud consola, ve a la página Gestión > Entornos.

   Ir a Entornos

2. En el panel Entornos, selecciona Grupos de entornos.
3. En la fila del grupo de entornos, haga clic en more_vert Acciones y seleccione Editar.
4. En el panel Editar grupo de entornos, en Nombres de host, introduce el nombre de host que quieras añadir al grupo de entornos. name you want to add to the environment group.
5. Haz clic en Actualizar.

Apigee Classic

Para añadir un nombre de host a un grupo de entornos en la interfaz de usuario clásica de Apigee, sigue estos pasos:

1. En la interfaz de Apigee, selecciona Administrar > Entornos > Grupos.

2. Coloca el cursor sobre la tarjeta del grupo y selecciona create.

   En el panel Detalles del grupo de entornos se muestra lo siguiente:

   

3. En el campo Nombres de host, introduce los nuevos hosts.
4. Haz clic en Guardar para añadir los nuevos hosts al grupo.

API de Apigee

Para añadir nombres de host a un grupo de entornos mediante la API Apigee, envía una solicitud PATCH a la API Patch environment groups. Asegúrate de definir el parámetro updateMask como hostnames y especifica toda la lista de nombres de host que quieras. El valor de ese campo en tu solicitud sustituye a la lista actual.

En el siguiente ejemplo se definen los nombres de host del entorno de prueba:

curl -H "Authorization: Bearer $TOKEN" -X PATCH
  "https://apigee.googleapis.com/v1/organizations/my-org/envgroups/test-group?updateMask=hostnames"
  -d '{
    "name": "my-hostnames",
    "hostnames": [
      "test-1.example.com",
      "test-2.example.com",
      "test-3.example.com"
    ]
  }'

Donde:

• $TOKEN se define como tu token de acceso OAuth 2.0, tal como se describe en Obtener un token de acceso OAuth 2.0.
• La carga útil de la solicitud especifica un nombre para la matriz de archivos adjuntos de nombres de host, así como la matriz de nombres.

Si la solicitud se ha realizado correctamente, la respuesta contiene un recurso Operation.