Men-deploy aplikasi Kubernetes menggunakan pengembangan jarak jauh

Halaman ini menunjukkan cara memulai dengan cepat Cloud Code untuk VS Code menggunakan lingkungan pengembangan jarak jauh di Cloud Shell.

Dalam panduan memulai ini, Anda akan melewati penyiapan dan meng-clone project ke ruang kerja pengembangan jarak jauh dengan mengklik tombol, membuat cluster, menjalankan aplikasi Kubernetes di cluster ini, men-debug kode yang berjalan, melihat log dari aplikasi live, dan menghubungkan terminal ke container yang sedang berjalan.

Sebelum memulai

Untuk menyiapkan resource pendukung dan mengakses Cloud Shell, lingkungan pengembangan jarak jauh di Google Cloud yang Anda gunakan dalam panduan memulai ini, di dalam VS Code, selesaikan langkah-langkah berikut:

  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. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

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

  6. Instal Visual Studio Code di komputer Anda, jika belum melakukannya.
  7. Instal ekstensi Kode Visual Studio Remote - SSH.
  8. Instal Git. Git diperlukan untuk menyalin sampel ke komputer Anda.
  9. Instal plugin Cloud Code jika Anda belum melakukannya.

Meluncurkan Cloud Code

Saat Anda membuka Visual Studio Code yang terhubung ke lingkungan pengembangan jarak jauh di Cloud Shell, lingkungan tersebut memiliki semua alat yang Anda perlukan untuk mengembangkan aplikasi Kubernetes.

  1. Untuk mulai bekerja di tempat kerja pengembangan jarak jauh, pilih bahasa yang diinginkan untuk project yang di-clone, lalu klik tombol Buka dengan Cloud Code:

    VS Code meluncurkan dan meng-clone project ke ruang kerja pengembangan jarak jauh Anda.

  2. Jika belum menyiapkan prasyarat, Anda akan diminta untuk menginstalnya.

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