Halaman ini berisi informasi pemecahan masalah untuk membantu Anda menyelesaikan masalah pada Cloud Workstations.
Menarik image sistem ke VM
Saat Anda membuat workstation menggunakan konfigurasi workstation, Cloud Workstations akan menarik image sistem ke instance mesin virtual (VM) dari Artifact Registry (atau Container Registry). Pesan error yang muncul mirip dengan yang berikut ini:
System images cannot be pulled onto workstation VMs using this configuration.
Ensure that you have set up Cloud NAT or enabled Private Google Access for
Artifact Registry (and Container Registry).
Jika Anda gagal menarik image ini, Anda mungkin tidak dapat memulai workstation. Berikut beberapa rekomendasinya:
- Siapkan Cloud NAT atau aktifkan Akses Google Pribadi.
- Pastikan API diaktifkan dan dapat diakses VPC.
- Perbarui aturan firewall untuk mengizinkan keluar TCP.
- Periksa log startup VM Compute Engine Anda untuk mengetahui kemungkinan adanya error.
- Aktifkan atribut tamu di project Anda.
Waktu habis saat menyediakan VM
Saat Anda membuat workstation menggunakan konfigurasi workstation, Cloud Workstations akan membuat Compute Engine untuk mendukung workstation Anda. Jika terjadi error saat menyediakan VM, pesan error yang muncul akan mirip dengan berikut:
Workstations using this configuration cannot be provisioned due to an unknown error.
Berikut beberapa rekomendasinya:
- Periksa log startup VM Compute Engine Anda untuk mengetahui kemungkinan adanya error.
- Periksa log Compute Engine API Anda untuk mengetahui kemungkinan adanya error.
- Aktifkan atribut tamu di project Anda.
Menyiapkan Cloud NAT atau mengaktifkan Akses Google Pribadi
Jika Anda menonaktifkan alamat IP publik pada konfigurasi, gunakan salah satu opsi berikut:
Siapkan Cloud NAT agar Cloud Workstations dapat menarik image ke VM workstation Anda.
Aktifkan Akses Google Pribadi di subnet Anda. Jika Anda menggunakan nama domain
private.googleapis.com
ataurestricted.googleapis.com
, buat data DNS untuk mengarahkan traffic ke alamat IP yang terkait dengan domain tersebut. Secara khusus, Anda harus memastikan Anda mengaktifkan akses ke domain Artifact Registry dan Container Registry, yang masing-masing sesuai dengan*.pkg.dev
dan*.gcr.io
.
Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi Akses Google Pribadi > Konfigurasi jaringan lanjutan.
Pastikan API diaktifkan dan dapat diakses VPC
Jika project Anda berada di dalam perimeter Kontrol Layanan VPC, pastikan Cloud Storage API, Container Registry API, dan Artifact Registry API dapat diakses Virtual Private Cloud (VPC) dalam perimeter layanan Anda.
Memperbarui aturan firewall untuk mengizinkan keluar TCP
Pastikan Anda mengizinkan egress TCP di jaringan Anda pada port 80 dan 443 agar Cloud Workstations dapat menarik image ke workstation Anda.
Periksa log startup VM Compute Engine Anda untuk mengetahui kemungkinan adanya error
VM yang dibuat oleh Cloud Workstations menampilkan log debug ke konsol serial saat startup.
Log ini dapat membantu saat layanan kehabisan waktu saat membuat VM.
Nama VM yang dibuat untuk workstation dimulai dengan workstations-
, diikuti dengan ID unik.
Gunakan filter berikut untuk memfilter log Anda di Log Explorer:
SEARCH("workstations-")
sourceLocation.function="main.setupAndRunScript"
Jika Anda tidak melihat log apa pun dengan filter ini, pastikan Anda telah mengaktifkan logging port serial di project Anda. Jika Anda menentukan akun layanan pada konfigurasi workstation, pastikan akun layanan memiliki izin logging.logEntries.create
pada project sehingga dapat menulis log ke Cloud Logging. Coba mulai workstation Anda lagi setelah mengaktifkan logging port serial dan menambahkan izin yang diperlukan untuk memastikan skrip startup VM Compute Engine dijalankan lagi untuk membuat log.
Periksa log Compute Engine API Anda untuk mengetahui kemungkinan adanya error
Gunakan filter berikut ke log stackdriver Anda:
protoPayload.serviceName="compute.googleapis.com"
severity>=ERROR
Error Compute Engine API dapat menghalangi pembuatan VM workstation Anda.
Mengaktifkan atribut tamu di project Anda
Untuk membantu proses pemecahan masalah, pastikan Anda tidak menonaktifkan atribut tamu untuk project Anda. Cloud Workstations menggunakan atribut ini untuk mendeteksi masalah tertentu saat Anda memulai workstation dan melaporkan masalah tersebut sebagai pesan debug tertentu pada konfigurasi workstation.