Tutorial - Menyebarkan aplikasi ke Azure Kubernetes Service (AKS)

Kubernetes menyediakan platform yang didistribusikan untuk aplikasi berkontainer. Anda membangun dan menyebarkan aplikasi dan layanan Anda sendiri ke dalam kluster Kubernetes dan membiarkan kluster mengelola ketersediaan dan konektivitas.

Anda dapat menyebarkan aplikasi sampel dengan dua cara:

• Sebarkan langsung ke kluster AKS dari stasiun kerja Anda.
• Sebarkan dengan menggunakan alur penyebaran otomatisasi. Di Azure, Anda dapat menggunakan:
  • Azure Pipelines
  • Tindakan GitHub
  • Cloud Native GitOps

Dalam tutorial ini, Anda menyebarkan aplikasi sampel ke dalam kluster Kubernetes langsung dari stasiun kerja Anda dan mengelola aplikasi dengan menggunakan desktop AKS. Anda akan mempelajari cara untuk:

• Perbarui file manifes Kubernetes.
• Sebarkan aplikasi di Kubernetes.
• Menguji aplikasi.
• Lihat kesehatan aplikasi, log, metrik, dan komposisi di desktop AKS.

Sebelum Anda mulai

Dalam tutorial sebelumnya, Anda mengemas aplikasi ke dalam gambar kontainer, mengunggah gambar ke Azure Container Registry, dan membuat kluster Kubernetes. Untuk menyelesaikan tutorial ini, Anda memerlukan file manifes Kubernetes yang telah aks-store-quickstart.yaml dibuat sebelumnya. File ini diunduh dalam kode sumber aplikasi dari Tutorial 1 - Siapkan aplikasi untuk AKS.

Tutorial ini membuat dan memperbarui sumber daya yang dapat ditagih, seperti layanan LoadBalancer. Gunakan identitas dengan izin untuk menyebarkan beban kerja ke AKS dan membaca sumber daya kluster.

Desktop AKS

Tutorial ini memerlukan penginstalan desktop AKS.

Azure CLI

Tutorial ini membutuhkan Azure CLI versi 2.0.53 atau versi yang lebih baru. Periksa versi Anda dengan az --version. Untuk memasang atau meningkatkan, lihat Pasang Azure CLI.

Azure PowerShell

Tutorial ini memerlukan Azure PowerShell versi 5.9.0 atau yang lebih baru. Periksa versi Anda dengan Get-InstalledModule -Name Az. Untuk menginstal atau memutakhirkan, lihat Menginstal Azure PowerShell.

Azure Developer CLI

Tutorial ini memerlukan Azure Developer CLI (azd) versi 1.5.1 atau yang lebih baru. Periksa versi Anda dengan azd version. Untuk menginstal atau meningkatkan, lihat Menginstal Azure Developer CLI.

Perbarui file manifes

Dalam tutorial ini, instans Azure Container Registry (ACR) Anda menyimpan gambar kontainer untuk aplikasi sampel. Untuk menyebarkan aplikasi, Anda harus memperbarui nama gambar dalam file manifes Kubernetes untuk menyertakan nama server login ACR Anda.

Desktop AKS

1. Pastikan Anda berada di direktori hasil kloning aks-store-demo, lalu buka aks-store-quickstart.yaml file manifes menggunakan editor teks.

2. image Perbarui properti untuk kontainer dengan mengganti ghcr.io/azure-samples dengan nama server login ACR Anda.

   containers:
   ...
   - name: order-service
     image: <acrName>.azurecr.io/aks-store-demo/order-service:1.0
   ...
   - name: product-service
     image: <acrName>.azurecr.io/aks-store-demo/product-service:1.0
   ...
   - name: store-front
     image: <acrName>.azurecr.io/aks-store-demo/store-front:1.0
   ...
   

Azure CLI

1. Pastikan Anda berada di direktori hasil kloning aks-store-demo, lalu buka file manifes aks-store-quickstart.yaml dengan editor teks.

2. image Perbarui properti untuk kontainer dengan mengganti ghcr.io/azure-samples dengan nama server login ACR Anda.

   containers:
   ...
   - name: order-service
     image: <acrName>.azurecr.io/aks-store-demo/order-service:1.0
   ...
   - name: product-service
     image: <acrName>.azurecr.io/aks-store-demo/product-service:1.0
   ...
   - name: store-front
     image: <acrName>.azurecr.io/aks-store-demo/store-front:1.0
   ...
   

3. Simpan dan tutup file.

4. Verifikasi bahwa aks-store-quickstart.yaml berada di direktori Anda saat ini sebelum melanjutkan.

Azure PowerShell

1. Pastikan Anda berada di direktori hasil kloning aks-store-demo, lalu buka file manifes aks-store-quickstart.yaml dengan editor teks.

2. image Perbarui properti untuk kontainer dengan mengganti ghcr.io/azure-samples dengan nama server login ACR Anda.

   containers:
   ...
   - name: order-service
     image: <acrName>.azurecr.io/aks-store-demo/order-service:1.0
   ...
   - name: product-service
     image: <acrName>.azurecr.io/aks-store-demo/product-service:1.0
   ...
   - name: store-front
     image: <acrName>.azurecr.io/aks-store-demo/store-front:1.0
   ...
   

3. Simpan dan tutup file.

4. Verifikasi bahwa aks-store-quickstart.yaml berada di direktori Anda saat ini sebelum melanjutkan.

Azure Developer CLI

azd tidak memerlukan langkah registri kontainer karena ada di templat.

Jalankan aplikasi

Desktop AKS

Menyebarkan dan mengelola aplikasi dengan menggunakan desktop AKS

Desktop AKS adalah portal pengembang yang berfokus pada aplikasi untuk Azure Kubernetes Service (AKS) yang menyederhanakan penyebaran dan manajemen aplikasi tanpa memerlukan keahlian Kubernetes yang mendalam.

Daftarkan kluster Anda dengan AKS Desktop

1. Pastikan Anda masuk ke desktop AKS dengan akun yang sama yang memiliki akses ke kluster AKS. Setelah masuk, pilih Tambahkan dari Langganan Azure.
2. Masukkan nama langganan Azure Jika Anda memiliki lebih dari satu langganan. (Atau, pilih panah untuk membuka daftar drop-down, lalu pilih langganan Azure Anda.)
3. Pilih kluster Anda, lalu pilih Daftarkan Kluster.

Lanjutkan saat status kluster muncul sebagai tersambung di desktop AKS.

Membuat Proyek terkelola di desktop AKS

1. Di desktop AKS, buka tab Proyek dan pilih Buat Project Terkelola Baru.

2. Konfigurasikan pengaturan Proyek berikut:

   • Dasar-dasar:
     • Nama Proyek: Misalnya, my-dev-frontend
     • Langganan: <your-subscription-name>
     • Kluster: <your-cluster-name>

   Nota

   Saat Anda mengatur langganan Azure dan kluster AKS, desktop AKS memeriksa dukungan fitur kluster dan langganan yang diperlukan.

   • Kebijakan Jaringan: Anda dapat membiarkan pengaturan default untuk mulai cepat ini atau memperbaruinya sesuai kebutuhan.

     • Untuk mengekspos aplikasi secara publik, ubah Ingress ke Allow all traffic.

   • Kuota Komputasi: Atur nilai untuk aplikasi pengujian.

   • Access: Tambahkan seseorang atau hapus entri dengan menghapus item baris.

3. Di bawah Tinjau, verifikasi pengaturan untuk Proyek Anda, lalu pilih Buat Proyek.

   

Menyebarkan aplikasi

1. Berikan nama aplikasi, lalu pilih Buat Aplikasi.

   

2. Pilih sumber untuk aplikasi Anda. Untuk contoh ini, pilih Kubernetes YAML>Berikutnya.

3. Buka aks-store-quickstart.yaml, salin dan tempel kontennya ke editor, lalu pilih Berikutnya.

4. Tinjau sumber daya yang dibuat, lalu pilih Sebarkan dan Tutup.

5. Sumber daya dapat memakan waktu beberapa menit untuk disebarkan. Selama periode ini, status proyek mungkin menampilkan Degraded saat kluster diskalakan.

6. Periksa status sumber daya aplikasi dengan memilih Sumber Daya lalu Beban Kerja.

   Anda dapat memaksa refresh layar dengan memilih opsi menu jendela atas Navigasi Muat>Ulang.

7. Pilih sumber daya beban kerja individual untuk melihat detail dan peristiwanya.

Azure CLI

1. Sebarkan aplikasi menggunakan kubectl apply perintah , yang mengurai file manifes dan membuat objek Kubernetes yang ditentukan.

   kubectl apply -f aks-store-quickstart.yaml
   

   Contoh output berikut menunjukkan sumber daya yang berhasil dibuat di kluster AKS:

   statefulset.apps/rabbitmq created
   service/rabbitmq created
   deployment.apps/order-service created
   service/order-service created
   deployment.apps/product-service created
   service/product-service created
   deployment.apps/store-front created
   service/store-front created
   

2. Periksa apakah deployment berhasil dengan melihat pod menggunakan perintah kubectl get pods.

   kubectl get pods
   

   Pastikan pod aplikasi menampilkan Running status sebelum Anda melanjutkan.

Azure PowerShell

1. Sebarkan aplikasi menggunakan kubectl apply perintah , yang mengurai file manifes dan membuat objek Kubernetes yang ditentukan.

   kubectl apply -f aks-store-quickstart.yaml
   

   Contoh output berikut menunjukkan sumber daya yang berhasil dibuat di kluster AKS:

   statefulset.apps/rabbitmq created
   service/rabbitmq created
   deployment.apps/order-service created
   service/order-service created
   deployment.apps/product-service created
   service/product-service created
   deployment.apps/store-front created
   service/store-front created
   

2. Periksa apakah deployment berhasil dengan melihat pod menggunakan perintah kubectl get pods.

   kubectl get pods
   

   Pastikan pod aplikasi menampilkan Running status sebelum Anda melanjutkan.

Azure Developer CLI

Deployment di azd dipecah menjadi beberapa tahap yang direpresentasikan oleh hook. azd di-deploy dengan semua hook secara bawaan.

1. Sebarkan aplikasi menggunakan azd up perintah .

   azd up
   

   Lanjutkan setelah azd up berhasil selesai dan menampilkan output deployment.

2. Pilih langganan dan wilayah mana yang akan dihosting sumber daya Azure Anda.

   ? Select an Azure Subscription to use:  [Use arrows to move, type to filter]
   > 1. My Azure Subscription (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
   Select an Azure location to use:  [Use arrows to move, type to filter]
   > 43. (US) East US 2 (eastus2)
   

   Anda dapat memperbarui variabel untuk AZURE_LOCATION dan AZURE_SUBSCRIPTION_ID dari dalam .azure/<your-env-name>/.env file.

Uji aplikasi

Ketika aplikasi berjalan, layanan Kubernetes mengekspos front end aplikasi ke internet. Diperlukan beberapa menit untuk menyelesaikan proses ini.

Desktop AKS

1. Dapatkan alamat IP publik dari Sumber Daya>Jaringan>Layanan: store-front>IP Eksternal.

2. Jelajahi aplikasi di desktop AKS, seperti melihat log dan metrik. Untuk informasi selengkapnya, lihat Gambaran umum desktop AKS.

Baris Perintah

1. Pantau kemajuan menggunakan perintah kubectl get service dengan argumen --watch.

   kubectl get service store-front --watch
   

   Awalnya, EXTERNAL-IP untuk layanan store-front ditampilkan sebagai <pending>:

   store-front   LoadBalancer   10.0.34.242   <pending>     80:30676/TCP   5s
   

2. Saat alamat EXTERNAL-IP berubah dari <pending> menjadi alamat IP publik, gunakan CTRL-C untuk menghentikan proses watch kubectl.

   Contoh output berikut menunjukkan alamat IP publik valid yang ditetapkan ke layanan:

   store-front   LoadBalancer   10.0.34.242   52.179.23.131   80:30676/TCP   67s
   

3. Lihat aplikasi yang sedang beraksi dengan membuka browser web dan menavigasi ke alamat IP eksternal layanan Anda: http://<external-ip>.

   

Jika aplikasi tidak dimuat, mungkin masalah otorisasi dengan registri gambar Anda. Untuk melihat status kontainer Anda, gunakan perintah kubectl get pods. Jika Anda tidak dapat menarik gambar kontainer, lihat Mengautentikasi dengan Azure Container Registry dari Azure Kubernetes Service.

portal Azure

Navigasi ke portal Azure untuk menemukan informasi penyebaran Anda.

1. Navigasi ke sumber daya kluster AKS Anda.

2. Dari menu layanan, di bawah Sumber Daya Kubernetes, pilih Layanan dan Ingress

3. Salin IP Eksternal yang ditampilkan pada kolom untuk layanan store-front.

4. Tempelkan IP ke browser Anda untuk mengunjungi halaman toko Anda.

   

Membersihkan sumber daya

Karena Anda memvalidasi fungsionalitas aplikasi, Anda sekarang dapat menghapus kluster dari aplikasi. Kami akan menyebarkan aplikasi lagi di tutorial berikutnya.

Desktop AKS

Nota

Jika Anda ingin melanjutkan ke langkah tutorial berikutnya, jangan hapus proyek desktop AKS.

Jika Anda sudah selesai, pilih ikon Hapus . Dalam pesan konfirmasi, pilih Hapus juga namespace.

Baris perintah

1. Hentikan dan hapus instans kontainer dan sumber daya menggunakan kubectl delete perintah .

   kubectl delete -f aks-store-quickstart.yaml
   

2. Periksa apakah semua pod aplikasi telah dihapus menggunakan kubectl get pods perintah .

   kubectl get pods
   

Langkah berikutnya

Dalam tutorial ini, Anda menyebarkan contoh aplikasi Azure ke kluster Kubernetes di AKS. Anda mempelajari cara untuk:

• Perbarui file manifes Kubernetes.
• Jalankan aplikasi di Kubernetes.
• Menguji aplikasi.

Dalam tutorial berikutnya, Anda mempelajari cara menggunakan layanan PaaS untuk beban kerja stateful di Kubernetes.

Menggunakan layanan PaaS untuk beban kerja stateful di AKS