Sviluppo di flussi condivisi

Questa pagina si applica ad Apigee e Apigee hybrid.

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 come un proxy, un flusso condiviso non ha un 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
• Collegare 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: Crea bundle di flusso condiviso Apigee.

   Viene visualizzata la procedura guidata Crea flusso condiviso.

2. Inserisci un nome univoco per il flusso condiviso nel 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 del flusso condiviso è strutturata come descritto in Struttura della directory dei gruppi di flussi condivisi

Caricamento di un bundle di flussi condiviso

Per caricare un bundle di flussi 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: Importa bundle di flusso condiviso Apigee.

2. Vai al gruppo di flussi condiviso che vuoi caricare e fai clic su Importa flusso condiviso. Il pacchetto di flussi condiviso deve essere strutturato come descritto in Struttura della directory dei gruppi di flussi condivisi.

3. (Facoltativo) Per impostazione predefinita, per il nome del flusso condiviso viene utilizzato il nome del file ZIP meno la sua estensione. Se si tratta di un nome non univoco, viene richiesto di specificarne uno univoco.

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
• Aggiunta di funzionalità mediante i criteri
• Gestione delle risorse

Utilizzo dei flussi condivisi

Puoi chiamare un flusso condiviso utilizzando il criterio FlowCallout, come descritto nelle norme di FlowCallout.

Inoltre, collegando un flusso condiviso a un hook di flusso puoi eseguirlo 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 mediante hook di flusso (flowhooks.json) (passaggi che utilizzano Apigee in Cloud Code)

Nota: Apigee non convalida le dipendenze tra flussi condivisi e 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 non è stato eseguito, 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.