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

Sebelum memulai

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.

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

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 membangun kode contoh. Pastikan akun pengguna lokal Anda dapat membangun container.
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 Admin Kubernetes Engine (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 Hello World Node.js pemula.

4. Simpan aplikasi baru.

   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) 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 Anda siap, 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 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 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 image registry untuk mengirim image. Jika Anda membuat image registry baru menggunakan gcr.io/PROJECT_ID, pastikan image registry 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 Workloads di Google Cloud konsol. Untuk mengetahui informasi selengkapnya tentang aplikasi yang 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.

   

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 aktif.

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 men-debug container.

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

   Lingkaran terisi merah menandakan breakpoint aktif, sedangkan lingkaran kosong abu-abu menandakan breakpoint dinonaktifkan. Untuk kontrol breakpoint yang lebih baik, Anda dapat menggunakan bagian Breakpoints di tampilan Debug VS Code.

   

   Saat Anda mengirim permintaan baru ke aplikasi, debugger akan berhenti di breakpoint aktif pertama.

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

   

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.

   

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

     

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 berjalan.

Pembersihan

Setelah Anda menghentikan aplikasi, semua resource Kubernetes yang di-deploy selama proses menjalankan 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):

Perhatian: Menghapus project memiliki efek berikut:

• Semua hal dalam project akan dihapus. Jika menggunakan project yang sudah ada untuk tugas dalam dokumen ini, saat Anda menghapusnya, pekerjaan lain yang telah Anda lakukan dalam project tersebut juga akan terhapus.
• Project ID kustom hilang. Saat membuat project ini, Anda mungkin telah membuat project ID kustom yang ingin digunakan di masa mendatang. Untuk mempertahankan URL yang menggunakan project ID, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.

Jika Anda berencana mempelajari beberapa arsitektur, tutorial atau panduan memulai, dengan menggunakan kembali project dapat membantu Anda agar tidak melampaui batas kuota project.

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

• Pertimbangkan untuk mengimpor aplikasi yang sudah ada ke VS Code dan menyiapkan Cloud Code.
• Atasi konfigurasi Kubernetes dan yang lebih canggih dengan dukungan pengeditan YAML Cloud Code's. Google Cloud
• Temukan dukungan proses debug khusus bahasa yang disediakan Cloud Code.
• Percepat pengembangan Anda dengan sinkronisasi file dan hot reloading.
• 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.