Agregar y configurar una extensión

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

Apigee Edge incluye varios paquetes de extensión instalados. Antes de poder usar una extensión en un proxy de API con una política de Extension Featured, deberás agregar y configurar la extensión. Cuando agregas una extensión, debes ubicar el paquete de extensión que representa el recurso externo que deseas integrar con el proxy de API, agregar y configurar una extensión desde ese paquete y, luego, implementar la extensión en un entorno de Edge.

Cuando configuras una extensión desde un paquete de extensiones, especificas valores que enfocan la interacción de la extensión con su recurso externo. Por ejemplo, cuando configuras una extensión de Google Cloud Firestore, especificas qué base de datos debería usar la extensión cuando se crean, obtienen y borran documentos. Cada extensión tiene su propio conjunto de propiedades de configuración que corresponden a aspectos del recurso con el que interactúa. Para obtener una lista de las extensiones incluidas, consulta la Descripción general de la referencia de las extensiones.

Por lo general, la configuración de cada extensión incluye las credenciales que esta debería usar para autenticarse con el recurso en tu nombre.

El entorno de implementación de extensiones es elástico para admitir el ajuste de escala automático según la carga. Como resultado, de forma predeterminada, es posible que una implementación de extensión que no tiene tráfico no tenga una instancia disponible para responder a las solicitudes. Por lo tanto, la primera solicitud a una extensión puede demorar más tiempo mientras el entorno crea una instancia de la extensión para su uso.

Para ver un instructivo inicial, consulta Instructivo: Cómo agregar y usar una extensión.

Agrega y configura una extensión

  1. Accede a Edge, haz clic en el menú Administrar y, luego, en Extensiones.

    La página Extensiones que aparece muestra todas las extensiones que se configuraron a partir de paquetes de extensiones disponibles en el sistema. Si deseas ver una extensión configurada, puedes filtrar la lista escribiendo términos de filtrado en la parte superior de la página.

    En los próximos pasos, agregarás tu propia extensión.

  2. En la página Extensión, haz clic en Agregar extensión.

    La página Seleccionar una extensión que aparece divide las extensiones entre las que son desarrolladas por Google y las desarrolladas por otras empresas.

  3. En Selecciona una extensión, haz clic en la pestaña que desees y, luego, busca la extensión correspondiente al recurso externo al que accedes.

    En el cuadro del paquete de la extensión, puedes hacer clic en Ver detalles para ver información sobre la versión de la extensión, el autor, etcétera.

  4. Haz clic en el cuadro del paquete de extensiones para comenzar a configurar una extensión desde el paquete.

  5. En el cuadro de diálogo Extension Properties, ingresa un nombre y una descripción para la extensión y, luego, haz clic en Create.

  6. En la página Extension > My-Extension-Name de la extensión que estás creando, busca el entorno de Apigee Edge para el que quieres configurar la extensión.

    Se debe implementar una extensión en el mismo entorno que el proxy de API que la utilizará.

  7. Haz clic en la fila del entorno en la lista.

  8. En el diálogo Configuración, selecciona o ingresa valores para configurar esta extensión.

    Cada extensión tiene sus propias propiedades de configuración. Para obtener descripciones de las propiedades, usa la referencia de la extensión. Las referencias de las extensiones se enumeran en la Descripción general de las referencias de extensiones.

  9. Haz clic en Guardar.

Implementa una extensión

  1. En la página Extension > My-Extension-Name de la extensión, haz clic en Deploy para implementar la extensión y usarla desde un proxy de API.

Después de implementar una extensión, haz lo siguiente: