Creare un workflow utilizzando la Google Cloud console

Creare un workflow utilizzando la Google Cloud console

Questa guida rapida mostra come creare, sottoporre a deployment ed eseguire il tuo primo flusso di lavoro utilizzando la Google Cloud console. Il flusso di lavoro 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 Google Cloud console, 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 vincolato Google Cloud .

Accedi al tuo Google Cloud account. 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 Creatore account di servizio (roles/iam.serviceAccountCreator) e del ruolo Amministratore IAM progetto (roles/resourcemanager.projectIamAdmin). Scopri come concedere i ruoli.

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

      Vai a Crea account di servizio
   3. Seleziona il progetto.

   4. Nel campo Nome service account, inserisci un nome. La Google Cloud console 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 > Logs Writer 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 concedere ruoli aggiuntivi in un secondo momento.
   7. Fai clic su Continua.

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

Per saperne di più sui ruoli e sulle autorizzazioni dei account di servizio, consulta Concedere a un workflow l'autorizzazione ad accedere 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:

• Utente Service Account (roles/iam.serviceAccountUser)
• Amministratore Workflows (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 Google Cloud console vai alla pagina Workflows:

   Vai a Workflows

2. Nella pagina Workflows, 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 flusso di lavoro utilizza la tua Google Cloud posizione per creare un termine di ricerca che viene trasmesso a l'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 flusso di lavoro, 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.

Libera spazio

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

1. Nella Google Cloud console vai alla pagina Workflows:

   Vai a Workflows

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

3. Fai clic su Elimina.

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

Passaggi successivi

• Aggiornare un flusso di lavoro esistente

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

• Flussi di lavoro di esempio

• Riferimento alla sintassi di Workflows