Membuat alur kerja menggunakan gcloud CLI

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 mengirimkan permintaan ke API publik lalu menampilkan respons API.

Untuk mengetahui daftar semua perintah gcloud CLI Workflows, lihat halaman referensi gcloud CLI 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. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
2. Menginstal Google Cloud CLI.

3. Untuk initialize gcloud CLI, jalankan perintah berikut:

   gcloud init

4. Buat atau pilih project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   • Membuat project Google Cloud:

     gcloud projects create PROJECT_ID

     Ganti PROJECT_ID dengan nama untuk project Google Cloud yang Anda buat.

   • Pilih project Google Cloud yang Anda buat:

     gcloud config set project PROJECT_ID

     Ganti PROJECT_ID dengan nama project Google Cloud Anda.

5. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

6. Menginstal Google Cloud CLI.

7. Untuk initialize gcloud CLI, jalankan perintah berikut:

   gcloud init

8. Buat atau pilih project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   • Membuat project Google Cloud:

     gcloud projects create PROJECT_ID

     Ganti PROJECT_ID dengan nama untuk project Google Cloud yang Anda buat.

   • Pilih project Google Cloud yang Anda buat:

     gcloud config set project PROJECT_ID

     Ganti PROJECT_ID dengan nama project Google Cloud Anda.

9. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

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, baca bagian 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 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 menggunakan lokasi Google Cloud Anda untuk membuat istilah penelusuran, yang akan diteruskan ke Wikipedia API. Daftar artikel Wikipedia terkait akan ditampilkan.

3. Men-deploy alur kerja dan mengaitkannya 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
   Catatan: Di lingkungan produksi, sebaiknya buat akun layanan baru, lalu berikan peran yang paling tidak permisif sehingga memungkinkan akun layanan mengakses resource yang diperlukan. Untuk mempelajari lebih lanjut, lihat Akun layanan. Untuk daftar peran alur kerja, lihat Peran dan izin alur kerja.

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 dihapus.

Langkah selanjutnya

• Memperbarui alur kerja yang ada

• Mengontrol urutan eksekusi dalam alur kerja

• Contoh alur kerja

• Referensi sintaksis Workflows