Menghubungkan ke VM

Konsol

1. Di menu navigasi, klik Virtual Machines > Instances.

2. Dalam daftar VM, temukan baris untuk VM yang sedang berjalan yang ingin Anda hubungkan. Di kolom Connect, klik SSH.

3. Terminal browser SSH akan terbuka. Masukkan perintah apa pun di shell atau klik FTP untuk menjelajahi struktur file dan mengupload file.

gdcloud

Hubungkan ke VM menggunakan SSH dengan menjalankan perintah gdcloud compute ssh

gdcloud compute ssh VM_NAME \
  --project=PROJECT_ID

Ganti variabel berikut:

• VM_NAME: nama VM.
• PROJECT_ID: ID project yang berisi VM.

Jika telah menetapkan properti default untuk CLI, Anda dapat menghilangkan flag --project dari perintah ini. Contoh:

gdcloud compute ssh VM_NAME

API

Menghubungkan ke VM:

• Buka terminal.
• Buat pasangan kunci SSH.
• Upload kunci publik dan nama pengguna dengan nilai time-to-live (TTL).

GDC mengambil kunci SSH dan nama pengguna, lalu membuat akun pengguna dengan nama pengguna tersebut. Di VM, GDC menyimpan kunci publik dalam file ~/.ssh/authorized_keys pengguna Anda di VM.

Selesaikan langkah-langkah berikut untuk terhubung ke VM dari command line:

1. Buat pasangan kunci SSH dan nama pengguna.

   Di workstation OS, gunakan utilitas ssh-keygen untuk membuat pasangan kunci SSH baru. Contoh kode berikut membuat pasangan kunci RSA (Rivest–Shamir–Adleman):

   ssh-keygen -t rsa \
     -f ~/.ssh/KEY_FILENAME \
     -C USERNAME \
     -b 2048
   

   Ganti variabel dengan menggunakan definisi berikut.

   Variabel	Definisi
   KEY_FILENAME	Nama untuk file kunci SSH Anda. Misalnya, nama file my-ssh-key menghasilkan file kunci pribadi bernama my-ssh-key dan file kunci publik bernama my-ssh-key.pub.
   USERNAME	Nama pengguna Anda di VM, seperti testuser atau testuser_gmail_com.

   Utilitas ssh-keygen menyimpan file kunci pribadi Anda di jalur ~/.ssh/KEY_FILENAME dan file kunci publik Anda di jalur ~/.ssh/KEY_FILENAME.pub.

   Kunci publik untuk pengguna, testuser, mirip dengan contoh berikut:

   ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDAu5kKQCPF... testuser
   

2. Upload kunci Anda ke VM dan buat resource Kubernetes dengan kunci publik, nama pengguna, dan nilai time to live (TTL) untuk kunci tersebut.

   Contoh berikut menggunakan file access_request.yaml untuk memberikan akses ke instance VM dengan kunci pribadi KEY_FILENAME dan nilai TTL sepuluh menit:

   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineAccessRequest
   metadata:
     namespace: VM_NAMESPACE
     name: AR_NAME
   spec:
     ssh:
       key: |
         ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDAu5kKQCPF... cloudysanfrancisco
       ttl: 10m
     user: USERNAME
     vm: VM_NAME
   

   Ganti variabel, menggunakan definisi berikut:

   Variabel	Definisi
   VM_NAMESPACE	Namespace untuk VM.
   AR_NAME	Nama permintaan akses.
   USERNAME	Nama pengguna Anda di VM, seperti testuser atau testuser_gmail_com.
   VM_NAME	Nama instance VM.

3. Buat kunci:

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     create -f access_request.yaml
   

4. Periksa status permintaan akses Anda:

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n VM_NAMESPACE \
     get virtualmachineaccessrequests.virtualmachine.gdc.goog
   

   Ganti VM_NAMESPACE dengan namespace untuk VM.

   Status configured menunjukkan bahwa Anda dapat terhubung ke VM.

5. Hubungkan ke VM:

   ssh -i PATH_TO_PRIVATE_KEY USERNAME@EXTERNAL_IP
   

   Ganti nilai berikut:

   • PATH_TO_PRIVATE_KEY dengan jalur ke file kunci SSH pribadi yang sesuai dengan kunci publik yang Anda tambahkan ke VM.
   • USERNAME dengan nama pengguna yang Anda tentukan saat membuat kunci SSH. Misalnya, cloudysanfrancisco_example_com atau cloudysanfrancisco.
   • EXTERNAL_IP dengan alamat IP ingress eksternal VM.

Pemecahan masalah

Bagian ini menjelaskan cara memecahkan masalah yang mungkin terjadi saat menghubungkan ke instance VM setelah membuat permintaan akses.

Ikuti langkah-langkah berikut untuk mengidentifikasi kemungkinan masalah:

1. Pastikan VM sedang berjalan. Ganti variabel yang dapat diedit dengan nilai Anda dalam perintah berikut:

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n VM_NAMESPACE \
     get virtualmachines.virtualmachine.gdc.goog VM_NAME
   

   Jika VM tidak berjalan, Anda tidak dapat terhubung atau mengonfigurasi permintaan baru.

2. Pastikan VM telah berjalan selama beberapa menit. Jika VM baru saja dimulai, layanan yang diperlukan untuk akses SSH mungkin belum berjalan. Biasanya, proses ini berjalan dalam waktu lima menit setelah booting.

3. Pastikan Anda tidak melebihi nilai TTL pada permintaan akses. Kunci dihapus setelah waktu mencapai nilai TTL.

4. Jika VirtualMachineAccessRequest Anda menampilkan status configured, pastikan persyaratan berikut:

   1. Anda mengaktifkan transfer data di ke VM Anda di port 22.
   2. Mesin Anda merutekan ke VM. Misalnya, Anda dapat menggunakan perintah
      curl -vso /dev/null --connect-timeout 5 EXTERNAL_IP:22 untuk memeriksa pemilihan rute.

5. Jika VirtualMachineAccessRequest Anda menampilkan status failed, lihat status lengkap dan tinjau pesan error yang menunjukkan penyebab permintaan gagal:

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n VM_NAMESPACE \
     describe virtualmachineaccessrequest.virtualmachine.gdc.goog AR_NAME
   

   Ganti variabel yang dapat diedit dalam perintah sebelumnya dengan nilai Anda sendiri.

6. Jika status VirtualMachineAccessRequest Anda kosong, lingkungan tamu mungkin tidak berjalan.