Terhubung ke VM yang menggunakan Runtime VM di GDC

Dokumen ini ditujukan untuk pemilik aplikasi yang menjalankan Google Distributed Cloud. Dokumen ini menunjukkan cara terhubung ke virtual machine (VM) yang menggunakan Runtime VM di GDC. Anda dapat terhubung ke VM secara langsung menggunakan IP alamat IP eksternal, atau menggunakan alat bawaan untuk akses SSH atau konsol.

Sebelum memulai

Untuk menyelesaikan dokumen ini, Anda memerlukan akses ke referensi berikut:

• VM yang berjalan di salah satu cluster Anda. Jika diperlukan, membuat VM di Google Distributed Cloud.
• Alat klien virtctl diinstal sebagai plugin untuk kubectl. Jika diperlukan, instal alat klien virtctl.

Mengonfigurasi akses SSH tanpa sandi ke VM

Akses SSH langsung dan tanpa sandi ke VM Anda difasilitasi oleh agen tamu yang diinstal oleh VM Runtime di GDC. Di antara tugas-tugas lainnya, tamu agen diinstal dan kunci SSH kedaluwarsa. Kemampuan ini mengaktifkan tunnel SSH untuk yang mengakses VM Anda dari klien di luar jaringan cluster.

Mengaktifkan agen tamu

Untuk mengaktifkan agen tamu:

1. Periksa resource kustom VirtualMachine untuk memastikan resource telah dikonfigurasi untuk aktifkan agen tamu:

   kubectl get gvm VM_NAME -o yaml --kubeconfig KUBECONFIG
   

   Kolom spec.osType harus disetel ke sistem operasi VM Anda, Linux atau Windows. Bagian spec.guestEnvironment tidak boleh secara eksplisit dikonfigurasi sebagai kosong. Jika bagian tersebut dikonfigurasi sebagai kosong (guestEnvironment: {}), Anda dapat menghapus seluruhnya untuk mengaktifkan tamu agen keamanan.

   Resource kustom VirtualMachine Anda untuk VM yang ingin Anda akses harus akan terlihat seperti ini:

   apiVersion: vm.cluster.gke.io/v1
   kind: VirtualMachine
   metadata:
     name: sample-vm
   spec:
     compute:
       cpu:
         vcpus: 2
       memory:
         capacity: 4Gi
   ...
     osType: Linux
   ...
   

2. Jika perlu, gunakan kubectl edit untuk memperbarui VirtualMachine kustom resource Anda

3. Untuk memastikan agen tamu berfungsi, periksa status di VM kustom Anda referensi:

   kubectl get gvm VM_NAME --kubeconfig KUBECONFIG
   

   Saat agen tamu bekerja, Anda akan melihat status: "True" untuk Kondisi GuestEnvironmentEnabled dan GuestEnvironmentDataSynced.

   apiVersion: vm.cluster.gke.io/v1
   kind: VirtualMachine
   metadata:
     ...
     name: vm-sample-01
     ...
   status:
     conditions:
     - lastTransitionTime: "2022-10-05T22:40:26Z"
       message: ""
       observedGeneration: 1
       reason: UserConfiguration
       status: "True"
       type: GuestEnvironmentEnabled
     - lastTransitionTime: "2022-10-06T21:55:57Z"
       message: ""
       observedGeneration: 1
       reason: GuestEnvironmentDataSynced
       status: "True"
       type: GuestEnvironmentSynced
     ...
   

Aktifkan akses SSH tanpa sandi

Guna mengaktifkan akses SSH tanpa sandi untuk VM Anda:

1. Membuat file manifes VirtualMachineAccessRequest, seperti vm-access-request.yaml, dalam editor pilihan Anda:

   apiVersion: vm.cluster.gke.io/v1
   kind: VirtualMachineAccessRequest
   metadata:
     name: VMAR_NAME
     namespace: VM_NAMESPACE
   spec:
     vm: VM_NAME
     user: USERNAME
     ssh:
       key: PUBLIC_SSH_KEY
       ttl: EXPIRATION_TIME
   

   Ganti kode berikut:

   • VMAR_NAME: nama akses resource permintaan.
   • VM_NAMESPACE: namespace untuk VM yang ingin Anda akses.
   • VM_NAME: nama VM yang Anda inginkan untuk diakses.
   • USERNAME: nama pengguna untuk pengguna yang sedang mengakses VM.
   • PUBLIC_SSH_KEY: kunci publik untuk akses SSH. Biasanya, ini adalah isi file id_rsa.pub.

   • EXPIRATION_TIME: ttl (time-to-live) menentukan berapa lama kunci SSH valid.

     Misalnya, jika Anda menentukan 30m, masa berlaku kunci SSH akan habis setelah 30 menit.

     Flag ini menggunakan unit berikut:

     • s untuk detik
     • m untuk menit
     • h untuk jam
     • d untuk hari

2. Gunakan kubectl apply untuk membuat VirtualMachineAccessRequest dari manifes. Misalnya, jika Anda menamai file manifes vm-access-request.yaml,

   kubectl apply -f MANIFEST --kubeconfig KUBECONFIG
   

   Ganti kode berikut:

   • MANIFEST: nama akses file manifes permintaan. Contoh, vm-access-request.yaml.
   • KUBECONFIG: jalur ke {i>kubeconfig<i} dari cluster yang menghosting VM yang Anda akses.

3. Untuk memverifikasi bahwa konfigurasi permintaan akses Anda berhasil, periksa status dari VirtualMachineAccessRequest:

   kubectl get vmar VMAR_NAME -o yaml --kubeconfig KUBECONFIG
   

   Setelah konfigurasi berhasil, bagian status akan menyertakan state: configured:

   apiVersion: vm.cluster.gke.io/v1
   kind: VirtualMachineAccessRequest
   metadata:
     ...
     annotations:
       kubectl.kubernetes.io/last-applied-configuration: |
         {"apiVersion":"vm.cluster.gke.io/v1","kind":"VirtualMachineAccessRequest",
         "metadata":{"annotations":{},"name":"vmar-sample","namespace":"default"},
         "spec":{"ssh":{"key":"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQ...jMLHFc=
             sample-user@sample-host","ttl":"5h"},"user":"sample-user","vm":"vm-sample-01"}}
     creationTimestamp: "2022-10-06T21:55:57Z"
     finalizers:
     - vm.cluster.gke.io/vmar-finalizer
     generation: 2
     name: vmar-sample
     namespace: default
     resourceVersion: "13033921"
     uid: 282d72ad-f48d-4e89-af22-336940ac9f58
   spec:
     ssh:
       key: ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQ...jMLHFc= sample-user@sample-host
       ttl: 5m0s
     user: sample-user
     vm: vm-sample-01
   status:
     processedAt: "2022-10-06T21:55:57Z"
     state: configured
   

Nonaktifkan agen tamu

Saat Anda membuat VM baru dan menyetel kolom osType, agen tamu diaktifkan. Saat fitur ini berada dalam Pratinjau, Anda dapat menonaktifkannya dengan mengedit Resource kustom VirtualMachine. Menonaktifkan agen tamu akan menonaktifkan sandi tanpa sandi Akses SSH ke VM Anda.

Untuk menonaktifkan agen tamu:

1. Gunakan kubectl untuk menghentikan VM Anda sebelum membuat perubahan pada konfigurasi:

   kubectl virt stop VM_NAME --kubeconfig KUBECONFIG
   

1. Edit resource VM Anda:

   kubectl edit gvm VM_NAME --kubeconfig KUBECONFIG
   

2. Perbarui konfigurasi VirtualMachine untuk menambahkan spec.guestEnvironment kosong secara eksplisit:

   apiVersion: vm.cluster.gke.io/v1alpha1
   kind: VirtualMachine
   metadata:
     name: vm-example
     namespace: default
   spec:
     compute:
     ...
     osType: Linux
     guestEnvironment: {}
   

3. Simpan dan tutup manifes VM yang telah diupdate di editor Anda.

4. Gunakan kubectl untuk memulai VM:

   kubectl virt start VM_NAME --kubeconfig KUBECONFIG
   

Hubungkan menggunakan alamat IP

Jika VM Anda memiliki alamat IP yang dapat diakses dan Anda sudah memiliki kredensial untuk mengakses VM, Anda dapat terhubung menggunakan protokol seperti SSH, VNC, atau RDP.

Hubungkan melalui alamat IP

Jika Anda dapat terhubung langsung ke alamat IP VM, gunakan salah satu opsi berikut metode:

Terhubung melalui Layanan

Jika VM terhubung ke pod-network default dan Anda tidak dapat berkomunikasi langsung ke alamat IP VM Anda, ekspos VM di belakang load balancer Service.

1. Buat manifes Service, seperti my-service-load-balancer.yaml, di pilihan Anda:

   nano my-service-load-balancer.yaml
   

2. Salin dan tempel manifes YAML berikut:

   apiVersion: v1
   kind: Service
   metadata:
     name: VM_NAME-service
   spec:
     selector:
       kubevirt/vm: VM_NAME
     ports:
     - name: PORT_NAME
       protocol: PROTOCOL_TYPE
       port: EXTERNAL_PORT
       targetPort: TARGET_PORT
     type: LoadBalancer
   

   Dalam jenis manifes Service ini, ganti nilai berikut:

   • VM_NAME: nama VM Anda yang akan diekspos untuk akses jarak jauh.
   • PORT_NAME: nama protokol Anda, seperti ssh, vnc, atau rdp.
   • PROTOCOL_TYPE: jenis protokol, seperti TCP untuk SSH dan RDP, atau UDP untuk VNC.
   • EXTERNAL_PORT: nomor port eksternal yang akan diekspos dan yang Anda gunakan untuk hubungkan.
   • TARGET_PORT: port target, seperti 22 untuk SSH.

3. Simpan dan tutup manifes Service di editor Anda.

4. Buat Service menggunakan kubectl:

   kubectl apply -f my-service-load-balancer.yaml  --kubeconfig KUBECONFIG
   

5. Dapatkan alamat EXTERNAL-IP layanan load balancer:

   kubectl get service VM_NAME-service --kubeconfig KUBECONFIG
   

   Alamat IP load balancer ditampilkan, seperti yang ditunjukkan pada contoh output berikut:

   NAME          TYPE           CLUSTER-IP       EXTERNAL-IP   PORT(S)        AGE
   vm1-service   LoadBalancer   172.26.232.167   10.200.0.51   22:31141/TCP   6d20h
   

6. Hubungkan ke alamat EXTERNAL-IP load balancer dengan standar seperti menggunakan klien SSH:

   ssh USERNAME@LOAD_BALANCER_IP_ADDRESS  -i PATH_TO_KEY
   

   Ganti nilai berikut:

   • USERNAME: nama pengguna untuk akun di VM Anda.
   • LOAD_BALANCER_IP_ADDRESS: alamat IP pemuatan Anda dengan load balancer Jaringan Passthrough Eksternal Regional.
   • PATH_TO_KEY: jalur ke kunci SSH pribadi.

Menghubungkan langsung menggunakan SSH

Jika klien Anda terhubung ke jaringan fisik yang sama dengan cluster Anthos Anda pada {i>node<i} {i>bare metal<i} dan Anda tidak memerlukan penggunaan terowongan SSH untuk terhubung ke cluster tersebut, Anda dapat terhubung menggunakan kubectl virt ssh.

1. Untuk menggunakan SSH guna menghubungkan VM Linux dari konsol dengan add-on virtctl:

   kubectl virt ssh USERNAME@VM_NAME --namespace VM_NAMESPACE --kubeconfig KUBECONFIG
   

   Ganti nilai berikut:

   • USERNAME: nama pengguna untuk mengakses VM Anda. Ini dibuat jika tidak ada di VM.
   • VM_NAME: nama VM Anda.

2. Setelah Anda berhasil terhubung menggunakan SSH, VM dan tidak lagi memerlukan keluar dari sesi SSH:

   exit
   

Menghubungkan langsung menggunakan konsol

Jika Anda tidak memiliki konektivitas jaringan langsung ke VM Linux untuk akses SSH, hubungkan ke konsol VM menggunakan Runtime VM di konsol GDC. Metode ini membuka konsol serial. Setelah terhubung, Anda diberi perintah prompt, bukan konsol grafis.

1. Untuk mengakses VM Linux dari konsol, gunakan add-on virtctl:

   kubectl virt console VM_NAME --kubeconfig KUBECONFIG
   

   Ganti VM_NAME dengan nama VM Anda.

   Saat diminta, masukkan kredensial pengguna untuk VM Anda. Kredensial ini harus ada di VM, atau diterapkan saat VM dibuat. Jika perlu, lihat bagian berikut untuk membuat kredensial pengguna awal saat Anda membuat VM.

2. Setelah Anda berhasil terhubung ke konsol VM dan tidak lagi yang memerlukan koneksi, tutup sesi VM dan konsol:

   Ctrl + ]
   

Menghubungkan langsung menggunakan VNC

Anda dapat menggunakan perintah kubectl virt vnc untuk membuka Komputasi Jaringan Virtual (VNC) untuk mengakses VM Anda. Metode ini berfungsi untuk VM yang berjalan baik Windows atau Linux {i>guest OS<i}. Saat Anda menggunakan kubectl virt vnc VM Runtime di GDC membuka VNC untuk Anda, sehingga Anda tidak perlu mengaktifkan VNC di OS tamu.

Anda memerlukan kredensial yang ada untuk login ke VM, seperti yang Anda definisikan ke membuat kredensial pengguna awal saat Anda membuat VM.

1. Untuk mengakses VM menggunakan VNC, gunakan add-on virtctl:

   kubectl virt vnc VM_NAME --kubeconfig KUBECONFIG
   

   Ganti VM_NAME dengan nama VM Anda.

   Saat diminta, masukkan kredensial pengguna untuk VM Anda.

2. Setelah Anda berhasil terhubung ke sesi VNC VM dan tidak lagi membutuhkan koneksi, keluar dari VM untuk menutup koneksi VNC.

Membuat kredensial pengguna awal

Saat terhubung ke VM menggunakan konsol, Anda harus menentukan memiliki kredensial yang lengkap. Proses pembuatan kredensial pengguna awal berbeda untuk Linux dan sistem operasi tamu Windows.

Langkah selanjutnya

• Mengelola status daya VM di Google Distributed Cloud.
• Edit VM di Google Distributed Cloud.
• Lihat log konsol VM di Google Distributed Cloud.