Testa e pubblica le integrazioni
Puoi testare o pubblicare un'integrazione dall'editor delle integrazioni dopo aver aggiunto e configurato l'integrazione con i trigger, le attività e le connessioni edge necessarie. Quando testi un'integrazione utilizzando la console Google Cloud , l'integrazione viene eseguita in modalità sincrona.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per testare o pubblicare un'integrazione, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:
-
Testare un'integrazione:
Application Integration Invoker (
roles/integrations.integrationInvoker) -
Pubblica un'integrazione:
Application Integration Deployer (
roles/integrations.integrationDeployer)
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questi ruoli predefiniti contengono le autorizzazioni necessarie per testare o pubblicare un'integrazione. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per testare o pubblicare un'integrazione sono necessarie le seguenti autorizzazioni:
-
Testa un'integrazione:
integrations.integrations.invoke -
Pubblica un'integrazione:
integrations.integrationVersions.deploy
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Il ruolo Application Integration Editor (roles/integrations.integrationEditor) contiene entrambe le autorizzazioni.
Se l'integrazione utilizza un account di servizio "run-as", devi disporre anche del ruolo Service Account User (roles/iam.serviceAccountUser) su quel account di servizio per testarlo o pubblicarlo.
Consulta Concedi il ruolo Service Account User.
Testa un'integrazione
Se vuoi verificare che l'integrazione funzioni come previsto, puoi testarla prima della pubblicazione. Il test di un'integrazione ti consente di sperimentare i valori delle variabili di input dell'integrazione e aiuta a identificare eventuali errori nel flusso di connessione dell'integrazione.
Per testare l'esecuzione di un'integrazione, seleziona una delle seguenti opzioni:
Console
- Nella console Google Cloud, vai alla pagina Application Integration.
- Fai clic su Integrazioni nel menu di navigazione a sinistra per aprire la pagina Integrazioni.
- Seleziona l'integrazione che vuoi testare.
- Nella barra di navigazione della finestra di progettazione, fai clic su Test.
Se nell'integrazione sono configurati più trigger, seleziona quello da cui vuoi eseguire il test dell'integrazione. Viene visualizzato il riquadro Testa integrazione.
- Fai clic su Test integration (Testa integrazione).
Application Integration esegue l'integrazione e visualizza il risultato dell'esecuzione nel riquadro Testa integrazione:
- Per modificare le variabili di input, fai clic su Modifica variabili di input.
- Per riapprovare l'integrazione, fai clic su Riapprova integrazione.
- Per ripristinare i valori, fai clic su Ripristina valori.
- Per visualizzare e ispezionare i log di esecuzione dell'esecuzione del test, fai clic su Visualizza log.
- Se hai attivato Cloud Logging, per visualizzare i log in Cloud Logging, fai clic su Visualizza i log di Cloud.
- Per modificare l'integrazione senza creare una nuova versione, fai clic su Modifica integrazione.
- Per chiudere l'operazione di test e tornare all'editor delle integrazioni, fai clic su Chiudi.
API
Chiama il metodo projects.locations.integrations.test.
Il campo clientId nel corpo della richiesta è obbligatorio. Impostalo sul numero di progetto Google Cloud, non sull'ID progetto.
Per impostare il timeout del flusso, imposta il campo X-Server-Timeout nell'intestazione. Per impostazione predefinita, il timeout è di 120 secondi. Per un elenco di parametri di richiesta predefiniti, consulta Parametri di sistema.
Pubblica un'integrazione
La pubblicazione di una versione dell'integrazione ne esegue il deployment e la mette in uno stato attivo. La pubblicazione di qualsiasi versione dell'integrazione pubblicata in precedenza verrà annullata automaticamente e tutti i servizi che si basano sulla versione dell'integrazione pubblicata in precedenza utilizzeranno automaticamente l'ultima versione pubblicata.
Per pubblicare un'integrazione, seleziona una delle seguenti opzioni:
Console
- Nella console Google Cloud, vai alla pagina Application Integration.
- Fai clic su Integrazioni nel menu di navigazione a sinistra per aprire la pagina Integrazioni.
- Seleziona l'integrazione che vuoi pubblicare.
- Nella barra di navigazione del designer, fai clic sul menu a discesa Versione e seleziona la versione dell'integrazione che vuoi pubblicare.
- Fai clic su Pubblica.
Viene visualizzata la finestra di dialogo Genera automaticamente la descrizione dell'integrazione. Se vuoi generare una descrizione, fai clic su Sì, continua. In caso contrario, fai clic su No, pubblica soltanto.
Una volta pubblicata l'integrazione, puoi visualizzare ed esaminare i log di esecuzione dell'integrazione pubblicata. Per visualizzare i log, fai clic su Log nella barra degli strumenti dell'editor delle integrazioni.
Per impostazione predefinita, Application Integration blocca la modifica di un'integrazione quando viene pubblicata. Per apportare modifiche all'integrazione pubblicata, fai clic su Abilita modifica nell'editor di integrazione. La modifica di un'integrazione pubblicata creerà una nuova versione dell'integrazione.
API
Chiama il metodo projects.locations.integrations.versions.publish.
Annulla la pubblicazione di un'integrazione
Annullando la pubblicazione di una versione di integrazione attiva, viene annullato il deployment della versione di integrazione, che viene messa in stato di snapshot. Tutti i servizi che si basano sulla versione pubblicata dell'integrazione verranno interrotti automaticamente.
Per annullare la pubblicazione di un'integrazione, seleziona una delle seguenti opzioni:
Console
- Nella console Google Cloud, vai alla pagina Application Integration.
- Fai clic su Integrazioni nel menu di navigazione a sinistra per aprire la pagina Integrazioni.
- Seleziona l'integrazione di cui vuoi annullare la pubblicazione.
- Nella barra di navigazione del designer, fai clic sul menu a discesa Versione e seleziona la versione dell'integrazione di cui vuoi annullare la pubblicazione.
- Fai clic su Unpublish (Annulla pubblicazione).
Una volta annullata la pubblicazione dell'integrazione, puoi fare clic su Abilita modifica nell'editor delle integrazioni per modificarla. La modifica dell'integrazione creerà una nuova versione dell'integrazione.
API
Chiama il metodo projects.locations.integrations.versions.unpublish.
Quota e limiti
Per informazioni su quote e limiti di Application Integration, consulta Quote e limiti.
Best practice
- Definisci l'usabilità di una variabile (variabile di input o variabile di output) prima di testare l'integrazione. Consulta Variabili di integrazione.
- Definisci la gestione degli errori per la tua integrazione.
Quote e limiti
Per informazioni su quote e limiti, consulta Quote e limiti.