Crea un workflow utilizzando la Google Cloud console

Crea un workflow utilizzando la Google Cloud console

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

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 serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). 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 serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). 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 Google Cloud console vai alla pagina Crea account di servizio.

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

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

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

   5. Fai clic su Crea e continua.

   6. Concedi il ruolo Logging > Logs Writer all'account di servizio.

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

      Nota: il campo Ruolo influisce sulle risorse a cui l'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 dell'account di servizio.

Per saperne di più sui ruoli e sulle autorizzazioni degli 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 account di servizio (roles/iam.serviceAccountUser)
• Amministratore di 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 workflow

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

   Vai a Flussi di lavoro

2. Nella pagina Workflow, fai clic su Crea.

3. Inserisci un nome per il nuovo workflow, ad esempio myFirstWorkflow.

4. Scegli us-central1 per la regione.

5. Per Account di servizio, seleziona l'account di servizio che hai creato in precedenza.

6. Seleziona Avanti.

7. Nell'editor di workflow, copia e incolla il seguente workflow:

   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 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 workflow

Una volta eseguito il deployment del workflow, 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 workflow.

Hai eseguito il deployment e l'esecuzione del tuo primo workflow.

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 Workflow:

   Vai a Flussi di lavoro

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 workflow e fai clic su Conferma.

Passaggi successivi

• Aggiorna un workflow esistente

• Controlla l'ordine di esecuzione in un workflow

• Workflow di esempio

• Riferimento alla sintassi di Workflows