Produk virtual machine (VM) yang ditawarkan melalui Google Cloud Marketplace adalah instance VM kustom yang dapat Anda jalankan di Compute Engine. Untuk mengetahui ringkasan tentang konsep Compute Engine, buka dokumentasi Compute Engine.
Beberapa produk VM di Google Cloud Marketplace mendukung deployment melalui antarmuka command line (CLI) menggunakan Terraform, alat open source untuk menyediakan dan mengelola infrastruktur. Untuk mengetahui informasi selengkapnya tentang Terraform, buka Mulai menggunakan Terraform.
Ringkasan
Halaman ini menjelaskan langkah-langkah untuk men-deploy produk VM melalui CLI menggunakan Terraform. Pada dasarnya, Anda:
Buka bagian yang relevan di listingan Google Cloud Marketplace produk.
Secara opsional, pilih atau buat akun layanan yang ingin Anda gunakan untuk deployment command line.
Secara opsional, siapkan peniruan identitas akun layanan.
Konfigurasi lingkungan
gclouduntuk Terraform.Download cuplikan kode atau modul Terraform yang Anda gunakan untuk men-deploy produk VM melalui CLI.
Gunakan modul atau cuplikan kode untuk men-deploy produk VM.
Buka tab deployment command line
Untuk mulai men-deploy produk VM melalui CLI:
Di Cloud Marketplace, buka halaman listingan produk untuk produk VM yang ingin Anda deploy melalui CLI.
Klik tombol Launch, atau klik Deploy with CLI untuk membuka tab Command-line deployment.
(Opsional) Pilih atau buat akun layanan Anda
Di tab Deployment command line, Anda dapat memilih untuk memilih atau membuat akun layanan yang ingin digunakan untuk deployment command line. Jika Anda belum memilih atau membuat akun layanan di tab Command-line deployment saat membuat cuplikan kode, Anda harus mengedit cuplikan Terraform yang dibuat secara manual untuk menambahkan akun layanan sebelum menggunakannya. Untuk mengetahui informasi selengkapnya tentang akun layanan, buka Membuat dan mengelola akun layanan.
Jika Anda ingin men-deploy produk VM Cloud Marketplace melalui CLI, akun layanan yang Anda gunakan harus memiliki peran Identity and Access Management (IAM) Compute Admin (roles/compute.admin).
Jika Anda membuat akun layanan baru dari tab Deployment command line,
Google Cloud Marketplace akan otomatis memberikan peran ini ke akun layanan baru. Jika
Anda memilih akun layanan yang ada dari tab Deployment command line,
Anda harus memverifikasi bahwa akun layanan tersebut memiliki peran ini.
Untuk memilih atau membuat akun layanan Anda:
Dari tab Command-line deployment di listingan Google Cloud Marketplace produk VM, di bagian Configure a service account (optional), klik tombol Configure.
Di bagian Akun layanan yang meminta izin, Anda dapat mengklik untuk Pilih akun layanan yang ada, atau Buat akun layanan baru.
Pilih akun layanan yang ada
Untuk memilih akun layanan yang ada:
Di bagian Pilih akun layanan, pilih akun layanan yang ingin Anda gunakan. Daftar ini berisi semua akun layanan yang sudah ada dan memiliki peran Compute Admin (
roles/compute.admin).Jika tidak ada akun layanan yang sudah ada yang memiliki peran Compute Admin (
roles/compute.admin), daftar akan kosong. Jika daftar kosong, Anda dapat memberikan peran ini ke salah satu akun layanan yang ada, lalu kembali ke tab ini, atau Anda dapat memilih untuk membuat akun layanan baru.Klik tombol Submit.
Buat akun layanan baru
Untuk membuat akun layanan baru:
Pilih nama untuk akun layanan Anda, lalu tambahkan di kolom Nama akun layanan.
Pilih ID untuk akun layanan Anda, lalu tambahkan di kolom Service account ID.
Tambahkan deskripsi untuk akun layanan Anda ke kolom Deskripsi akun layanan.
Klik tombol Create service account.
Setelah membuat akun layanan, Anda dapat melanjutkan pengelolaan kontrol akses akun layanan menggunakan IAM.
(Opsional) Menyiapkan peniruan identitas akun layanan
Sebaiknya gunakan peniruan identitas akun layanan untuk mengelola akses ke deployment command line Anda. Jika Anda menggunakan peniruan, alih-alih membuat
kunci akun layanan yang dapat digunakan siapa saja untuk mengakses deployment Anda, Anda mengelola
akses dengan memberikan atau mencabut
peran IAM Service Account Token Creator (roles/iam.serviceAccountTokenCreator)
kepada akun utama tertentu.
Untuk mempelajari cara memberikan dan mencabut peran di akun layanan, lihat Mengelola akses ke akun layanan. Untuk mempelajari peniruan identitas akun layanan lebih lanjut, lihat Peniruan identitas akun layanan.
Mengonfigurasi lingkungan gcloud untuk Terraform
Di tab Deployment command line, di bagian Konfigurasi gcloud, Anda akan melihat serangkaian perintah. Untuk mengonfigurasi lingkungan gcloud untuk Terraform, Anda dapat menyalin dan menjalankan perintah yang diberikan.
Download modul Terraform
Anda menggunakan modul Terraform yang disertakan atau cuplikan kode yang dibuat untuk men-deploy produk VM melalui CLI, bergantung pada cara produk VM dikonfigurasi. Untuk memverifikasi apakah Anda menggunakan modul yang disertakan atau cuplikan kode yang dihasilkan untuk men-deploy produk VM, buka tab Deployment command line di listingan Cloud Marketplace produk. Jika Anda menggunakan modul yang disertakan untuk men-deploy produk, Anda akan melihat tombol Download. Jika Anda menggunakan cuplikan kode yang dibuat untuk men-deploy produk, Anda akan melihat tombol Buat kode.
Untuk mendownload modul yang disertakan atau cuplikan kode yang dihasilkan, selesaikan langkah-langkah berikut:
Modul Terraform yang disertakan
Dari tab Deployment command line pada listingan Cloud Marketplace produk VM, klik tombol Download. Perintah ini mendownload file zip yang berisi modul Terraform yang Anda gunakan.
Ekstrak modul Terraform dari file zip yang Anda download.
Cuplikan kode yang dihasilkan
Dari tab Command-line deployment pada listingan Cloud Marketplace produk VM, klik tombol Generate code. Tindakan ini akan membuat cuplikan kode yang dapat Anda salin dan gunakan dengan Terraform untuk men-deploy VM dengan Terraform.
Untuk menyalin cuplikan kode yang dihasilkan, klik Salin ke papan klip.
Gunakan modul yang disertakan atau cuplikan kode yang dihasilkan untuk men-deploy produk VM
Untuk menggunakan modul yang disertakan atau cuplikan kode yang dihasilkan untuk men-deploy produk VM melalui CLI, selesaikan langkah-langkah berikut:
Modul Terraform yang disertakan
Di modul Terraform yang Anda download, temukan file
README.md.Ikuti petunjuk khusus produk dari file
README.md.Saat Anda mengikuti petunjuk khusus produk, jika mengalami masalah, Anda dapat mencoba men-deploy modul dengan menjalankan perintah berikut:
terraform initterraform apply
Cuplikan kode yang dihasilkan
Pastikan cuplikan kode yang dihasilkan menyertakan akun layanan yang ingin Anda gunakan. Jika Anda telah mengonfigurasi akun layanan untuk deployment command line, informasi akun layanan tersebut akan disertakan dalam cuplikan kode yang dihasilkan. Jika belum mengonfigurasi akun layanan, Anda harus mengedit cuplikan kode yang dihasilkan untuk menentukan akun layanan yang ingin digunakan.
Buat file baru bernama
main.tfdi komputer tempat Anda menginstal Terraform.Tempelkan cuplikan kode yang dihasilkan, beserta pengeditan yang telah Anda lakukan, ke dalam file
main.tfyang Anda buat.Jalankan perintah berikut:
terraform initterraform apply
Langkah berikutnya
Untuk mengetahui informasi tentang cara mengelola deployment CLI produk VM, buka Mengelola deployment CLI produk VM.