Membuat alur kerja menggunakan Terraform

Membuat alur kerja menggunakan Terraform

Panduan memulai ini menunjukkan cara membuat, men-deploy, dan menjalankan alur kerja pertama Anda menggunakan Terraform. Terraform adalah alat infrastruktur sebagai kode yang memungkinkan Anda membuat, mengubah, dan meningkatkan infrastruktur cloud Anda secara prediktif menggunakan kode. Pelajari cara menggunakan Terraform untuk menyediakan infrastruktur di Google Cloud.

Dalam panduan memulai ini, alur kerja contoh mengirim permintaan ke API publik, lalu menampilkan respons API.

Anda akan menyelesaikan langkah berikut:

1. Mengaktifkan Workflows API menggunakan Terraform.
2. Buat akun layanan untuk alur kerja menggunakan Terraform.
3. Menentukan dan men-deploy alur kerja menggunakan Terraform.
4. Menjalankan alur kerja menggunakan Google Cloud CLI.

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.

Perlu diperhatikan bahwa Cloud Shell memiliki Terraform yang sudah terintegrasi. Jika Anda perlu menginstal Terraform, baca dokumentasi Terraform HashiCorp.

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. Enable the Cloud Resource Manager and Identity and Access Management (IAM) APIs:

   gcloud services enable cloudresourcemanager.googleapis.com iam.googleapis.com

7. Menginstal Google Cloud CLI.

8. Untuk initialize gcloud CLI, jalankan perintah berikut:

   gcloud init

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

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

11. Enable the Cloud Resource Manager and Identity and Access Management (IAM) APIs:

    gcloud services enable cloudresourcemanager.googleapis.com iam.googleapis.com

Membuat file konfigurasi Terraform

Buat file konfigurasi Terraform bernama main.tf dan sertakan resource Penyedia Google untuk Terraform yang digunakan dalam panduan memulai ini.

Perhatikan bahwa Anda dapat menggunakan interpolasi untuk substitusi seperti variabel referensi, atribut resource, dan fungsi panggilan.

1. Buat direktori:

   mkdir terraform

2. Buka direktori terraform:

   cd terraform

3. Tambahkan file baru, main.tf, ke direktori:

   nano main.tf

4. Tambahkan resource berikut ke file main.tf:

   1. Tetapkan ID project:

      provider "google" {
      project = "PROJECT_ID"
      }

      Ganti PROJECT_ID dengan ID project Anda.

   2. Aktifkan Workflows API:

      # Enable Workflows API
      resource "google_project_service" "default" {
        service            = "workflows.googleapis.com"
        disable_on_destroy = false
      }

   3. Buat akun layanan untuk alur kerja:

      # Create a dedicated service account
      resource "google_service_account" "default" {
        account_id   = "sample-workflows-sa"
        display_name = "Sample Workflows Service Account"
      }

   4. Tentukan alur kerja menggunakan resource google_workflows_workflow:

      Penting: Saat Anda menentukan alur kerja di Terraform, variabel harus di-escape dengan $${...}, bukan ${...}.

      # Create a workflow
      resource "google_workflows_workflow" "default" {
        name            = "sample-workflow"
        region          = "us-central1"
        description     = "A sample workflow"
        service_account = google_service_account.default.id
        labels = {
          env = "test"
        }
        user_env_vars = {
          url = "https://timeapi.io/api/Time/current/zone?timeZone=Europe/Amsterdam"
        }
        source_contents = <<-EOF
        # This is a sample workflow that you can replace with your source code
        #
        # The workflow does the following:
        # - Retrieves the current date from a public API and stores the
        #   response in `currentDate`
        # - Retrieves a list of Wikipedia articles from a public API related
        #   to the day of the week stored in `currentDate`
        # - Returns the list of articles in the workflow output
        #
        # Note that when you define workflows in Terraform, variables must be
        # escaped with two dollar signs ($$) and not a single sign ($)
      
        - getCurrentDate:
            call: http.get
            args:
                url: $${sys.get_env("url")}
            result: currentDate
        - readWikipedia:
            call: http.get
            args:
                url: https://en.wikipedia.org/w/api.php
                query:
                    action: opensearch
                    search: $${currentDate.body.dayOfWeek}
            result: wikiResult
        - returnOutput:
            return: $${wikiResult.body[1]}
      EOF
      
        depends_on = [google_project_service.default]
      }

      Argumen berikut digunakan dalam contoh alur kerja:

      • name: nama alur kerja Anda.
      • region: lokasi alur kerja Anda.
      • description: deskripsi alur kerja Anda.
      • service_account: alamat email atau ID unik akun layanan yang terkait dengan versi alur kerja terbaru. Akun layanan ini merepresentasikan identitas alur kerja dan menentukan izin yang dimiliki alur kerja tersebut. Jika Anda tidak menentukan akun layanan selama pembuatan alur kerja, alur kerja tersebut akan menggunakan akun layanan Compute Engine default untuk identitasnya. Untuk mengetahui informasi selengkapnya, lihat bagian Memberikan izin alur kerja untuk mengakses resource Google Cloud.
      • labels: daftar pasangan label nilai kunci yang akan ditetapkan ke alur kerja ini yang membantu Anda mengatur instance Google Cloud. Untuk mengetahui informasi selengkapnya, lihat Apa yang dimaksud dengan label?
      • user_env_vars: variabel lingkungan buatan pengguna yang terkait dengan revisi alur kerja ini. Untuk mengetahui informasi selengkapnya, lihat Menggunakan variabel lingkungan.
      • source_contents: kode Workflows yang akan dieksekusi. Untuk batas ukuran file, lihat Batas resource.

      Argumen opsional lainnya meliputi:

      • crypto_key_name: ID resource untuk kunci Cloud Key Management Service dalam format berikut:

        projects/PROJECT_NAME/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME

        Untuk informasi selengkapnya, lihat Menggunakan kunci enkripsi yang dikelola pelanggan.

      • call_log_level: level logging yang akan diterapkan pada panggilan dan respons panggilan selama eksekusi alur kerja ini. Nilainya dapat berupa:

        • CALL_LOG_LEVEL_UNSPECIFIED
        • LOG_ALL_CALLS
        • LOG_ERRORS_ONLY
        • LOG_NONE

        Untuk mengetahui informasi lebih lanjut, lihat Logging panggilan.

      • project: ID project tempat resource berada. Jika tidak disediakan, project penyedia akan digunakan.

      • name_prefix: membuat nama unik yang dimulai dengan awalan yang ditentukan. Jika atribut ini dan name tidak ditentukan, nilai acak akan dipilih untuk nama tersebut.

Membuat dan menjalankan alur kerja

Deploy resource Terraform Anda untuk membuat alur kerja, lalu menjalankan alur kerja tersebut.

1. Lakukan inisialisasi Terraform di direktori:

   terraform init
   

2. Pastikan perubahan yang Anda usulkan dengan Terraform sesuai dengan rencana yang diharapkan:

   terraform plan
   

   Anda dapat mengabaikan catatan tentang tidak menggunakan opsi -out.

3. Buat alur kerja:

   terraform apply
   

4. Pada perintah Enter a value, ketik yes untuk melanjutkan pembuatan resource.

5. Pastikan alur kerja dibuat:

   gcloud workflows list --location us-central1
   

   Outputnya akan mirip dengan berikut ini:

   NAME                                                                    STATE   REVISION_ID  UPDATE_TIME
   projects/project-name/locations/us-central1/workflows/sample-workflow   ACTIVE  000001-f9a   2024-02-24T13:38:58.353765906Z
   

6. Secara opsional, Anda dapat menjalankan alur kerja:

   gcloud workflows execute sample-workflow
   

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 semua resource yang Anda buat dengan Terraform:

   terraform destroy

2. Hapus alur kerja yang Anda buat:

   gcloud workflows delete sample-workflow

   Ketika ditanya apakah Anda ingin melanjutkan, tekan y.
3. Atau, Anda dapat menghapus project Google Cloud Anda untuk menghindari tagihan. Menghapus project Google Cloud akan menghentikan penagihan untuk semua resource yang digunakan dalam project tersebut.
   Perhatian: Menghapus project memiliki efek berikut:
   • Semua hal dalam project akan dihapus. Jika menggunakan project yang sudah ada untuk tugas dalam dokumen ini, saat Anda menghapusnya, pekerjaan lain yang telah Anda lakukan dalam project tersebut juga akan terhapus.
   • Project ID kustom hilang. Saat membuat project ini, Anda mungkin telah membuat project ID kustom yang ingin digunakan di masa mendatang. Untuk mempertahankan URL yang menggunakan project ID, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.

   Menghapus project Google Cloud:

   gcloud projects delete PROJECT_ID

Langkah selanjutnya

• Mengontrol urutan eksekusi dalam alur kerja.

• Memperbarui alur kerja yang ada.

• Pelajari contoh alur kerja.

• Pelajari sintaksis Workflows lebih lanjut.