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 mengetahui ringkasan 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 Terraform lebih lanjut, buka Mulai menggunakan Terraform.

Ringkasan

Halaman ini menjelaskan langkah-langkah untuk men-deploy produk VM melalui CLI menggunakan Terraform. Pada tingkat yang tinggi, Anda:

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

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

  3. Atau, siapkan peniruan identitas akun layanan.

  4. Konfigurasikan lingkungan gcloud Anda untuk Terraform.

  5. Download modul Terraform atau cuplikan kode 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

Di tab Deployment command line, Anda dapat memilih untuk memilih atau membuat akun layanan yang ingin digunakan untuk deployment command line. Jika belum memilih atau membuat akun layanan di tab Deployment command line saat membuat cuplikan kode, Anda harus mengedit cuplikan Terraform yang dihasilkan 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 memiliki peran ini.

Untuk memilih atau membuat akun layanan:

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

  2. Di bagian Akun layanan yang meminta izin, Anda dapat mengklik untuk Memilih akun layanan yang ada, atau Membuat akun layanan baru.

Pilih akun layanan yang ada

Untuk memilih akun layanan yang ada:

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

    Jika tidak ada akun layanan yang 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.

  2. Klik tombol Submit.

Buat akun layanan baru

Untuk membuat akun layanan baru:

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

  2. Pilih ID untuk akun layanan Anda, lalu tambahkan di kolom Service account ID.

  3. Tambahkan deskripsi untuk akun layanan Anda ke kolom Deskripsi akun layanan.

  4. Klik tombol Create service account.

Setelah membuat akun layanan, Anda dapat terus mengelola 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 menggunakan peniruan identitas, Anda akan mengelola akses dengan memberikan atau mencabut peran IAM Service Account Token Creator (roles/iam.serviceAccountTokenCreator) kepada akun utama tertentu, bukan membuat kunci akun layanan yang dapat digunakan siapa saja untuk mengakses deployment Anda.

Untuk mempelajari cara memberikan dan mencabut peran di akun layanan, lihat Mengelola akses ke akun layanan. Untuk mempelajari peniruan akun layanan lebih lanjut, lihat Peniruan akun layanan.

Mengonfigurasi lingkungan gcloud untuk Terraform

Di tab Deployment command line, pada bagian Configure gcloud, Anda akan melihat serangkaian perintah. Untuk mengonfigurasi lingkungan gcloud untuk Terraform, Anda dapat menyalin dan menjalankan perintah yang disediakan.

Mendownload modul Terraform

Anda 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 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 menggunakan modul yang disertakan untuk men-deploy produk, Anda akan melihat tombol Download. Jika menggunakan cuplikan kode yang dihasilkan 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 Deployment command line di 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 Deployment command line di 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 dihasilkan, klik Salin ke papan klip.

Menggunakan 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

  1. Di modul Terraform yang Anda download, temukan 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 komputer tempat Anda menginstal Terraform.

  3. Tempel cuplikan kode yang dihasilkan, dengan pengeditan apa pun yang telah Anda lakukan, ke dalam file main.tf yang Anda buat.

  4. Jalankan perintah berikut:

    • terraform init

    • terraform apply

Langkah berikutnya

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