Crea un flusso di lavoro utilizzando gcloud CLI

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

Per un elenco di tutti i comandi della gcloud CLI di Workflows, consulta la gcloud CLI di Workflows pagina di riferimento.

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.

  1. 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 gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
  2. Install the Google Cloud CLI.

  3. To initialize the gcloud CLI, run the following command: 

    gcloud init

  4. Create or select a Google Cloud project.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

  5. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  6. Install the Google Cloud CLI.

  7. To initialize the gcloud CLI, run the following command: 

    gcloud init

  8. Create or select a Google Cloud project.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

  9. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  10. Abilitare l'API Workflows.

    gcloud services enable workflows.googleapis.com
  11. Creare l'account di servizio e assegnargli un nome. ad esempio sa-name. 
    gcloud iam service-accounts create sa-name
  12. Per inviare i log a Cloud Logging, concedi roles/logging.logWriter di servizio all'account di servizio. 
    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member "serviceAccount:sa-name@PROJECT_ID.iam.gserviceaccount.com" \
    --role "roles/logging.logWriter"

    Per scoprire di più sui ruoli e sulle autorizzazioni degli account di servizio, consulta Concedi l'autorizzazione di accesso a un flusso di lavoro di Google Cloud.

Crea, esegui il deployment ed esegui un flusso di lavoro

  1. Nella tua directory home, crea un nuovo file denominato myFirstWorkflow.yaml o myFirstWorkflow.json.

  2. Copia e incolla il seguente flusso di lavoro nel nuovo file, quindi salvalo:

    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]}"
        }
      }
    ]
  }
}

    Se non inserisci un termine di ricerca, questo flusso di lavoro utilizza il Località di Google Cloud per creare un termine di ricerca, che passa a l'API di Wikipedia. Un elenco di vengono restituiti gli articoli di Wikipedia correlati.

  3. Esegui il deployment del flusso di lavoro e associalo all'account di servizio specificato:

    gcloud workflows deploy myFirstWorkflow --source=myFirstWorkflow.EXTENSION \
    --service-account=sa-name@PROJECT_ID.iam.gserviceaccount.com

    Sostituisci quanto segue:

    • EXTENSION: l'estensione del file per il flusso di lavoro; usa yaml per la versione YAML o json per la versione JSON
    • PROJECT_ID: il tuo ID progetto
    di Gemini Advanced.

  4. Esegui il flusso di lavoro:

    gcloud workflows run myFirstWorkflow \
    --data='SEARCH_TERM'

    Sostituisci SEARCH_TERM con il termine di ricerca. ad esempio {"searchTerm":"North"}. Se inserisci {}, il tuo account Google Cloud località viene utilizzata per costruire un termine di ricerca.

    Vengono restituiti i risultati del tentativo di esecuzione. L'output è simile a le seguenti:

    argument: '{"searchTerm":"North"}'
duration: 0.210616856s
endTime: '2023-05-10T21:56:39.465899376Z'
name: projects/734581694262/locations/us-central1/workflows/workflow-1/executions/eae31f11-a5c3-47e2-8014-05b400820a79
result: '["North","North America","Northern Ireland","North Korea","North Macedonia","North
  Carolina","Northrop Grumman B-2 Spirit","Northrop F-5","Northern Cyprus","North
  Dakota"]'
startTime: '2023-05-10T21:56:39.255282520Z'
state: SUCCEEDED
status:
  currentSteps:
  - routine: main
    step: returnOutput
workflowRevisionId: 000001-ac2

Hai eseguito il deployment ed eseguito il tuo primo flusso di lavoro.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi per le risorse utilizzate in questa pagina, elimina il progetto Google Cloud Google Cloud.

  1. Elimina il flusso di lavoro creato:

    gcloud workflows delete myFirstWorkflow

  2. Quando ti viene chiesto se vuoi continuare, digita y.

Il flusso di lavoro viene eliminato.

Passaggi successivi