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.
- Google Cloud CLI をインストールします。
-
gcloud CLI を初期化するには:
gcloud init
-
Google Cloud プロジェクトを作成または選択します。
-
Google Cloud プロジェクトを作成します。
gcloud projects create PROJECT_ID
PROJECT_ID
は、作成する Google Cloud プロジェクトの名前に置き換えます。 -
作成した Google Cloud プロジェクトを選択します。
gcloud config set project PROJECT_ID
PROJECT_ID
は、実際の Google Cloud プロジェクト名に置き換えます。
-
- Google Cloud CLI をインストールします。
-
gcloud CLI を初期化するには:
gcloud init
-
Google Cloud プロジェクトを作成または選択します。
-
Google Cloud プロジェクトを作成します。
gcloud projects create PROJECT_ID
PROJECT_ID
は、作成する Google Cloud プロジェクトの名前に置き換えます。 -
作成した Google Cloud プロジェクトを選択します。
gcloud config set project PROJECT_ID
PROJECT_ID
は、実際の Google Cloud プロジェクト名に置き換えます。
-
ワークフロー 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
JSON
独自の検索キーワードを入力する場合を除き、このワークフローにより Google Cloud のロケーションを使用して検索キーワードが作成され、これが Wikipedia API に渡されます。関連する Wikipedia の記事のリストが返されます。
ワークフローをデプロイし、指定されたサービス アカウントに関連付けます。
gcloud workflows deploy myFirstWorkflow --source=myFirstWorkflow.EXTENSION \ --service-account=sa-name@PROJECT_ID.iam.gserviceaccount.com
次のように置き換えます。
EXTENSION
: ワークフローのファイル拡張子。YAML バージョンにはyaml
を使用し、JSON バージョンにはjson
を使用するPROJECT_ID
: プロジェクト ID
ワークフローを実行します。
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
」と入力します。
ワークフローが削除されます。