Paso 2: Despliega un proxy de APIs

Ahora que has configurado Google Cloud y la interfaz de usuario de Apigee, y has instalado y configurado el tiempo de ejecución, puedes ver cómo funciona todo en conjunto.

1. Crear un proxy de API con la interfaz de usuario de Apigee

En esta sección se describe cómo crear un proxy de API en la interfaz de usuario con el asistente de proxy de API.

Apigee en la consola de Cloud

Para crear un proxy de API con Apigee en la consola de Cloud, sigue estos pasos:

  1. Abre la interfaz de Apigee en la consola de Cloud en un navegador.
  2. Selecciona tu organización en el menú desplegable de la esquina superior izquierda.
  3. En la vista principal, selecciona Desarrollo de proxies > Proxies de API.
  4. Haz clic en Crear.Se iniciará el asistente para proxies de API.
  5. Selecciona Proxy inverso (la opción más habitual).

    Se muestra la vista Detalles del proxy.

  6. Configura tu proxy con los siguientes ajustes:
    • Nombre del proxy: introduce myproxy. En los pasos restantes de esta sección se da por hecho que este es el ID de tu proxy.
    • Ruta base: se define automáticamente como / seguido del nombre del proxy, que en este ejemplo es /myproxy. La ruta base forma parte de la URL que se usa para enviar solicitudes a tu API. Apigee usa la URL para hacer coincidir y enrutar las solicitudes entrantes al proxy de API adecuado.
    • (Opcional) Descripción: escribe una descripción para tu nuevo proxy de API, como "Prueba de Apigee hybrid con un proxy sencillo".
    • Destino (API actual): introduce "https://mocktarget.apigee.net". Define la URL de destino que invoca Apigee en una solicitud al proxy de API. El servicio mocktarget está alojado en Apigee y devuelve datos sencillos. No requiere ninguna clave de API ni token de acceso.

    Los detalles de tu proxy de API deberían ser similares a los siguientes:

    Detalles del proxy en el asistente para crear un proxy.

  7. Haz clic en Siguiente.
  8. En Desplegar (opcional), puede seleccionar uno o varios entornos en los que desplegar su proxy en el campo Entornos de despliegue. Si prefieres no implementar el proxy en este momento, deja el campo Entornos de implementación vacío. Puedes implementar el proxy más adelante.
  9. Haz clic en Crear. Apigee genera el proxy (a veces denominado paquete de proxy).

Apigee muestra la vista Resumen del proxy. Si has elegido implementar el proxy, en la sección Implementaciones se muestra el número de Revisión, que es 1 cuando lo implementas por primera vez. En la columna Estado se muestran los entornos en los que se ha implementado el proxy con un indicador de estado verde.

Debajo, en la sección Revisiones, se muestran todas las revisiones que se han hecho en este proxy. Si haces clic en uno de los elementos de VER de la columna Resumen de endpoint, se mostrará la sección Endpoint, que incluye lo siguiente:

  • Puntos finales de proxy: la ruta base que has definido para el proxy, que en este ejemplo es /myproxy.
  • Endpoints de destino: la ruta base que has definido para el destino, que en este ejemplo es https://mocktarget.apigee.net.

Apigee Classic

Para crear un proxy de APIs con Apigee Classic, sigue estos pasos:

  1. Abre la interfaz de Apigee en un navegador.
  2. Selecciona tu organización en el menú desplegable de la esquina superior izquierda.
  3. Selecciona Desarrollar > Proxies de API en la vista principal.
  4. Haz clic en Crear nuevo.Se iniciará el asistente para proxies de API.
  5. Selecciona Proxy inverso (la opción más habitual).

    Se muestra la vista Detalles del proxy.

  6. Configura tu proxy con los siguientes ajustes:
    • Nombre del proxy: escriba "myproxy". En los pasos restantes de esta sección se da por supuesto que este es el ID de tu proxy.
    • Ruta base del proxy: se define automáticamente como "/myproxy". La ruta base del proxy forma parte de la URL que se usa para enviar solicitudes a tu API. Apigee usa la URL para hacer coincidir y enrutar las solicitudes entrantes al proxy de API adecuado.
    • (Opcional) Descripción: escribe una descripción para tu nuevo proxy de API, como "Prueba de Apigee hybrid con un proxy sencillo".
    • Destino (API actual): introduce "https://mocktarget.apigee.net". Define la URL de destino que invoca Apigee en una solicitud al proxy de API. El servicio mocktarget está alojado en Apigee y devuelve datos sencillos. No requiere ninguna clave de API ni token de acceso.

    Los detalles de tu proxy de API deberían ser similares a los siguientes:

    Detalles del proxy en el asistente Crear proxy.

  7. Haz clic en Siguiente.
  8. En la pantalla Políticas comunes, selecciona Transferencia (sin autorización) como opción de seguridad.
  9. Haz clic en Siguiente.
  10. En la pantalla Resumen, selecciona un entorno en el que implementar tu proxy y haz clic en Crear e implementar.

    Hybrid genera el proxy (a veces denominado paquete de proxy) y lo implementa en el entorno que hayas seleccionado.

  11. Haz clic en Ir a la lista de proxies.

    Apigee muestra la vista Proxies, que contiene una lista de proxies de APIs. El nuevo proxy debería mostrarse con un indicador de estado verde, lo que significa que se ha implementado.

2. Llamar al proxy de API

Cuando la interfaz de usuario indique que tu proxy se ha desplegado, puedes probar a llamarlo con cURL o con el cliente REST que elijas. Por ejemplo:

  1. Asegúrate de que la variable de entorno DOMAIN esté definida con el nombre de dominio que has usado para el nombre de host de tu grupo de entornos en Configuración del proyecto y de la organización - Paso 3: Crear un grupo de entornos. 
    echo $DOMAIN

  2. Busca la dirección IP externa y el puerto de la pasarela de entrada de Apigee con el siguiente comando:

    kubectl get svc -n APIGEE_NAMESPACE -l app=apigee-ingressgateway

    La salida debería tener un aspecto similar a este: 

    NAME                                        TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)                                      AGE
apigee-ingressgateway-prod-hybrid-37a39bd   LoadBalancer   192.0.2.123   233.252.0.123   15021:32049/TCP,80:31624/TCP,443:30723/TCP   16h
  3. Exporta tu IP y puerto externos a variables: 
    export INGRESS_IP_ADDRESS=EXTERNAL_IP_ADDRESS
export INGRESS_PORT=PORT_NUMBER
  4. Llama al proxy de API: 
    curl  -H Host:$DOMAIN --resolve \
  $DOMAIN:$INGRESS_PORT:$INGRESS_IP_ADDRESS  \
  https://$DOMAIN:$INGRESS_PORT/myproxy -k -v

    Por ejemplo: 

    curl -v -H Host:example.com --resolve example.com:443:233.252.0.123 https://example.com:443/myproxy -k -v
  5. Si la llamada al proxy se realiza correctamente, se devuelve un código de respuesta HTTP 200 y el siguiente resultado.

    Hello, Guest!

Para obtener más información sobre cómo crear y desplegar proxies de APIs, consulta el artículo Crear tu primer proxy.