Crea un workflow utilizzando la console Google Cloud

Crea un workflow utilizzando la console Google Cloud

Questa guida rapida mostra come creare, eseguire il deployment ed eseguire il tuo primo flusso di lavoro utilizzando la console Google Cloud . Il workflow di esempio invia una richiesta a un'API pubblica e poi restituisce la risposta dell'API.

---

Per seguire le indicazioni dettagliate per questa attività direttamente nella console Google Cloud , fai clic su Procedura guidata:

Procedura guidata

---

Prima di iniziare

I vincoli di sicurezza definiti dalla tua organizzazione potrebbero impedirti di completare i passaggi seguenti. Per informazioni sulla risoluzione dei problemi, vedi Sviluppare applicazioni in un ambiente Google Cloud vincolato.

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Workflows API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Workflows API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Configura l'autenticazione:
   1. Assicurati di disporre del ruolo IAM Creazione account di servizio (roles/iam.serviceAccountCreator) e del ruolo Amministratore IAM progetto (roles/resourcemanager.projectIamAdmin). Scopri come concedere i ruoli.

   2. Nella console Google Cloud vai a Crea service account.

      Vai a Crea service account
   3. Seleziona il progetto.

   4. Nel campo Nome service account, inserisci un nome. La console Google Cloud compila il campo ID service account in base a questo nome.

      Nel campo Descrizione service account, inserisci una descrizione. Ad esempio, Service account for quickstart.

   5. Fai clic su Crea e continua.

   6. Concedi il ruolo Logging > Writer log al account di servizio.

      Per concedere il ruolo, trova l'elenco Seleziona un ruolo, quindi seleziona Logging > Logs Writer.

      Nota: il campo Ruolo influisce sulle risorse a cui il account di servizio può accedere nel tuo progetto. Puoi revocare questi ruoli o concederne altri in un secondo momento.
   7. Fai clic su Continua.

   8. Fai clic su Fine per completare la creazione del service account.

Per scoprire di più sui ruoli e sulle autorizzazioni dei account di servizio, consulta Concedi l'autorizzazione dei workflow per l'accesso alle Google Cloud risorse.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per completare questa guida rapida, chiedi all'amministratore di concederti i seguenti ruoli IAM nel tuo progetto:

• Service Account User (roles/iam.serviceAccountUser)
• Workflows Admin (roles/workflows.admin)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea ed esegui il deployment di un flusso di lavoro

1. Nella console Google Cloud , vai alla pagina Workflow:

   Vai a Flussi di lavoro

2. Nella pagina Flussi di lavoro, fai clic su Crea.

3. Inserisci un nome per il nuovo flusso di lavoro, ad esempio myFirstWorkflow.

4. Scegli us-central1 per la regione.

5. Per service account, seleziona il account di servizio che hai creato in precedenza.

6. Seleziona Avanti.

7. Nell'editor del flusso di lavoro, copia e incolla il seguente flusso di lavoro:

   YAML

   main:
     params: [input]
     steps:
       - checkSearchTermInInput:
           switch:
             - condition: '${"searchTerm" in input}'
               assign:
                 - searchTerm: '${input.searchTerm}'
               next: readWikipedia
       - getLocation:
           call: sys.get_env
           args:
             name: GOOGLE_CLOUD_LOCATION
           result: location
       - setFromCallResult:
           assign:
             - searchTerm: '${text.split(location, "-")[0]}'
       - readWikipedia:
           call: http.get
           args:
             url: 'https://en.wikipedia.org/w/api.php'
             query:
               action: opensearch
               search: '${searchTerm}'
           result: wikiResult
       - returnOutput:
           return: '${wikiResult.body[1]}'

   JSON

   {
     "main": {
       "params": [
         "input"
       ],
       "steps": [
         {
           "checkSearchTermInInput": {
             "switch": [
               {
                 "condition": "${\"searchTerm\" in input}",
                 "assign": [
                   {
                     "searchTerm": "${input.searchTerm}"
                   }
                 ],
                 "next": "readWikipedia"
               }
             ]
           }
         },
         {
           "getLocation": {
             "call": "sys.get_env",
             "args": {
               "name": "GOOGLE_CLOUD_LOCATION"
             },
             "result": "location"
           }
         },
         {
           "setFromCallResult": {
             "assign": [
               {
                 "searchTerm": "${text.split(location, \"-\")[0]}"
               }
             ]
           }
         },
         {
           "readWikipedia": {
             "call": "http.get",
             "args": {
               "url": "https://en.wikipedia.org/w/api.php",
               "query": {
                 "action": "opensearch",
                 "search": "${searchTerm}"
               }
             },
             "result": "wikiResult"
           }
         },
         {
           "returnOutput": {
             "return": "${wikiResult.body[1]}"
           }
         }
       ]
     }
   }
   

   A meno che non inserisci un termine di ricerca personalizzato, questo workflow utilizza la tua posizione diGoogle Cloud per creare un termine di ricerca, che viene trasmesso all'API Wikipedia. Viene restituito un elenco di articoli correlati di Wikipedia.

8. Seleziona Esegui il deployment.

Esegui il flusso di lavoro

Una volta eseguito il deployment del flusso di lavoro, puoi eseguirlo per la prima volta. Al termine del deployment del workflow, viene visualizzata la pagina Dettagli workflow.

1. Nella pagina Dettagli workflow, fai clic su Esegui.

2. Nella pagina Esegui workflow, fai clic su Esegui.

3. Nel riquadro Output vengono visualizzati i risultati del flusso di lavoro.

Hai eseguito il deployment e l'esecuzione del tuo primo flusso di lavoro.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

1. Nella console Google Cloud , vai alla pagina Workflow:

   Vai a Flussi di lavoro

2. Dall'elenco dei workflow, fai clic su un workflow per accedere alla pagina Dettagli del workflow.

3. Fai clic su Elimina.

4. Digita il nome del flusso di lavoro e poi fai clic su Conferma.

Passaggi successivi

• Aggiornare un flusso di lavoro esistente

• Controlla l'ordine di esecuzione in un flusso di lavoro

• Workflow di esempio

• Riferimento alla sintassi di Workflows