Aggiunta e configurazione di un'estensione

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X.
informazioni

Apigee Edge include diversi pacchetti di estensione installati. Prima di poter utilizzare un'estensione in un proxy API con le norme sui callout delle estensioni, devi aggiungerla e configurarla. Quando aggiungi un'estensione, individui il pacchetto dell'estensione che rappresenta la risorsa esterna che vuoi integrare con il proxy API, aggiungi e configuri un'estensione da quel pacchetto ed esegui il deployment dell'estensione in un ambiente Edge.

Quando configuri un'estensione da un pacchetto di estensioni, specifichi i valori che focalizzano l'interazione dell'estensione con la relativa risorsa esterna. Ad esempio, quando configuri un'estensione di Google Cloud Firestore, specifichi il database da utilizzare per la creazione, il recupero e l'eliminazione di documenti. Ogni estensione ha il proprio set di proprietà di configurazione che corrispondono agli aspetti della risorsa con cui interagisce. Per un elenco delle estensioni incluse, consulta la panoramica dei riferimenti sulle estensioni.

In genere, la configurazione di ogni estensione include le credenziali che l'estensione deve utilizzare per autenticarsi con la risorsa per tuo conto.

L'ambiente di deployment delle estensioni è elastico per supportare la scalabilità automatica in base al carico. Di conseguenza, per impostazione predefinita, un deployment di estensioni senza traffico potrebbe non avere un'istanza disponibile per rispondere alle richieste. Di conseguenza, la prima richiesta a un'estensione potrebbe richiedere più tempo mentre l'ambiente crea un'istanza dell'estensione da utilizzare.

Per un tutorial iniziale, consulta Tutorial: aggiunta e utilizzo di un'estensione.

Aggiunta e configurazione di un'estensione

  1. Accedi a Edge, fai clic sul menu Amministrazione e poi su Estensioni.

    Nella pagina Estensioni visualizzata sono elencate tutte le estensioni configurate a partire dai pacchetti di estensioni disponibili nel sistema. Se vuoi visualizzare un'estensione configurata esistente, puoi filtrare l'elenco digitando i termini di filtro nella parte superiore della pagina.

    Nei passaggi successivi, aggiungerai la tua estensione.

  2. Nella pagina Estensione, fai clic su Aggiungi estensione.

    Nella pagina Seleziona un'estensione visualizzata vengono divise le estensioni tra quelle sviluppate da Google e quelle sviluppate da altre aziende.

  3. In Seleziona un'estensione, fai clic sulla scheda che ti interessa e individua l'estensione corrispondente alla risorsa esterna a cui stai accedendo.

    Nella casella relativa al pacchetto dell'estensione, puoi fare clic su Visualizza dettagli per visualizzare informazioni sulla versione, sull'autore e così via dell'estensione.

  4. Fai clic sulla casella relativa al pacchetto dell'estensione per iniziare a configurare un'estensione dal pacchetto.

  5. Nella finestra di dialogo Proprietà estensione, inserisci un nome e una descrizione per l'estensione, poi fai clic su Crea.

  6. Nella pagina Estensione > Nome-estensione relativa all'estensione che stai creando, individua un ambiente Apigee Edge per il quale vuoi configurare l'estensione.

    È necessario eseguire il deployment di un'estensione nello stesso ambiente del proxy API che la utilizzerà.

  7. Fai clic sulla riga dell'ambiente nell'elenco.

  8. Nella finestra di dialogo Configurazione, seleziona o inserisci i valori per configurare questa estensione.

    Ogni estensione ha le proprie proprietà di configurazione. Per le descrizioni delle proprietà, utilizza il riferimento dell'estensione. I riferimenti delle estensioni sono elencati nella sezione Panoramica delle riferimento sulle estensioni.

  9. Fai clic su Salva.

Deployment di un'estensione

  1. Nella pagina Estensione > Nome-estensione relativa all'estensione, fai clic su Esegui il deployment per eseguire il deployment dell'estensione in modo che venga utilizzata da un proxy API.

Dopo aver eseguito il deployment di un'estensione: