Men-deploy aplikasi Kubernetes dengan Cloud Code untuk VS Code

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 sampel 'Hello World', membuat cluster, menjalankan aplikasi di cluster ini, men-debug kode yang sedang berjalan, melihat log dari aplikasi aktif, dan menghubungkan terminal ke container yang sedang berjalan.

Sebelum memulai

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.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Jika Anda menggunakan project yang sudah ada untuk panduan ini, pastikan Anda memiliki izin yang diperlukan untuk menyelesaikan panduan ini. Jika berhasil membuat project baru, berarti Anda sudah memiliki izin yang diperlukan.

Verify that billing is enabled for your Google Cloud project.

Enable the Google Kubernetes Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Jika Anda menggunakan project yang sudah ada untuk panduan ini, pastikan Anda memiliki izin yang diperlukan untuk menyelesaikan panduan ini. Jika berhasil membuat project baru, berarti Anda sudah memiliki izin yang diperlukan.

Verify that billing is enabled for your Google Cloud project.

Enable the Google Kubernetes Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Instal Git. Git diperlukan untuk menyalin contoh ke komputer Anda.
2. Instal Docker. Docker diperlukan untuk membuat kode contoh. Pastikan akun pengguna lokal Anda dapat membuat penampung.
3. Instal plugin Cloud Code jika Anda belum melakukannya.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk menyelesaikan panduan memulai ini, minta administrator untuk memberi Anda peran IAM Kubernetes Engine Admin (roles/container.admin) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

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 Hello World dalam bahasa yang Anda inginkan.

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

4. Simpan aplikasi baru.

   Sebagai konfirmasi, notifikasi akan muncul dan memberi tahu bahwa aplikasi Anda telah dibuat, lalu aplikasi Anda akan dimuat di jendela baru yang 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 API container, pilih Ya.

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 konsol Google Cloud , 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 ditambahkan ke konfigurasi dan dikonfigurasi sebagai konteks aktif.

Menjalankan dan melihat aplikasi

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

Untuk menjalankan aplikasi, ikuti langkah-langkah berikut:

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

   

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

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

4. Jika diminta, pilih registry gambar untuk mengirimkan gambar. 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 dari tugas Jalankan di Kubernetes di bagian Sesi pengembangan. Jendela akan terbuka dengan tab Output yang menyertakan URL aplikasi Anda. Untuk membuka URL ini, tekan Control (atau Command di macOS), lalu klik alamat.

   Anda juga dapat menemukan aplikasi di Ringkasan beban kerja di konsol Google Cloud . 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, lalu luaskan bagian Kubernetes.

2. Klik kanan nama cluster Anda, lalu klik Setel sebagai Cluster Aktif.

Men-debug aplikasi Anda

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

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

   

2. Di menu Pilih 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 cluster yang diinginkan.

   Cloud Code menggunakan konfigurasi cloudcode.kubernetes dalam file .vscode/launch.json Anda 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 aktif Anda.

5. Sebelum sesi debugger dilampirkan, Anda akan diminta untuk mengonfirmasi atau memasukkan direktori di penampung jarak jauh tempat program yang akan di-debug berada 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 merah yang terisi menandakan titik henti sementara aktif, sedangkan lingkaran abu-abu kosong menandakan titik henti sementara dinonaktifkan. Untuk kontrol titik henti sementara yang lebih baik, Anda dapat menggunakan bagian Breakpoints di tampilan Debug VS Code.

   

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

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

   

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

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

   

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

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 container Anda

Untuk membuka terminal di container, 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 Pod, lalu bagian pod pilihan Anda

   • Bagian Containers

     

3. Klik kanan penampung 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 berjalan akan dihapus secara otomatis.

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 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):

Perhatian: Penghapusan project memiliki efek berikut:

• Semua hal dalam project akan dihapus. Jika Anda menggunakan project yang ada untuk mengerjakan tugas di dokumen ini, saat Anda menghapusnya, pekerjaan lain dalam project tersebut juga akan dihapus.
• Project ID kustom akan hilang. Saat membuat project ini, Anda mungkin juga membuat project ID kustom yang masih ingin digunakan pada masa mendatang. Agar tidak kehilangan URL yang menggunakan project ID tersebut, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.

Jika Anda berencana mempelajari berbagai arsitektur, tutorial, atau panduan memulai, project dapat digunakan kembali agar Anda tidak melampaui batas kuota project.

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 berikutnya

• Pertimbangkan untuk mengimpor aplikasi yang ada ke VS Code dan menyiapkan Cloud Code.
• Tangani konfigurasi Kubernetes dan Google Cloud yang lebih canggih dengan dukungan pengeditan YAML Cloud Code.
• Temukan dukungan penelusuran bug khusus bahasa yang disediakan Cloud Code.
• Percepat pengembangan Anda dengan sinkronisasi file dan pemuatan ulang cepat.
• Membuat dan mengonfigurasi cluster GKE
• Mengonfigurasi cluster pribadi
• Sesuaikan pengalaman Cloud Code Anda dengan mengonfigurasi setelan yang relevan.
• Deploy aplikasi Anda ke cluster GKE ARM64, AMD64, atau arsitektur campuran.