Memverifikasi penyiapan VM Manager


Gunakan dokumen ini untuk memverifikasi bahwa VM Manager disiapkan dengan benar. Untuk informasi tentang cara menyiapkan VM Manager, lihat Menyiapkan Pengelola VM.

Untuk memverifikasi penyiapan, Anda dapat menggunakan perintah pemecahan masalah atau melakukan pemeriksaan manual pada instance virtual machine (VM).

Sebelum memulai

  • Untuk VM Windows, gunakan PowerShell 3.0 atau yang lebih baru.
  • Siapkan autentikasi, jika Anda belum melakukannya. Autentikasi adalah proses verifikasi identitas Anda untuk akses ke layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine sebagai berikut.

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    Konsol

    Saat menggunakan Konsol Google Cloud untuk mengakses API dan layanan Google Cloud, Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:

      gcloud init
    2. Menetapkan region dan zona default.

Menggunakan perintah pemecahan masalah

Gunakan perintah os-config troubleshoot untuk memverifikasi penyiapan. Jika ada pemeriksaan yang gagal, Anda akan diberi masukan tentang cara memperbaiki masalah tersebut.

gcloud compute os-config troubleshoot VM_NAME \
   --zone=ZONE

Ganti kode berikut:

  • VM_NAME: nama instance VM yang ingin Anda pecahkan masalahnya
  • ZONE: zona tempat instance berada

Contoh

  • Contoh 1: menampilkan output untuk perintah os-config troubleshoot saat instance VM mengalami masalah penyiapan
  • Contoh 2: menampilkan output untuk perintah os-config troubleshoot saat instance VM disiapkan dengan benar

Contoh 1

Untuk memecahkan masalah instance VM yang disebut my-instance-1 di zona asia-east2-b, jalankan perintah berikut:

gcloud compute os-config troubleshoot my-instance-1 \
    --zone=asia-east2-b

Outputnya akan terlihat seperti berikut:

OS Config troubleshooter tool is checking if there are issues with the
VM Manager setup for this VM instance.

> Is the OS Config API enabled? Yes
> Is the OS Config agent enabled? Yes
> Is the OS Config agent up to date? No

The version of OS Config agent running on this VM instance is not the
latest version.
See https://cloud.google.com/compute/docs/manage-os/upgrade-vm-manager#update-agent
on how to update the agent.

Contoh 2

Untuk memecahkan masalah instance VM yang disebut my-instance-2 di zona us-west1-b, jalankan perintah berikut:

gcloud compute os-config troubleshoot my-instance-2 \
    --zone=us-west1-b

Outputnya akan terlihat seperti berikut:

OS Config troubleshooter tool is checking if there are issues with the
VM Manager setup for this VM instance.

> Is the OS Config API enabled? Yes
> Is the OS Config agent enabled? Yes
> Is the OS Config agent up to date? Yes
> Is a service account present on the instance? Yes
> Is the OS Config Service account present for this instance? Yes
> Does this instance have a public IP or Private Google Access? Yes
This instance has a public IP.

Verifikasi manual

Untuk memverifikasi secara manual bahwa VM Manager sudah disiapkan dengan benar, selesaikan pemeriksaan berikut:

Jika VM Manager disiapkan dengan benar tetapi Anda masih mengalami masalah, baca artikel Memecahkan Masalah VM Manager.

Memeriksa apakah OS Config API telah diaktifkan

Di project Google Cloud Anda, periksa apakah API sudah diaktifkan.

Konsol

Di konsol Google Cloud, buka halaman OS Config API.

Buka OS Config API

gcloud

gcloud services list --enabled

Jika API diaktifkan, outputnya akan terlihat seperti berikut:

osconfig.googleapis.com              OS Config API

Jika API tidak diaktifkan, aktifkan OS Config API.

Memeriksa apakah metadata diaktifkan

Linux

Untuk metadata project, di VM, selesaikan langkah-langkah berikut:

  1. Buat kueri endpoint atribut project:

    curl "http://metadata.google.internal/computeMetadata/v1/project/attributes/" \
    -H "Metadata-Flavor: Google"
    

    Jika nilai metadata agen ditetapkan, output-nya akan terlihat seperti berikut:

    enable-osconfig
    
  2. Jika nilai enable-osconfig ditampilkan, buat kueri endpoint:

    curl "http://metadata.google.internal/computeMetadata/v1/project/attributes/enable-osconfig" \
    -H "Metadata-Flavor: Google"

    Jika diaktifkan, endpoint akan menampilkan TRUE.

Jika metadata tidak diaktifkan, aktifkan metadata OS Config.

Windows

Untuk metadata project, di VM, buka terminal PowerShell sebagai administrator dan jalankan perintah berikut:

  1. Buat kueri endpoint atribut project:

    $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} `
             -Uri "http://metadata.google.internal/computeMetadata/v1/project/attributes/")
    $value
    

    Jika nilai metadata agen ditetapkan, output-nya akan terlihat seperti berikut:

    enable-osconfig
    
  2. Jika nilai enable-osconfig ditampilkan, buat kueri endpoint:

    $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} `
             -Uri "http://metadata.google.internal/computeMetadata/v1/project/attributes/enable-osconfig")
    $value
    

    Jika diaktifkan, endpoint akan menampilkan TRUE.

Jika metadata tidak diaktifkan, aktifkan metadata OS Config.

Memeriksa apakah agen Konfigurasi OS sudah diinstal dan berjalan

Linux

Untuk memeriksa apakah VM Linux Anda telah menginstal agen, jalankan perintah berikut:

sudo systemctl status google-osconfig-agent

Jika agen sudah diinstal dan berjalan, outputnya akan terlihat seperti berikut:

google-osconfig-agent.service - Google OSConfig Agent
Loaded: loaded (/lib/systemd/system/google-osconfig-agent.service; enabled; vendor preset:
Active: active (running) since Wed 2020-01-15 00:14:22 UTC; 6min ago
Main PID: 369 (google_osconfig)
 Tasks: 8 (limit: 4374)
Memory: 102.7M
CGroup: /system.slice/google-osconfig-agent.service
        └─369 /usr/bin/google_osconfig_agent

Jika agen belum diinstal, instal agen OS Config.

Windows

Untuk memeriksa apakah VM Windows Anda telah menginstal agen, jalankan perintah berikut:

PowerShell Get-Service google_osconfig_agent

Jika agen sudah diinstal dan berjalan, outputnya akan terlihat seperti berikut:

Status   Name               DisplayName
------   ----               -----------
Running  google_osconfig... Google OSConfig Agent

Jika agen belum diinstal, instal agen OS Config.

Memeriksa apakah akun layanan sudah diaktifkan

Untuk mengetahui informasi tentang prasyarat akun layanan, lihat Ringkasan penyiapan.

Linux

Di VM, jalankan perintah berikut:

curl "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/" \
-H "Metadata-Flavor: Google"

Output harus setidaknya menyertakan akun layanan default.

default/

Windows

Di VM, buka terminal PowerShell sebagai administrator dan jalankan perintah berikut:

$value = (Invoke-RestMethod `
         -Headers @{'Metadata-Flavor' = 'Google'} `
         -Uri "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/")
$value

Output harus setidaknya menyertakan akun layanan default.

default/

Memeriksa apakah VM dapat berkomunikasi dengan OS Config API

Untuk memeriksa apakah VM dapat berkomunikasi dengan OS Config API, jalankan perintah berikut pada VM Linux atau Windows Anda:

ping osconfig.googleapis.com

Untuk berhenti melakukan ping pada OS Config API, tekan Control + C.

Jika VM Anda berjalan dalam jaringan VPC pribadi dan tidak memiliki akses internet publik, pastikan Anda telah mengaktifkan Akses Google Pribadi.

Setelah Anda mengaktifkan Akses Google Pribadi, pastikan VM dapat berkomunikasi dengan OS Config API.

Linux

Di VM, jalankan perintah berikut:

 curl --ssl 'https://osconfig.googleapis.com/$discovery/rest' | head

Jika VM dapat berkomunikasi dengan OS Config API, output perintahnya akan mirip dengan berikut ini:

% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                             Dload  Upload   Total   Spent    Left  Speed
0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0{
"discoveryVersion": "v1",
"baseUrl": "https://osconfig.googleapis.com/",
"ownerName": "Google",
"version": "v1beta",
"schemas": {
  "GooSettings": {
    "description": "Googet patching is performed by running `googet update`.",
    "properties": {},
    "id": "GooSettings",
100  9569    0  9569    0     0   198k      0 --:--:-- --:--:-- --:--:--  198k

Windows

Di VM, buka terminal PowerShell sebagai administrator, lalu jalankan perintah berikut:

 Invoke-RestMethod  -Headers @{'Metadata-Flavor' = 'Google'}
 -Uri 'https://osconfig.googleapis.com/$discovery/rest'

Apa langkah selanjutnya?