Tutorial - Membuat kluster Azure Kubernetes Service (AKS)

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.

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.

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

• Instal kubectl secara lokal menggunakan az aks install-cli perintah .

  az aks install-cli
  

• Instal kubectl secara lokal menggunakan Install-AzAksCliTool cmdlet.

  Install-AzAksCliTool
  

azd lingkungan di codespace secara otomatis mengunduh semua dependensi yang ditemukan di ./devcontainer/devcontainer.json. Ini termasuk CLI Kubernetes bersama dengan gambar Azure Container Registry (ACR).

• Untuk menginstal kubectl secara lokal, gunakan az aks install-cli perintah .

  az aks install-cli
  

Untuk memungkinkan kluster AKS berinteraksi dengan sumber daya Azure lainnya, platform Azure secara otomatis membuat identitas kluster. Dalam contoh ini, identitas kluster diberikan hak untuk menarik gambar dari instans ACR yang Anda buat di tutorial sebelumnya. Agar berhasil menjalankan perintah, Anda harus memiliki peran Pemilik atau administrator akun Azure di langganan Azure Anda.

• Buat kluster AKS menggunakan az aks create perintah . Contoh berikut ini membuat kluster bernama myCluster di grup sumber daya bernama myResourceGroup. Grup sumber daya ini dibuat pada tutorial sebelumnya di wilayah eastus. Kami akan terus menggunakan variabel lingkungan, $ACRNAME, yang kami tetapkan dalam tutorial sebelumnya. Jika Anda tidak memiliki kumpulan variabel lingkungan ini, atur sekarang ke nilai yang sama dengan yang Anda gunakan sebelumnya.

  az aks create \
      --resource-group myResourceGroup \
      --name myAKSCluster \
      --node-count 2 \
      --generate-ssh-keys \
      --attach-acr $ACRNAME
  

  Catatan

  Jika Anda sudah membuat kunci SSH, Anda mungkin mengalami kesalahan yang mirip linuxProfile.ssh.publicKeys.keyData is invaliddengan . Untuk melanjutkan, coba lagi perintah tanpa --generate-ssh-keys parameter .

Untuk menghindari memerlukan peran administrator akun Pemilik atau peran administrator akun Azure, Anda juga dapat mengonfigurasi perwakilan layanan secara manual untuk menarik gambar dari ACR. Untuk mendapatkan informasi lebih lanjut, lihat autentikasi ACR dengan perwakilan layanan atau Autentikasi dari Kubernetes dengan rahasia pull. Atau, alih-alih menggunakan perwakilan layanan untuk manajemen yang lebih mudah, Anda dapat menggunakan identitas terkelola.

Untuk memungkinkan kluster AKS berinteraksi dengan sumber daya Azure lainnya, platform Azure secara otomatis membuat identitas kluster. Dalam contoh ini, identitas kluster diberikan hak untuk menarik gambar dari instans ACR yang Anda buat di tutorial sebelumnya. Agar berhasil menjalankan perintah, Anda harus memiliki peran Pemilik atau administrator akun Azure di langganan Azure Anda.

• Buat kluster AKS menggunakan New-AzAksCluster cmdlet . Contoh berikut ini membuat kluster bernama myCluster di grup sumber daya bernama myResourceGroup. Grup sumber daya ini dibuat pada tutorial sebelumnya di wilayah eastus.

  New-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -NodeCount 2 -GenerateSshKey -AcrNameToAttach $ACRNAME
  

  Catatan

  Jika Anda sudah membuat kunci SSH, Anda mungkin mengalami kesalahan yang mirip linuxProfile.ssh.publicKeys.keyData is invaliddengan . Untuk melanjutkan, coba lagi perintah tanpa -GenerateSshKey parameter .

Untuk menghindari memerlukan peran administrator akun Pemilik atau peran administrator akun Azure, Anda juga dapat mengonfigurasi perwakilan layanan secara manual untuk menarik gambar dari ACR. Untuk mendapatkan informasi lebih lanjut, lihat autentikasi ACR dengan perwakilan layanan atau Autentikasi dari Kubernetes dengan rahasia pull. Atau, alih-alih menggunakan perwakilan layanan untuk manajemen yang lebih mudah, Anda dapat menggunakan identitas terkelola.

azd mengemas penyebaran kluster dengan aplikasi itu sendiri menggunakan azd up perintah . Perintah ini tercakup dalam tutorial berikutnya.

1. Konfigurasikan kubectl untuk terhubung ke kluster Kubernetes menggunakan perintah az aks get-credentials. Contoh berikut mendapatkan kredensial untuk kluster AKS bernama myAKSCluster di myResourceGroup.

   az aks get-credentials --resource-group myResourceGroup --name myAKSCluster
   

2. Verifikasi koneksi ke kluster Anda menggunakan kubectl get nodes perintah , yang mengembalikan daftar node kluster.

   kubectl get nodes
   

   Contoh output berikut menunjukkan daftar node kluster.

   NAME                                STATUS   ROLES   AGE   VERSION
   aks-nodepool1-19366578-vmss000000   Ready    agent   47h   v1.28.9
   aks-nodepool1-19366578-vmss000001   Ready    agent   47h   v1.28.9
   

1. Konfigurasikan kubectl untuk terhubung ke kluster Kubernetes menggunakan Import-AzAksCredential cmdlet. Contoh berikut mendapatkan kredensial untuk kluster AKS bernama myAKSCluster di myResourceGroup.

   Import-AzAksCredential -ResourceGroupName myResourceGroup -Name myAKSCluster
   

2. Verifikasi koneksi ke kluster Anda menggunakan kubectl get nodes perintah , yang mengembalikan daftar node kluster.

   kubectl get nodes
   

   Contoh output berikut menunjukkan daftar node kluster.

   NAME                                STATUS   ROLES   AGE   VERSION
   aks-nodepool1-19366578-vmss000000   Ready    agent   47h   v1.28.9
   aks-nodepool1-19366578-vmss000001   Ready    agent   47h   v1.28.9
   

1. Konfigurasikan autentikasi ke kluster Anda menggunakan azd auth login perintah .

   azd auth login 
   

2. Ikuti petunjuk untuk metode autentikasi Anda.

3. Verifikasi koneksi ke kluster Anda menggunakan kubectl get nodes perintah .

   kubectl get nodes
   

   Contoh output berikut menunjukkan daftar node kluster

   NAME                                STATUS   ROLES   AGE   VERSION
   aks-nodepool1-19366578-vmss000000   Ready    agent   47h   v1.28.9
   aks-nodepool1-19366578-vmss000001   Ready    agent   47h   v1.28.9
   

solusi azd auth

Solusi ini mengharuskan Anda menginstal Azure CLI .

1. Buka jendela terminal dan masuk dengan Azure CLI menggunakan az login perintah dengan parameter yang --scope diatur ke https://graph.microsoft.com/.default.

   az login --scope https://graph.microsoft.com/.default
   

   Anda harus diarahkan ke halaman autentikasi di tab baru untuk membuat token akses browser, seperti yang ditunjukkan dalam contoh berikut:

   https://login.microsoftonline.com/organizations/oauth2/v2.0/authorize?clientid=<your_client_id>.
   

2. Salin URL localhost halaman web yang Anda terima setelah mencoba masuk dengan azd auth login.

3. Di jendela terminal baru, gunakan permintaan berikut curl untuk masuk. Pastikan Anda mengganti <localhost> tempat penampung dengan URL localhost yang Anda salin di langkah sebelumnya.

   curl <localhost>
   

   Login yang berhasil menghasilkan halaman web HTML, seperti yang ditunjukkan dalam contoh berikut:

   <!DOCTYPE html>
   <html>
   <head>
       <meta charset="utf-8" />
       <meta http-equiv="refresh" content="60;url=https://docs.microsoft.com/cli/azure/">
       <title>Login successfully</title>
       <style>
           body {
               font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
           }
   
           code {
               font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace;
               display: inline-block;
               background-color: rgb(242, 242, 242);
               padding: 12px 16px;
               margin: 8px 0px;
           }
       </style>
   </head>
   <body>
       <h3>You have logged into Microsoft Azure!</h3>
       <p>You can close this window, or we will redirect you to the <a href="https://docs.microsoft.com/cli/azure/">Azure CLI documentation</a> in 1 minute.</p>
       <h3>Announcements</h3>
       <p>[Windows only] Azure CLI is collecting feedback on using the <a href="https://learn.microsoft.com/windows/uwp/security/web-account-manager">Web Account Manager</a> (WAM) broker for the login experience.</p>
       <p>You may opt-in to use WAM by running the following commands:</p>
       <code>
           az config set core.allow_broker=true<br>
           az account clear<br>
           az login
       </code>
   </body>
   </html>
   

4. Tutup terminal saat ini dan buka terminal asli. Anda akan melihat daftar JSON langganan Anda.

5. id Salin bidang langganan yang ingin Anda gunakan.

6. Atur az account set langganan Anda menggunakan perintah .

   az account set --subscription <subscription_id>