Menjalankan alur kerja

Mengeksekusi alur kerja menjalankan definisi alur kerja saat ini yang terkait dengan alur kerja.

Anda dapat meneruskan argumen runtime dalam permintaan eksekusi alur kerja dan mengakses argumen tersebut menggunakan variabel alur kerja. Untuk mengetahui informasi selengkapnya, lihat Meneruskan argumen runtime dalam permintaan eksekusi.

Setelah eksekusi alur kerja selesai, histori dan hasilnya akan dipertahankan selama waktu terbatas. Untuk mengetahui informasi selengkapnya, lihat Kuota dan batas.

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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

  6. Jika alur kerja mengakses resource Google Cloud lain, pastikan alur kerja tersebut dikaitkan dengan akun layanan yang memiliki izin yang benar untuk melakukannya. Untuk mempelajari akun layanan yang dikaitkan dengan alur kerja yang ada, lihat Memverifikasi akun layanan yang dikaitkan dengan alur kerja.

    Perhatikan bahwa untuk membuat resource dan melampirkan akun layanan, Anda memerlukan izin untuk membuat resource tersebut dan untuk meniru identitas akun layanan yang akan Anda lampirkan ke resource. Untuk mengetahui informasi selengkapnya, lihat Izin akun layanan.

  7. Deploy alur kerja menggunakan konsolGoogle Cloud atau Google Cloud CLI.

Menjalankan alur kerja

Anda dapat menjalankan alur kerja dengan cara berikut:

  • Di konsol Google Cloud
  • Dengan menggunakan Google Cloud CLI di terminal atau Cloud Shell
  • Dengan mengirim permintaan langsung ke Workflows API

Anda juga dapat menjalankan alur kerja menggunakan Library Klien Cloud. Untuk mengetahui informasi selengkapnya, lihat Menjalankan alur kerja menggunakan Library Klien Cloud.

Konsol

  1. Untuk menjalankan alur kerja, di konsol Google Cloud , buka halaman Workflows:

    Buka Workflows

  2. Di halaman Workflows, pilih alur kerja untuk membuka halaman detailnya.

  3. Di halaman Workflow details, klik Execute.

  4. Di halaman Execute workflow, di panel Input, Anda dapat memasukkan argumen runtime opsional untuk diteruskan ke alur kerja sebelum dieksekusi. Argumen harus dalam format JSON ; misalnya, {"animal":"cat"}. Jika alur kerja Anda tidak menggunakan argumen runtime, biarkan kolom ini kosong.

  5. Jika ingin, tentukan level logging panggilan yang ingin Anda terapkan ke eksekusi alur kerja. Dalam daftar Level log panggilan, pilih salah satu opsi berikut:

    • Tidak ditentukan: tidak ada level logging yang ditentukan. Ini adalah setelan defaultnya. Level log eksekusi lebih diutamakan daripada level log alur kerja apa pun, kecuali jika level log eksekusi tidak ditentukan (default); dalam hal ini, level log alur kerja berlaku.
    • Hanya error: mencatat semua pengecualian yang tertangkap; atau saat panggilan dihentikan karena adanya suatu pengecualian.
    • Semua panggilan: catat semua panggilan ke sub-alur kerja atau fungsi library beserta hasilnya.
    • Tidak ada pencatatan: tidak ada logging panggilan.

  6. Secara opsional, tentukan tingkat histori eksekusi yang ingin Anda terapkan ke eksekusi alur kerja. Dalam daftar Execution history, pilih salah satu opsi berikut:

    • Warisi dari alur kerja: menerapkan setelan histori eksekusi alur kerja. Ini adalah setelan defaultnya.
    • Dasar: mengaktifkan histori eksekusi dasar.
    • Mendetail: mengaktifkan histori eksekusi mendetail termasuk nilai variabel dalam cakupan dan perkiraan jumlah iterasi.

  7. Klik Jalankan.

  8. Di halaman Detail eksekusi, Anda dapat melihat hasil eksekusi termasuk output, ID dan status eksekusi, serta langkah saat ini atau terakhir dari eksekusi alur kerja. Untuk mengetahui informasi selengkapnya, lihat Mengakses hasil eksekusi alur kerja.

gcloud

  1. Buka terminal.

  2. Temukan nama alur kerja yang ingin Anda jalankan. Jika tidak mengetahui nama alur kerja, Anda dapat memasukkan perintah berikut untuk mencantumkan semua alur kerja:

    gcloud workflows list

  3. Anda dapat menjalankan alur kerja menggunakan perintah gcloud workflows run atau gcloud workflows execute command:

    • Jalankan alur kerja dan tunggu hingga eksekusi selesai:

      gcloud workflows run WORKFLOW_NAME \
    --call-log-level=CALL_LOGGING_LEVEL \
    --execution-history-level="EXECUTION_HISTORY_LEVEL" \
    --data=DATA

    • Jalankan alur kerja tanpa menunggu hingga percobaan eksekusi selesai:

      gcloud workflows execute WORKFLOW_NAME \
    --call-log-level=CALL_LOGGING_LEVEL \
    --execution-history-level="EXECUTION_HISTORY_LEVEL" \
    --data=DATA

      Ganti kode berikut:

      • WORKFLOW_NAME: nama alur kerja.

      • CALL_LOGGING_LEVEL (opsional): level logging panggilan yang akan diterapkan selama eksekusi. Dapat berupa salah satu dari:

        • none: tidak ada level logging yang ditentukan. Ini adalah setelan defaultnya. Level log eksekusi lebih diutamakan daripada level log alur kerja apa pun, kecuali jika level log eksekusi tidak ditentukan (default); dalam hal ini, level log alur kerja berlaku.
        • log-errors-only: catat semua pengecualian yang tertangkap; atau saat panggilan dihentikan karena adanya pengecualian.
        • log-all-calls: catat semua panggilan ke sub-alur kerja atau fungsi library beserta hasilnya.
        • log-none: tidak ada logging panggilan.

      • EXECUTION_HISTORY_LEVEL (opsional): tingkat histori eksekusi yang akan diterapkan selama eksekusi. Dapat berupa salah satu dari:

        • none: tidak ada level histori eksekusi yang ditentukan. Ini adalah defaultnya. Jika tingkat histori eksekusi tidak ditentukan untuk eksekusi, tingkat tersebut ditentukan oleh tingkat yang diterapkan ke alur kerja. Jika levelnya berbeda, setelan yang diterapkan di tingkat eksekusi akan menggantikan setelan yang diterapkan di tingkat alur kerja untuk eksekusi ini.
        • execution-history-basic: mengaktifkan histori eksekusi dasar.
        • execution-history-detailed: mengaktifkan histori eksekusi mendetail termasuk nilai variabel dalam cakupan dan perkiraan jumlah iterasi.

      • DATA (opsional): argumen runtime untuk alur kerja dalam format JSON.

  4. Jika Anda menjalankan gcloud workflows execute, ID unik dari upaya eksekusi alur kerja akan ditampilkan dan outputnya akan mirip dengan berikut ini:

     To view the workflow status, you can use following command:
 gcloud workflows executions describe b113b589-8eff-4968-b830-8d35696f0b33 --workflow workflow-2 --location us-central1

    Untuk melihat status eksekusi, masukkan perintah yang ditampilkan oleh langkah sebelumnya.

Jika upaya eksekusi berhasil, outputnya akan mirip dengan berikut, dengan state yang menunjukkan keberhasilan alur kerja, dan status yang menentukan langkah alur kerja terakhir dari eksekusi. 

argument: '{"searchTerm":"Friday"}'
endTime: '2022-06-22T12:17:53.086073678Z'
name: projects/1051295516635/locations/us-central1/workflows/myFirstWorkflow/executions/c4dffd1f-13db-46a0-8a4a-ee39c144cb96
result: '["Friday","Friday the 13th (franchise)","Friday Night Lights (TV series)","Friday
    the 13th (1980 film)","Friday the 13th","Friday the 13th (2009 film)","Friday the
    13th Part III","Friday the 13th Part 2","Friday (Rebecca Black song)","Friday Night