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 'Halo Dunia', membuat cluster, menjalankan aplikasi di cluster ini, men-debug kode yang berjalan, melihat log dari aplikasi live, dan menghubungkan terminal ke container 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. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

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

  4. Aktifkan API Google Kubernetes Engine.

    Mengaktifkan API

  5. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

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

  7. Aktifkan API Google Kubernetes Engine.

    Mengaktifkan API

  8. Instal Git. Git diperlukan untuk menyalin sampel 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 Kubernetes Application.

  3. Pilih aplikasi Halo Dunia dalam bahasa yang Anda inginkan.

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

  4. Simpan aplikasi baru.

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

Membuat cluster GKE

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

  1. Klik Cloud Code dan luaskan bagian Kubernetes.

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

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

  4. Klik + Create a New GKE Cluster.

  5. Pilih Standar sebagai jenis cluster.

  6. Klik Open 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 Pilihan cepat, klik muat ulang Muat ulang.

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

Menjalankan dan melihat aplikasi

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

Untuk menjalankan aplikasi Anda, ikuti langkah-langkah berikut:

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

    Nama project aktif di status bar

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

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

  4. Jika diminta, pilih registry image untuk mengirim image. 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 yang ditautkan ini guna mengakses aplikasi Anda, tekan Ctrl/Cmd dan 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 dan luaskan bagian Kubernetes.

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

Mendebug aplikasi Anda

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

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

    Nama project aktif di status bar

  2. Di menu Pilihan Cepat yang muncul, pilih Debug di 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 lebih disukai.

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

    Cloud Code membangun container, mendorongnya ke registry, menerapkan konfigurasi Kubernetes ke cluster, dan menampilkan alamat IP yang dapat digunakan untuk menjelajahi aplikasi aktif Anda.

  5. Sebelum sesi debugger terpasang, Anda akan diminta untuk mengonfirmasi atau memasukkan direktori dalam penampung jarak jauh tempat program debug ditemukan, atau tekan 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 berwarna merah menandakan titik henti sementara aktif, sedangkan lingkaran kosong berwarna abu-abu menandakan titik henti sementara yang dinonaktifkan. Untuk kontrol titik henti sementara yang lebih baik, Anda dapat menggunakan bagian Breakpoints dalam 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 yang pertama.

    Dalam contoh berikut, di bagian Lokal di bagian Variabel, perhatikan bahwa nilai res._contentLength; untuk Hello, world! adalah 13.

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

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

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

    Aplikasi dijeda di titik henti sementara dengan nilai yang diperbarui

Setelah sesi proses debug Anda dimulai, panel Development session akan menampilkan tampilan logging terstruktur. Saat tugas dimulai, tugas akan muncul dengan progress_activity setengah lingkaran yang berputar.

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

Untuk melihat detail sebuah langkah, klik langkah tersebut di panel Development session. Panel Output menampilkan langkah dalam output logging.

Membuka terminal di container

Untuk membuka terminal di container, ikuti petunjuk berikut:

  1. Klik Cloud Code dan luaskan bagian Kubernetes.

  2. Luaskan bagian berikut:

    • Bagian cluster pilihan Anda
    • Bagian Namespace, lalu bagian namespace yang Anda inginkan
    • Bagian Pods, lalu bagian pod pilihan Anda
    • Bagian Container

      Pod Cloud Code

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

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

Pembersihan

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

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

Untuk menghapus cluster:

  1. Klik Cloud Code, lalu luaskan explorer Kubernetes.
  2. Arahkan kursor ke nama cluster Anda, 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 apa pun):

  1. Di konsol Google Cloud, buka halaman Manage resource.

    Buka Manage resource

  2. Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
  3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Langkah selanjutnya