Membuat alur kerja menggunakan gcloud CLI

Panduan memulai ini menunjukkan cara membuat, men-deploy, dan menjalankan alur kerja pertama Anda menggunakan Google Cloud CLI. Contoh alur kerja mengirim permintaan ke API publik, lalu menampilkan respons API.

Untuk mengetahui daftar semua perintah CLI gcloud Workflows, lihat halaman referensi CLI gcloud Workflows.

Sebelum memulai

Batasan keamanan yang ditentukan oleh organisasi mungkin mencegah Anda menyelesaikan langkah-langkah berikut. Untuk mengetahui informasi pemecahan masalah, lihat Mengembangkan aplikasi di lingkungan Google Cloud yang terbatas.

  1. 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.
  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. Make sure that billing is enabled for your Google Cloud project.

  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. Make sure that billing is enabled for your Google Cloud project.

  10. Aktifkan Workflows API.

    gcloud services enable workflows.googleapis.com
  11. Buat akun layanan dan beri nama; misalnya, sa-name. 
    gcloud iam service-accounts create sa-name
  12. Untuk mengirim log ke Cloud Logging, berikan peran roles/logging.logWriter ke akun layanan. 
    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member "serviceAccount:sa-name@PROJECT_ID.iam.gserviceaccount.com" \
    --role "roles/logging.logWriter"

    Untuk mempelajari peran dan izin akun layanan lebih lanjut, lihat Memberikan izin alur kerja untuk mengakses resource Google Cloud.

Membuat, men-deploy, dan menjalankan alur kerja

  1. Di direktori utama, buat file baru bernama myFirstWorkflow.yaml atau myFirstWorkflow.json.

  2. Salin dan tempel alur kerja berikut ke dalam file baru, lalu simpan:

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

    Kecuali jika Anda memasukkan istilah penelusuran sendiri, alur kerja ini akan menggunakan lokasi Google Cloud Anda untuk membuat istilah penelusuran, yang diteruskan ke Wikipedia API. Daftar artikel Wikipedia terkait akan ditampilkan.

  3. Deploy alur kerja dan kaitkan dengan akun layanan yang ditentukan:

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

    Ganti kode berikut:

    • EXTENSION: ekstensi file untuk alur kerja Anda; gunakan yaml untuk versi YAML atau gunakan json untuk versi JSON
    • PROJECT_ID: project ID Anda

  4. Menjalankan alur kerja:

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

    Ganti SEARCH_TERM dengan istilah penelusuran Anda; misalnya, {"searchTerm":"North"}. Jika Anda memasukkan {}, lokasi Google Cloud Anda akan digunakan untuk membuat istilah penelusuran.

    Tindakan ini akan menampilkan hasil upaya eksekusi. Outputnya mirip dengan hal berikut ini:

    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

Anda telah men-deploy dan menjalankan alur kerja pertama Anda.

Pembersihan

Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan pada halaman ini, hapus project Google Cloud yang berisi resource tersebut.

  1. Hapus alur kerja yang Anda buat:

    gcloud workflows delete myFirstWorkflow

  2. Ketika ditanya apakah Anda ingin melanjutkan, tekan y.

Alur kerja akan dihapus.

Langkah selanjutnya