Paso 2: Implementa un proxy de API

Ahora que configuraste Google Cloud y la IU de Apigee, instalaste y configuraste el entorno de ejecución, estás listo para ver cómo funciona todo en conjunto.

1. Crea un proxy de API nuevo con la IU de Apigee

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

Apigee en la consola de Cloud

Para crear un proxy de API nuevo con Apigee en la consola de Cloud, haz lo siguiente:

  1. Abre la IU 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. Selecciona Desarrollo de proxy > Proxies de API en la vista principal.
  4. Haz clic en Crear. Se iniciará el asistente de proxy de API.
  5. Selecciona Proxy inverso (más común).

    Se muestra la vista Detalles del proxy.

  6. Configura tu proxy con los siguientes ajustes:
    • Nombre del proxy: Ingresa miproxy. En los pasos restantes de esta sección, se supone que este es el ID de tu proxy.
    • Ruta base: Se configura de forma automática en / seguida del nombre del proxy, que en este ejemplo es /myproxy. La ruta base es parte de la URL que se usa para realizar solicitudes a la API. Edge usa la URL para hacer coincidir solicitudes entrantes y enrutarlas al proxy de API adecuado.
    • (Opcional) Descripción: Ingresa una descripción para tu nuevo proxy de API, como “Prueba de Apigee Hybrid con un proxy simple”.
    • Destino (API existente): Ingresa "https://mocktarget.apigee.net". Esto define la URL de destino que Apigee invoca en una solicitud al proxy de API. El servicio de destino ficticio se aloja en Apigee y muestra datos simples. No requiere una clave de API ni un token de acceso.

    Los detalles de tu proxy de API deben tener el siguiente aspecto:

    Detalles del proxy en el asistente para crear proxy

  7. Haz clic en Siguiente.
  8. En la pantalla Policies, selecciona Pass through (no authorization) como la opción de seguridad.
  9. Haz clic en Siguiente.
  10. En Implementar (opcional), tienes la opción de seleccionar uno o más entornos en los que implementar tu proxy en el campo Entornos de implementación. Si prefieres no implementar el proxy en este punto, deja vacío el campo Entornos de implementación. Siempre puedes implementar el proxy más adelante.
  11. Haz clic en Crear. Apigee genera el proxy (a veces denominado el paquete del proxy):

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

Debajo de eso, la sección Endpoints muestra lo siguiente:

  • Extremos de proxy: La ruta base que configuraste para el proxy, que es este ejemplo, es /myproxy.
  • Extremos de destino: La ruta base que estableces para el destino, que en este ejemplo es https://mocktarget.apigee.net.

Apigee clásico

Para crear un proxy de API nuevo con la versión clásica de Apigee, sigue estos pasos:

  1. Abre la IU 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 de proxy de API.
  5. Selecciona Proxy inverso (más común).

    Se muestra la vista Detalles del proxy.

  6. Configura tu proxy con los siguientes ajustes:
    • Nombre del proxy: Ingresa “myproxy”. En los pasos restantes de esta sección, se supone que este es el ID de tu proxy.
    • Ruta base del proxy: Se configurará de forma automática como "/myproxy". La ruta base del proxy es parte de la URL que se usa para realizar solicitudes a la API. Edge usa la URL para hacer coincidir solicitudes entrantes y enrutarlas al proxy de API adecuado.
    • (Opcional) Descripción: Ingresa una descripción para tu nuevo proxy de API, como "Prueba de Apigee Hybrid con un proxy simple".
    • Destino (API existente): Ingresa "https://mocktarget.apigee.net". Esto define la URL de destino que Apigee invoca en una solicitud al proxy de API. El servicio de destino ficticio se aloja en Apigee y muestra datos simples. No requiere una clave de API ni un token de acceso.

    Los detalles de tu proxy de API deben tener el siguiente aspecto:

    Detalles del proxy en el asistente de creación del proxy.

  7. Haz clic en Siguiente.
  8. En la pantalla Policies, selecciona Pass through (no authorization) como la opción de seguridad.
  9. Haz clic en Siguiente.
  10. En la pantalla Resumen, selecciona un entorno para implementar tu proxy y haz clic en Crear e implementar.

    Hybrid genera el proxy (a veces denominado el paquete del proxy):

    Cuadro de diálogo de confirmación del asistente de creación de proxy.

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

    Apigee muestra la vista Proxies, en la que se muestra una lista de los proxies de API. El proxy nuevo debe aparecer con un indicador de estado verde, lo que significa que se implementó.

2. Llama al proxy de API

Cuando la IU indica que el proxy está implementado, puedes intentar llamarlo con cURL o el cliente REST que elijas. Por ejemplo:

  1. Asegúrate de que la variable de entorno DOMAIN esté configurada en el nombre de dominio que usaste para el nombre de host de tu grupo de entornos en Configuración del proyecto y la organización. Paso 3: Crea un grupo de entornos.
    echo $DOMAIN
  2. Busca la dirección IP externa y el puerto de la puerta de enlace de entrada de Apigee con el siguiente comando:

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

    Deberías obtener un resultado similar al siguiente:

    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 externa y el puerto a las 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

    Por ejemplo:

    curl  -H Host:example.com --resolve example.com:443:233.252.0.123 https://example.com:443/myproxy -k

Para obtener más información sobre cómo compilar e implementar proxies de API, consulta Descripción general de la creación de tu primer proxy.