Men-deploy produk virtual machine (VM) menggunakan antarmuka command line (CLI)

Produk virtual machine (VM) yang ditawarkan melalui Google Cloud Marketplace adalah instance VM kustom yang dapat Anda jalankan di Compute Engine. Untuk ringkasan konsep Compute Engine, baca dokumentasi Compute Engine.

Beberapa produk VM di Google Cloud Marketplace mendukung deployment melalui antarmuka command line (CLI) menggunakan Terraform, yakni 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. Secara umum, Anda:

  1. Buka bagian yang relevan pada listingan Google Cloud Marketplace produk.

  2. Secara opsional, pilih atau buat akun layanan yang ingin Anda gunakan untuk deployment command line.

  3. Anda juga dapat menyiapkan peniruan akun layanan.

  4. Konfigurasi lingkungan gcloud Anda untuk Terraform.

  5. Download modul atau cuplikan kode Terraform yang Anda gunakan untuk men-deploy produk VM melalui CLI.

  6. Gunakan modul atau cuplikan kode untuk men-deploy produk VM.

Buka tab deployment command line

Untuk mulai men-deploy produk VM melalui CLI:

  1. Di Cloud Marketplace, buka halaman listingan produk untuk produk VM yang ingin Anda deploy melalui CLI.

    Buka Marketplace

  2. Klik tombol Launch, atau klik Deploy with CLI untuk membuka tab Command-line deployment.

(Opsional) Pilih atau buat akun layanan Anda

Dalam tab Command-line deployment, Anda dapat memilih atau membuat akun layanan yang ingin digunakan untuk deployment command line. Jika belum memilih atau membuat akun layanan di tab Command-line deployment saat membuat cuplikan kode, Anda harus mengedit cuplikan Terraform yang dihasilkan secara manual untuk menambahkan akun layanan sebelum menggunakannya. Untuk 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) Admin Compute (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 memilih akun layanan yang ada dari tab Deployment command line, Anda harus memverifikasi bahwa akun layanan memiliki peran ini.

Untuk memilih atau membuat akun layanan:

  1. Dari tab Command-line deployment di listingan Google Cloud Marketplace produk VM, di bagian Configure a service account (optional), klik tombol Configure.

  2. Di bagian Service account requests permissions, Anda dapat mengklik Select an existing service account, atau Create a new service account.

Pilih akun layanan yang ada

Untuk memilih akun layanan yang ada:

  1. Di bagian Select a service account, pilih akun layanan yang ingin Anda gunakan. Daftar ini berisi semua akun layanan Anda yang ada yang memiliki peran Compute Admin (roles/compute.admin).

    Jika tidak ada akun layanan Anda yang memiliki peran Compute Admin (roles/compute.admin), daftar ini 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.

  2. Klik tombol Kirim.

Buat akun layanan baru

Untuk membuat akun layanan baru:

  1. Pilih nama untuk akun layanan Anda, dan tambahkan di kolom Nama akun layanan.

  2. Pilih ID untuk akun layanan Anda, dan tambahkan di kolom ID akun layanan.

  3. Tambahkan deskripsi untuk akun layanan Anda di kolom Service account description.

  4. Klik tombol Create service account.

Setelah membuat akun layanan, Anda dapat terus mengelola kontrol akses akun layanan menggunakan IAM.

(Opsional) Menyiapkan peniruan akun layanan

Sebaiknya gunakan peniruan akun layanan untuk mengelola akses ke deployment command line Anda. Jika Anda menggunakan peniruan identitas, Anda tidak perlu membuat kunci akun layanan yang dapat digunakan siapa pun untuk mengakses deployment Anda. Namun, Anda dapat 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 lebih lanjut peniruan akun layanan, lihat Peniruan identitas akun layanan.

Mengonfigurasi lingkungan gcloud untuk Terraform

Di tab Command-line deployment, di bagian Configure gcloud, Anda melihat serangkaian perintah. Guna mengonfigurasi lingkungan gcloud untuk Terraform, Anda dapat menyalin dan menjalankan perintah yang diberikan.

Download modul Terraform

Anda dapat menggunakan modul Terraform yang disertakan atau cuplikan kode yang dihasilkan untuk men-deploy produk VM melalui CLI, bergantung pada cara produk VM dikonfigurasi. Untuk memverifikasi apakah Anda akan menggunakan modul yang disertakan atau cuplikan kode yang dibuat untuk men-deploy produk VM, buka tab Deployment command line pada listingan Cloud Marketplace produk. Jika menggunakan modul yang disertakan untuk men-deploy produk, Anda akan melihat tombol Download. Jika 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

  1. Dari tab Command-line deployment pada listingan Cloud Marketplace produk VM, klik tombol Download. Tindakan ini akan mendownload file zip yang berisi modul Terraform yang Anda gunakan.

  2. Ekstrak modul Terraform dari file zip yang Anda download.

Cuplikan kode yang dihasilkan

  1. Dari tab Command-line deployment pada listingan Cloud Marketplace produk VM, klik tombol Generate code. Tindakan ini akan menghasilkan cuplikan kode yang dapat Anda salin dan gunakan dengan Terraform untuk men-deploy VM dengan Terraform.

  2. Untuk menyalin cuplikan kode yang dibuat, klik Salin ke papan klip.

Gunakan modul yang disertakan atau cuplikan kode yang dibuat untuk men-deploy produk VM

Untuk menggunakan modul yang disertakan atau cuplikan kode yang dibuat untuk men-deploy produk VM melalui CLI, selesaikan langkah-langkah berikut:

Modul Terraform yang disertakan

  1. Di modul Terraform yang Anda download, cari file README.md .

  2. Ikuti petunjuk khusus produk dari file README.md.

    Saat mengikuti petunjuk khusus produk, jika mengalami masalah, Anda dapat mencoba men-deploy modul dengan menjalankan perintah berikut:

    • terraform init

    • terraform apply

Cuplikan kode yang dihasilkan

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

  2. Buat file baru bernama main.tf di mesin tempat Anda telah menginstal Terraform.

  3. Tempelkan cuplikan kode yang dihasilkan beserta semua pengeditan yang telah Anda buat pada file main.tf yang Anda buat.

  4. Jalankan perintah berikut:

    • terraform init

    • terraform apply

Langkah berikutnya

Untuk mengetahui informasi tentang cara mengelola deployment CLI produk VM, buka Mengelola deployment CLI produk VM.