Menyediakan resource Agent Platform Workbench dengan Terraform

HashiCorp Terraform adalah alat infrastruktur sebagai kode (IaC) yang memungkinkan Anda menyediakan dan mengelola infrastruktur cloud. Terraform menyediakan plugin yang disebut penyedia yang memungkinkan Anda berinteraksi dengan penyedia cloud dan API lainnya. Anda dapat menggunakan penyedia Terraform untuk Google Cloud guna menyediakan dan mengelola resource Google Cloud , termasuk Agent Platform Workbench.

Halaman ini memperkenalkan cara menggunakan Terraform dengan Agent Platform Workbench, termasuk pengantar cara kerja Terraform dan beberapa resource untuk membantu Anda mulai menggunakan Terraform dengan Google Cloud. Anda juga akan menemukan link ke dokumen referensi Terraform untuk Agent Platform Workbench, contoh kode, dan panduan penggunaan Terraform untuk menyediakan resource Agent Platform Workbench.

Untuk mengetahui petunjuk tentang cara mulai menggunakan Terraform untuk Google Cloud, lihat Menginstal dan mengonfigurasi Terraform atau Mulai cepat Terraform untuk Google Cloud .

Cara kerja Terraform

Terraform memiliki sintaksis deklaratif dan berorientasi konfigurasi yang dapat Anda gunakan untuk mendeskripsikan infrastruktur yang ingin Anda sediakan di Google Cloud project Anda. Setelah menulis konfigurasi ini di satu atau beberapa file konfigurasi Terraform, Anda dapat menggunakan Terraform CLI untuk menerapkan konfigurasi ini ke resource Agent Platform Workbench Anda.

Langkah-langkah berikut menjelaskan cara kerja Terraform:

  1. Anda menjelaskan infrastruktur yang ingin Anda sediakan dalam file konfigurasi Terraform. Anda tidak perlu menulis kode yang menjelaskan cara menyediakan infrastruktur. Terraform menyediakan infrastruktur untuk Anda.
  2. Anda menjalankan perintah terraform plan, yang mengevaluasi konfigurasi dan membuat rencana eksekusi. Anda dapat meninjau rencana dan membuat perubahan sesuai kebutuhan.

  3. Anda menjalankan perintah terraform apply, yang melakukan tindakan berikut:

    1. Layanan ini menyediakan infrastruktur Anda berdasarkan rencana eksekusi dengan memanggil API Agent Platform Workbench yang sesuai di latar belakang.
    2. File ini membuat file status Terraform, yang merupakan file JSON yang memetakan resource dalam file konfigurasi Anda ke resource dalam infrastruktur dunia nyata. Terraform menggunakan file ini untuk mencatat status terbaru infrastruktur Anda, dan untuk menentukan kapan harus membuat, mengupdate, dan menghancurkan resource.

    3. Saat Anda menjalankan terraform apply, Terraform menggunakan pemetaan dalam file status untuk membandingkan infrastruktur yang ada dengan kode, dan melakukan update sesuai kebutuhan:

      • Jika objek resource ditentukan dalam file konfigurasi, tetapi tidak ada dalam file status, Terraform akan membuatnya.
      • Jika objek resource ada dalam file status, tetapi memiliki konfigurasi yang berbeda dari file konfigurasi Anda, Terraform akan memperbarui resource agar sesuai dengan file konfigurasi Anda.
      • Jika objek resource dalam file status cocok dengan file konfigurasi Anda, Terraform tidak akan mengubah resource.

Resource Terraform untuk Agent Platform Workbench

Resource adalah elemen dasar dalam bahasa Terraform. Setiap blok resource menjelaskan satu atau beberapa objek infrastruktur, seperti jaringan virtual atau instance komputasi.

Tabel berikut mencantumkan resource Terraform yang tersedia untuk Agent Platform Workbench:

Layanan Resource Terraform Sumber data
Workbench Platform Agen google_workbench_instance_iam_policy

Panduan berbasis Terraform untuk Agent Platform Workbench

Tabel berikut mencantumkan panduan dan tutorial cara penggunaan berbasis Terraform untuk Agent Platform Workbench:

Panduan Detail
Membuat instance Agent Platform Workbench Buat instance Agent Platform Workbench dengan konfigurasi dasar.
Mengelola penonaktifan saat tidak ada aktivitas di Terraform Konfigurasi setelan penonaktifan saat tidak ada aktivitas di instance Agent Platform Workbench.
Mengupgrade penampung kustom Ubah kolom container_image di konfigurasi Terraform untuk memperbarui payload container.
Membuat instance dengan metadata tertentu Buat instance Agent Platform Workbench dengan metadata tertentu.

Modul dan blueprint Terraform untuk Agent Platform Workbench

Modul dan blueprint membantu Anda mengotomatiskan penyediaan dan pengelolaan Google Cloud resource dalam skala besar. Modul adalah kumpulan file konfigurasi Terraform yang dapat digunakan kembali dan membuat abstraksi logis resource Terraform. Blueprint adalah paket modul yang dapat di-deploy dan dapat digunakan kembali, serta kebijakan yang menerapkan dan mendokumentasikan solusi tertentu.

Tabel berikut mencantumkan modul dan blueprint yang terkait dengan Agent Platform Workbench:

Modul atau blueprint Detail
ai-notebook Modul ini menunjukkan cara melindungi data rahasia di instance Agent Platform Workbench.

Langkah berikutnya