本頁面由 Cloud Translation API 翻譯而成。

使用 gcloud CLI 建立工作流程

本快速入門導覽課程說明如何使用 Google Cloud CLI 建立、部署及執行您的第一項工作流程。範例工作流程會向公用 API 傳送要求，然後傳回 API 的回應。

如要查看所有 Workflows gcloud CLI 指令的清單，請參閱 Workflows gcloud CLI 參考頁面。

事前準備

貴機構定義的安全性限制，可能會導致您無法完成下列步驟。如需疑難排解資訊，請參閱「在受限的 Google Cloud 環境中開發應用程式」。

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

Install the Google Cloud CLI.

如果您使用外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

如要初始化 gcloud CLI，請執行下列指令：

gcloud init

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.

Verify that billing is enabled for your Google Cloud project.

Install the Google Cloud CLI.

如果您使用外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

如要初始化 gcloud CLI，請執行下列指令：

gcloud init

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.

Verify that billing is enabled for your Google Cloud project.

啟用 Workflows API。

gcloud services enable workflows.googleapis.com

建立服務帳戶並命名，例如 sa-name。

gcloud iam service-accounts create sa-name

如要將記錄檔傳送至 Cloud Logging，請將 roles/logging.logWriter 角色授予服務帳戶。
```
gcloud projects add-iam-policy-binding PROJECT_ID \
    --member "serviceAccount:sa-name@PROJECT_ID.iam.gserviceaccount.com" \
    --role "roles/logging.logWriter"
```
如要進一步瞭解服務帳戶角色和權限，請參閱授予工作流程存取Google Cloud 資源的權限。

建立、部署及執行工作流程

在主目錄中，建立名為 myFirstWorkflow.yaml 或 myFirstWorkflow.json 的新檔案。

複製以下工作流程並貼到新檔案中，然後儲存檔案：

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

除非您自行輸入搜尋字詞，否則工作流程會使用您的Google Cloud 位置建構搜尋字詞，並將搜尋字詞傳送至 Wikipedia API。系統會傳回相關的維基百科文章清單。

部署工作流程，並與指定的服務帳戶建立關聯：
```
gcloud workflows deploy myFirstWorkflow --source=myFirstWorkflow.EXTENSION \
    --service-account=sa-name@PROJECT_ID.iam.gserviceaccount.com
```
更改下列內容：
- EXTENSION：工作流程的副檔名；使用 yaml 代表 YAML 版本，或使用 json 代表 JSON 版本
- PROJECT_ID：您的專案 ID
注意： 在正式版環境中，強烈建議您建立新的服務帳戶，然後授予該帳戶權限最少的角色，允許服務帳戶存取必要資源。詳情請參閱服務帳戶。如需 Workflows 角色清單，請參閱「Workflows 角色和權限」。

執行工作流程：

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

將 SEARCH_TERM 替換為搜尋字詞，例如 {"searchTerm":"North"}。如果您輸入 {}，系統會使用您的 Google Cloud位置建構搜尋字詞。

這會傳回執行嘗試的結果。輸出內容會類似如下：

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

您已部署並執行第一項工作流程！

清除所用資源

如要避免系統向您的 Google Cloud 帳戶收取本頁面所用資源的費用，請刪除含有這些資源的 Google Cloud 專案。

刪除您建立的工作流程：

gcloud workflows delete myFirstWorkflow

系統詢問您是否要繼續時，請輸入 y。

工作流程已刪除。

使用 gcloud CLI 建立工作流程

事前準備

建立、部署及執行工作流程

YAML

JSON

清除所用資源

後續步驟