Men-deploy aplikasi Kubernetes dengan Cloud Code untuk VS Code

Halaman ini menunjukkan cara memulai Cloud Code dengan cepat.

Anda akan menyiapkan aplikasi Kubernetes baru menggunakan aplikasi contoh 'Hello World', membuat cluster, menjalankan aplikasi di cluster ini, men-debug kode yang sedang berjalan, melihat log dari aplikasi aktif, dan menghubungkan terminal ke penampung yang sedang berjalan.

Sebelum memulai

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Google Kubernetes Engine API.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Google Kubernetes Engine API.

    Enable the API

  8. Instal Git. Git diperlukan untuk menyalin contoh ke komputer Anda.
  9. Instal plugin Cloud Code jika Anda belum melakukannya.

Membuat aplikasi

  1. Buka palet perintah (tekan Ctrl/Cmd+Shift+P atau klik View > Command Palette), lalu jalankan Cloud Code: New Application.

  2. Pilih Aplikasi Kubernetes.

  3. Pilih aplikasi Hello World dalam bahasa yang Anda inginkan.

    Misalnya, memilih Node.js: Hello World akan membuat aplikasi Node.js Hello World awal.

  4. Simpan aplikasi baru.

    Notifikasi akan mengonfirmasi bahwa aplikasi Anda telah dibuat dan jendela baru dengan aplikasi Anda akan terbuka.

Membuat cluster GKE

Untuk membuat cluster Google Kubernetes Engine (GKE) Standard, ikuti langkah-langkah berikut:

  1. Klik Cloud Code, lalu luaskan bagian Kubernetes.

  2. Klik add Add a Cluster to the KubeConfig, lalu klik Google Kubernetes Engine di menu Quick pick.

  3. Saat diminta untuk mengaktifkan container.googleapis.com, pilih Ya.

  4. Klik + Create a New GKE Cluster.

  5. Pilih Standar sebagai jenis cluster.

  6. Klik Buka untuk mengizinkan Cloud Code membuka konsol Google Cloud.

  7. Di konsol Google Cloud, gunakan project yang Anda buat, tetapkan zona ke us-central1-a, dan tetapkan nama cluster ke my-first-cluster.

  8. Klik Create. Pembuatan cluster memerlukan waktu beberapa menit.

  9. Setelah cluster dibuat, di menu Quick pick, klik refresh Refresh.

  10. Setelah nama cluster baru muncul dalam daftar, klik nama cluster. Cluster baru Anda ditambahkan ke konfigurasi dan dikonfigurasi menjadi konteks aktif.

Menjalankan dan melihat aplikasi

Setelah semuanya siap, Anda dapat menjalankan aplikasi dan melihatnya secara langsung. Cloud Code memantau sistem file Anda untuk mendeteksi perubahan sehingga Anda dapat mengedit dan menjalankan ulang aplikasi secara hampir real time.

Untuk menjalankan aplikasi, ikuti langkah-langkah berikut:

  1. Di status bar Cloud Code, klik nama project yang aktif.

    Nama project aktif di status bar

  2. Di menu Pilih Cepat yang muncul, pilih Jalankan di Kubernetes.

  3. Konfirmasi apakah akan menggunakan konteks cluster saat ini atau beralih ke konteks lain.

  4. Jika diminta, pilih registry image tempat image akan di-push. Jika Anda membuat registry image baru menggunakan gcr.io/PROJECT_ID, pastikan registry image berada dalam project yang sama dengan cluster Anda.

    Jendela output akan muncul tempat Anda dapat melacak progres aplikasi yang sedang berjalan. Anda juga akan melihat live stream log dari pod yang berjalan di output terminal.

  5. Setelah aplikasi Anda berjalan di Kubernetes, jendela output akan menampilkan alamat IP. Untuk menggunakan alamat IP tertaut ini guna mengakses aplikasi, tekan Ctrl/Cmd, lalu klik alamat.

Tips pemecahan masalah

Jika Anda menggunakan cluster yang sudah ada, untuk menetapkan cluster sebagai aktif dan mendapatkan kredensial cluster, ikuti langkah-langkah berikut:

  1. Klik Cloud Code, lalu luaskan bagian Kubernetes.

  2. Klik kanan nama cluster, lalu klik Set as Active Cluster.

Men-debug aplikasi

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

  1. Di status bar Cloud Code, klik nama project yang aktif.

    Nama project aktif di status bar

  2. Di menu Pilih Cepat yang muncul, pilih Debug on Kubernetes.

  3. Jika diminta, autentikasi kredensial Anda untuk menjalankan dan men-debug aplikasi secara lokal.

  4. Jika diminta, konfirmasi apakah akan menggunakan konteks cluster saat ini atau beralih ke konteks yang diinginkan.

    Cloud Code menggunakan konfigurasi cloudcode.kubernetes dalam file .vscode/launch.json untuk menjalankan aplikasi dan melampirkan sesi debugger ke aplikasi tersebut.

    Cloud Code mem-build penampung, mendorongnya ke registry, menerapkan konfigurasi Kubernetes ke cluster, dan menampilkan alamat IP yang dapat Anda gunakan untuk menjelajahi aplikasi aktif.

  5. Sebelum sesi debugger dilampirkan, Anda akan diminta untuk mengonfirmasi atau memasukkan direktori di penampung jarak jauh tempat program yang akan di-debug ditemukan atau menekan ESC untuk melewati proses debug penampung.

  6. Untuk menambahkan titik henti sementara ke baris #9, buka src/app.js, lalu klik di margin editor.

    Lingkaran isi merah menandakan titik henti sementara aktif, sedangkan lingkaran kosong abu-abu menandakan titik henti sementara yang dinonaktifkan. Untuk kontrol titik henti sementara yang lebih akurat, Anda dapat menggunakan bagian Titik Henti Sementara di tampilan Debug VS Code.

    Bagian Titik henti sementara di panel kiri Tampilan Debug yang memungkinkan penambahan, penghapusan, dan penonaktifan titik henti sementara

    Saat Anda mengirim permintaan baru ke aplikasi, debugger akan dijeda pada titik henti sementara aktif pertama.

    Pada contoh berikut, di bagian Local di bagian Variables, perhatikan bahwa nilai res._contentLength; untuk Hello, world! adalah 13.

    Aplikasi dijeda di titik henti sementara dan variabel serta bagian stack panggilan diisi dengan nilai dalam cakupan

  7. Edit string yang dikirim inline #8 ke Hello, goodbye!, lalu mulai ulang tindakan Debug on Kubernetes.

    Setelah aplikasi di-build ulang dan di-deploy ulang, catat nilai res._contentLength yang diperbarui.

    Aplikasi dijeda pada titik henti sementara dengan nilai yang diperbarui

Setelah sesi proses debug dimulai, panel Sesi pengembangan akan menampilkan tampilan logging terstruktur. Saat tugas dimulai, tugas akan muncul dengan progress_activity setengah lingkaran berputar.

Jika tugas berhasil, tanda centang check_circle akan muncul di samping langkah.

Untuk melihat detail langkah, klik langkah di panel Sesi pengembangan. Panel Output menampilkan langkah dalam output logging.

Membuka terminal di penampung

Untuk membuka terminal di penampung, ikuti petunjuk berikut:

  1. Klik Cloud Code, lalu luaskan bagian Kubernetes.

  2. Luaskan bagian berikut:

    • Bagian cluster pilihan Anda
    • Bagian Namespaces, lalu bagian namespace pilihan Anda
    • Bagian Pods, lalu bagian pod pilihan Anda
    • Bagian Containers

      Pod Cloud Code

  3. Klik kanan penampung tempat Anda ingin membuka terminal, lalu klik Get Terminal.

    Tindakan ini akan meluncurkan terminal. Sekarang Anda memiliki akses ke shell di dalam penampung yang berjalan.

Pembersihan

Setelah Anda menghentikan aplikasi, semua resource Kubernetes yang di-deploy selama proses berjalan akan otomatis dihapus.

Agar tidak menimbulkan biaya pada akun Anda untuk resource lain yang digunakan dalam panduan memulai ini, pastikan untuk menghapus project atau menghapus cluster yang Anda buat jika Anda ingin menggunakan kembali project tersebut.

Untuk menghapus cluster:

  1. Klik Cloud Code, lalu luaskan explorer Kubernetes.
  2. Arahkan kursor ke nama cluster, lalu klik open_in_new Buka di konsol Google Cloud.
  3. Klik Delete, lalu klik Delete.

Untuk menghapus project Anda (dan resource terkait, termasuk cluster):

  1. In the Google Cloud console, go to the Manage resources page.

    Go to Manage resources

  2. In the project list, select the project that you want to delete, and then click Delete.
  3. In the dialog, type the project ID, and then click Shut down to delete the project.

Langkah selanjutnya