Men-debug layanan Cloud Run di Cloud Code untuk Cloud Shell

Cloud Code untuk Cloud Shell memungkinkan Anda men-debug aplikasi yang di-deploy ke Cloud Run dengan mudah menggunakan skaffold debug. Untuk mengetahui informasi mendetail tentang proses debug Skaffold, lihat Proses debug dengan Skaffold.

Anda tidak perlu menyelesaikan penyiapan manual seperti menyiapkan penerusan port atau menyuntikkan argumen debug khusus bahasa. Proses debug memerlukan aplikasi Cloud Run yang siap untuk Cloud Code yang menyertakan file konfigurasi skaffold.yaml dan file launch.json berjenis cloudcode.cloudrun.

Men-debug layanan Cloud Run

Untuk men-debug layanan, ikuti langkah-langkah berikut:

  1. Untuk menjalankan layanan dan melampirkan sesi debugger ke layanan tersebut, buka palet perintah (tekan Ctrl/Cmd+Shift+P atau klik View > Command Palette) lalu jalankan perintah Debug on Cloud Run Emulator.

  2. Di dialog Run/Debug on Cloud Run Emulator, tetapkan spesifikasi untuk konfigurasi Anda:

    • Pilih Docker atau Buildpack sebagai builder Anda, lalu tentukan Dockerfile atau Buildpack Anda.
    • (Opsional) Untuk menentukan target Dockerfile atau argumen build, klik Tampilkan Setelan Build Lanjutan, lalu tentukan target atau argumen.
    • (Opsional) Untuk menentukan nama layanan kustom, URL image container, port container, identitas yang akan digunakan layanan, jumlah CPU khusus, atau jumlah memori yang akan dialokasikan ke setiap instance container, klik Tampilkan Setelan Layanan Lanjutan, lalu tentukan nilai.
    • (Opsional) Untuk menentukan variabel lingkungan, klik Tampilkan Setelan Layanan Lanjutan, klik Variabel Lingkungan, lalu tentukan nilai.
    • (Opsional) Untuk menentukan koneksi Cloud SQL, klik Koneksi lalu tentukan satu koneksi per baris.

    Jika ingin menyesuaikan lebih lanjut cara layanan Anda dijalankan, Anda dapat mengedit file launch.json secara langsung.

  3. Untuk mulai men-debug layanan, klik Debug.

  4. Untuk setiap penampung yang dapat di-debug di layanan Anda, konfirmasi atau masukkan direktori di penampung jarak jauh tempat program yang ingin Anda debug ditemukan.

    Atau, Anda dapat menekan ESC untuk melewati proses men-debug container.

    Cloud Code melampirkan sesi debug untuk setiap penampung yang dapat di-debug dalam layanan.

    Secara default, saat perubahan pada aplikasi Anda disimpan otomatis, Cloud Code akan men-deploy ulang aplikasi Anda dan menyiapkan sesi debug baru. Anda dapat mengaktifkan/menonaktifkan fitur ini dengan tanda watch di konfigurasi peluncuran project Anda.

  5. Untuk menambahkan titik henti sementara, klik margin editor file yang sedang Anda debug.

    Lingkaran merah yang terisi menandakan titik henti sementara aktif dan lingkaran kosong berwarna abu-abu menandakan titik henti sementara dinonaktifkan.

    Saat Anda mengirim permintaan baru ke layanan, layanan akan dijeda di baris yang Anda tentukan.

  6. Setelah sesi Anda selesai, klik kanan untuk menggunakan perintah berikut:

    • Melihat Log: Buka log aplikasi deployment tertentu dengan Cloud Code Logs Explorer
    • Buka URL: Buka URL layanan aplikasi dari layanan tertentu di browser web

  7. Jika Anda telah menonaktifkan mode lihat di konfigurasi peluncuran dan ingin melakukan perubahan pada aplikasi, membangun ulang, dan men-deploy ulang aplikasi, klik status bar Cloud Code, lalu klik Turn on watch mode.

  8. Jika Anda ingin memeriksa variabel dan info stack, gunakan Sidebar Debug. Untuk berinteraksi dengan sesi penelusuran bug, gunakan Konsol Debug di penelusur bug panel bawah.

  9. Untuk menghentikan deployment, klik tombol Stop di panel tindakan untuk deployment saat ini.

    Panel tindakan untuk deployment Cloud Run

Memecahkan masalah pembuatan container

Jika Anda mendapatkan kode error BUILD_DOCKER_UNKNOWN, hal ini menunjukkan masalah pada Docker. Untuk mengatasi masalah ini, lakukan satu atau beberapa tugas berikut:

  • Mulai ulang Docker dan coba bangun container lagi.

  • Jika Anda masih mendapatkan error yang sama setelah memulai ulang, Docker mungkin kehabisan ruang disk. Untuk mempelajari lebih lanjut cara membersihkan objek yang tidak digunakan di Docker, lihat Memangkas objek Docker yang tidak digunakan.

  • Coba ekstensi Penggunaan Disk Docker untuk membantu merebut kembali ruang.

Detail konfigurasi

Cloud Code menangani detail konfigurasi khusus bahasa berikut:

Node.js

Menulis ulang titik entri untuk memanggil:

node --inspect=localhost:9229

Python

Menginstal modul ptvsd menggunakan Init Container dan menulis ulang entrypoint untuk memanggil:

python -m ptvsd --host localhost --port 5678

Go

Menginstal debugger dlv menggunakan Init Container dan menulis ulang titik entri sehingga sesi debug yang diluncurkan berjalan dengan server debug saja (dalam mode tanpa tampilan), melanjutkan proses yang di-debug saat dimulai, menerima beberapa koneksi klien, dan memproses di localhost:56268:

dlv exec --headless --continue --accept-multiclient --listen=localhost:56268 --api-version=2, <app> --

Java

Menambahkan lingkungan JAVA_TOOLS_OPTIONS dengan konfigurasi Java Debug Wire Protocol (JDWP) yang sesuai sehingga agen proses debug JDWP memproses koneksi soket di port 5005 dan memungkinkan VM mulai dieksekusi sebelum debugger dilampirkan:

jdwp=transport=dt_socket,server=y,suspend=n,address=5005,quiet=y

.NET

Aplikasi .NET Core dikonfigurasi untuk di-deploy bersama dengan vsdbg untuk VS Code.

Jika Anda mengalami masalah dengan konfigurasi otomatis, lihat Konfigurasi dan penyiapan debugger mendetail untuk mendapatkan bantuan dalam memecahkan masalah.