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 sekali klik tombol, membuat cluster, menjalankan aplikasi Kubernetes di cluster ini, men-debug kode yang sedang 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 yang Anda gunakan dalam panduan memulai ini, Google Cloud di dalam VS Code, selesaikan langkah-langkah berikut:

  1. Login keakun Anda. Google Cloud Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

  6. Instal Visual Studio Code di komputer Anda, jika belum melakukannya.
  7. Instal ekstensi Visual Studio Code 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 ruang kerja pengembangan jarak jauh, pilih bahasa pilihan Anda untuk project yang di-clone, lalu klik tombol Open with Cloud Code:

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

  2. Jika Anda 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 pick.

  3. Saat diminta untuk mengaktifkan container API, pilih Yes.

  4. Klik + Create a New GKE Cluster.

  5. Pilih Standard sebagai jenis cluster.

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

  7. Di Google Cloud konsol, pastikan project yang dipilih adalah project yang Anda buat atau pilih sebelumnya.

  8. Tetapkan nama cluster ke my-first-cluster.

  9. Pilih Zonal sebagai jenis lokasi, dan tetapkan zona ke us-central1-a.

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

  11. Setelah cluster dibuat, klik Add a cluster to the KubeConfig lagi, lalu pilih cluster yang baru saja Anda buat dari daftar.

  12. Cluster baru Anda akan ditambahkan ke konfigurasi dan dikonfigurasi sebagai konteks aktif.

Menjalankan dan melihat aplikasi

Setelah semuanya disiapkan, Anda dapat menjalankan aplikasi dan melihatnya secara langsung. Cloud Code memantau sistem file Anda untuk mengetahui perubahan sehingga Anda dapat mengedit dan menjalankan ulang aplikasi dalam waktu yang hampir real time.

Untuk menjalankan aplikasi, ikuti langkah-langkah berikut:

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

    Nama project aktif di status bar

  2. Di menu Pilih Cepat yang muncul, pilih Run on Kubernetes. Saat diminta lagi, pilih Run on Kubernetes.

  3. Konfirmasi apakah akan menggunakan konteks cluster saat ini atau beralih ke konteks 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 di project yang sama dengan cluster Anda.

  5. Setelah aplikasi Anda berjalan di Kubernetes, klik entri Status tugas Run on Kubernetes di bagian Development sessions. Jendela akan terbuka dengan tab Output yang menyertakan URL aplikasi Anda. Untuk membuka URL ini, tekan Control (atau Command di macOS) dan klik alamat.

    Anda juga dapat menemukan aplikasi di ringkasan Beban kerja di Google Cloud konsol. Untuk mengetahui informasi selengkapnya tentang aplikasi yang sedang berjalan, termasuk alamat IP eksternal dan nomor port-nya, klik namanya dalam daftar.

Tips pemecahan masalah

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

  1. Di VS Code, klik Cloud Code dan luaskan bagian Kubernetes.

  2. Klik kanan nama cluster Anda, 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 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 pilihan.

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

    Cloud Code membangun container Anda, mengirimkannya ke registry, menerapkan konfigurasi Kubernetes ke cluster, dan menampilkan alamat IP yang dapat Anda gunakan untuk menjelajahi aplikasi live.

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

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

    Lingkaran terisi berwarna merah menandakan breakpoint aktif, sedangkan lingkaran kosong berwarna abu-abu menandakan breakpoint dinonaktifkan. Untuk kontrol breakpoint yang lebih baik, Anda dapat menggunakan bagian Breakpoints 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 berhenti di breakpoint aktif pertama.

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

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

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

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

    Aplikasi dijeda pada titik henti sementara dengan nilai yang diperbarui

Setelah sesi proses debug dimulai, panel Development sessions akan menampilkan tampilan logging terstruktur. Saat tugas dimulai, tugas akan muncul dengan a progress_activity progress_activity.

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

Untuk melihat detail langkah, klik langkah 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 Namespaces , lalu bagian namespace pilihan Anda
    • Bagian Pods , lalu bagian pod pilihan Anda
    • Bagian Containers

      Pod Cloud Code

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

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

Pembersihan

Setelah Anda menghentikan aplikasi, semua resource Kubernetes yang di-deploy selama proses tersebut 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 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 Open in Google Cloud console.
  3. Klik Delete , lalu klik Delete.

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

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

    Buka Kelola resource

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

Langkah berikutnya