Paso 8: Implementa y llama a un proxy de muestra

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

Qué se hace en este paso

Sigue los pasos que se indican a continuación para crear y, luego, implementar un proxy de API de prueba. Por último, prueba el proxy de API mediante el envío de una solicitud HTTP.

Crea e implementa un proxy de API

Permisos necesarios para esta tarea

Para implementar y crear proxies se requiere un conjunto mínimo de permisos. Si tienes el rol Apigee Org Admin, puedes completar esta tarea. Para obtener información sobre otros roles que puedes emplear, consulta Roles de Apigee.

El proceso de aprovisionamiento de Apigee no crea ni implementa un proxy de API de forma automática. Debes crear y, luego, implementar un proxy de forma manual.

Nota: Hay una versión nueva de la IU de Apigee, que está integrada en Google Cloud Console. La IU nueva se llama Apigee en la consola de Cloud. En las instrucciones de las dos primeras pestañas a continuación, se explica cómo usar Apigee en la consola de Cloud o la versión clásica de Apigee.

IU de Apigee en la consola de Cloud

Para crear e implementar tu primer proxy, haz lo siguiente:

1. Abre la IU de Apigee en la consola de Cloud en un navegador.
2. Asegúrate de que el nombre de tu organización esté seleccionado en el menú desplegable en la esquina superior izquierda de la IU. El nombre de la organización es el mismo que el nombre de tu proyecto de Google Cloud.
3. En el panel de navegación izquierdo, haz clic en Desarrollo de proxy > Proxies de API.
4. Haz clic en Crear.

   Se abrirá la página Crear un proxy.

5. En el cuadro Plantilla de proxy, selecciona Proxy inverso (más común).
6. En el Paso 1: Detalles del proxy, configura tu proxy con los siguientes valores:

   Nombre del parámetro	Valor
   Nombre del proxy	hello-world
   Ruta base	/hello-world
   (API existente) de destino	mocktarget.apigee.net

7. Haz clic en Siguiente.
8. En Paso 2: Políticas, en Seguridad: autorización, selecciona Pasar (sin autorización).
9. Haz clic en Siguiente.
10. En el Paso 3: Implementar (opcional), selecciona el entorno en el que deseas implementar el proxy y haz clic en Aceptar.
11. Haz clic en Crear.

    Tu proxy de API nuevo se crea y se implementa en el entorno seleccionado.

    Nota: El proxy no se implementa por completo de forma instantánea. El proxy puede tardar hasta un minuto en implementarse.
12. Se mostrará la página Resumen de proxy para tu proxy recién creado. Una marca de verificación verde en Estado indica que el proxy se implementó de forma correcta. Si el proxy no está implementado, consulta Implementa un proxy de API y sigue los pasos para implementarlo de forma manual.
13. En el panel de navegación izquierdo, selecciona Administración > Entornos > Grupos de entornos.
14. Copia el nombre de host para tu grupo de entornos. Usarás este nombre de host para llamar al proxy de API en los pasos siguientes.

IU de Apigee

Para crear e implementar tu primer proxy, haz lo siguiente:

1. Accede a la IU de Apigee.
2. Asegúrate de que el nombre de tu organización esté seleccionado en el menú desplegable en la esquina superior izquierda de la IU. El nombre de la organización es el mismo que el nombre de tu proyecto de Google Cloud.
3. Haz clic en Proxies de API en la vista principal.
4. En la lista desplegable Seleccionar entorno, selecciona un entorno.
5. Haz clic en Crear nueva.
6. Haz clic en Proxy inverso (más común).
7. En la página Detalles del proxy, configura tu proxy con los siguientes valores:

   Nombre del parámetro	Valor
   Nombre	hello-world
   Ruta base	/hello-world
   (API existente) de destino	https://mocktarget.apigee.net

8. Haz clic en Siguiente.
9. En la página Políticas comunes, en Seguridad: autorización, selecciona Pasar (sin autorización).
10. Haz clic en Siguiente.
11. En la página Resumen, en Implementación opcional, selecciona el entorno en el que deseas implementar el proxy.
12. Haz clic en Crear e implementar (Create and deploy).

    Tu proxy de API nuevo se crea y se implementa en el entorno seleccionado.

    Nota: El proxy no se implementa por completo de forma instantánea. El proxy puede tardar hasta un minuto en implementarse.
13. Haz clic en Ir a la lista de proxy. Una marca de verificación verde en Estado indica que el proxy se implementó de forma correcta. Si el proxy no está implementado, consulta Implementa un proxy de API y sigue los pasos para implementarlo de forma manual.
14. En el panel de navegación izquierdo, selecciona Administrador > Entornos > Grupos.
15. Copia el nombre de host para tu grupo de entornos. Usarás este nombre de host para llamar al proxy de API en los pasos siguientes.

Llama al proxy con acceso interno

Si permitiste el acceso interno en el Paso 7: Configura el enrutamiento de acceso, sigue las instrucciones en Llama a un proxy de API con acceso solo interno.

Llama al proxy con acceso externo

Si permitiste el acceso externo en el Paso 7: Configura el enrutamiento de acceso, sigue estos pasos:

1. Configura una entrada de DNS para el host. Existen dos formas de realizar esta tarea:
   • En tu registrador, crea un registro A que dirija el nombre de host de tu grupo de entornos a la IP que se muestra en la página del asistente en Configura DNS. Por ejemplo, si el nombre de host es sales.example.com y la IP es 10.23.0.2, dirige el registro de sales.example.com a la dirección 10.23.0.2.
   • Usa Google Cloud DNS para asignar una URL a una dirección IP.
2. Para probar el proxy de API, envía la siguiente solicitud en una ventana de la terminal:
   Nota: Los cambios de DNS se publican de inmediato, pero pueden tardar un tiempo en propagarse. Debido a este retraso, es posible que debas esperar hasta una hora antes de poder llamar al proxy de muestra.

   curl -v -H "Host:YOUR_ENV_GROUP_HOSTNAME" \
     https://YOUR_INSTANCE_IP_OR_DNS/hello-world

   Aquí:

   • El valor del encabezado Host (YOUR_ENV_GROUP_HOSTNAME) es el nombre de host que definiste en el grupo de entorno en el Paso 6: Crea un entorno.

   Una solicitud correcta muestra la string: Hello, Guest!. Si tu solicitud no funciona, consulta Solución de problemas.

Próximos pasos

• Haz un recorrido por los instructivos de Apigee, incluidos los siguientes:
  • Protege contra aumentos repentinos de tráfico.
  • Obtén una vista detallada del flujo de solicitud y respuesta.