Sviluppo di flussi condivisi

Questa pagina si applica a Apigee e Apigee ibrido.

Visualizza la documentazione di Apigee Edge.

Nota: utilizza lo sviluppo locale con Apigee e Apigee hybrid 1.5 e versioni successive.

Combina criteri e risorse in un flusso condiviso che puoi utilizzare da più proxy API e anche da altri flussi condivisi. Sebbene sia simile a un proxy, un flusso condiviso non ha endpoint. Può essere utilizzato solo da un proxy API o da un flusso condiviso che si trova nella stessa organizzazione del flusso condiviso stesso.

Sviluppa i tuoi flussi condivisi utilizzando Apigee in Cloud Code come descritto nelle sezioni seguenti. Vedi anche Gestire cartelle e file in un'area di lavoro Apigee.

Prima di iniziare: acquisisci familiarità con i concetti descritti nei seguenti argomenti:

• Creazione di flussi condivisi riutilizzabili
• Collegamento di un flusso condiviso utilizzando un hook di flusso

Creazione di un flusso condiviso

Per creare un flusso condiviso utilizzando Apigee in Cloud Code:

1. Esegui uno dei seguenti passaggi:

   • Nella sezione Apigee, posiziona il cursore sulla cartella shareflows e fai clic su .

   • Seleziona Visualizza > Tavolozza dei comandi per aprire la tavolozza dei comandi e seleziona Cloud Code: Create Apigee shared flow bundle.

   Si apre la procedura guidata Crea flusso condiviso.

2. Inserisci un nome univoco per il flusso condiviso al prompt e premi Invio.

Dopo aver completato i passaggi della procedura guidata, la nuova cartella sharedflow-name viene aggiunta in sharedflows nella sezione Apigee. Ogni cartella di flusso condiviso è strutturata come descritto in Struttura della directory del bundle dei flussi condivisi

Caricamento di un bundle di flusso condiviso

Per caricare un bundle di flusso condiviso utilizzando Apigee in Cloud Code:

1. Esegui una delle seguenti azioni:

   • Nella sezione Apigee, posiziona il cursore sulla cartella sharedflows e fai clic su .

   • Seleziona Visualizza > Tavolozza dei comandi per aprire la tavolozza dei comandi e seleziona Cloud Code: Import Apigee shared flow bundle.

2. Vai al bundle del flusso condiviso che vuoi caricare e fai clic su Importa flusso condiviso. Il bundle di flusso condiviso deve essere strutturato come descritto in Struttura della directory del bundle di flusso condiviso.

3. (Facoltativo) Per impostazione predefinita, per il nome del flusso condiviso viene utilizzato il nome del file ZIP meno la sua estensione. Se il nome non è univoco, ti verrà chiesto di inserirne uno.

La cartella sharedflow-name caricata viene aggiunta in sharedflows in Apigee Explorer.

Configurazione dei flussi condivisi

Configura i flussi condivisi come descritto nei seguenti argomenti:

• Creazione di flussi condivisi riutilizzabili
• Aggiungere funzionalità utilizzando i criteri
• Gestione delle risorse

Utilizzo dei flussi condivisi

Puoi chiamare un flusso condiviso utilizzando il criterio FlowCallout, come descritto nelle norme relative ai callout Flow.

Inoltre, collegando un flusso condiviso a un hook di flusso, puoi eseguire il flusso condiviso prima di una richiesta proxy o di destinazione, oppure dopo un proxy o una risposta di destinazione. Per ulteriori informazioni, vedi:

• Collegamento di un flusso condiviso utilizzando un hook di flusso (panoramica concettuale)
• Collegamento di flussi condivisi utilizzando hook di flusso (flowhooks.json) (passi che utilizzano Apigee in Cloud Code)

Nota: Apigee non convalida le dipendenze tra i flussi condivisi e i proxy API al momento del deployment. Ad esempio, se il criterio FlowCallout in un proxy API fa riferimento a un flusso condiviso che non esiste o che non è stato implementato, il deployment del proxy API riesce comunque. Quando Apigee controlla la dipendenza in fase di runtime e la convalida non va a buon fine, Apigee genera un errore del proxy API con un codice di stato HTTP 500.