Mulai cepat: menyebarkan kluster Kubernetes menggunakan templat Azure Resource Manager

Berlaku untuk: Azure Local, versi 23H2

Panduan cepat ini memperlihatkan cara menyebarkan sebuah kluster Kubernetes pada AKS Arc dengan menggunakan templat Azure Resource Manager (ARM). Azure Arc memperluas kemampuan manajemen Azure ke kluster Kubernetes di mana saja, menyediakan pendekatan terpadu untuk mengelola lingkungan yang berbeda.

Sebelum Anda mulai

Artikel ini mengasumsikan pemahaman dasar tentang konsep Kube.

Untuk menyebarkan templat ARM, Anda membutuhkan akses tulis pada sumber daya yang Anda sebarkan, dan akses ke setiap operasi dari jenis sumber daya Microsoft.Resources/deployments. Misalnya, untuk menyebarkan komputer virtual, Anda memerlukan izin Microsoft.Compute/virtualMachines/write dan Microsoft.Resources/deployments/* . Untuk daftar peran dan izin, lihat Peran bawaan Azure.

Prasyarat

• Akun Azure dengan langganan aktif.
• Kluster Azure Local versi 23H2.
• Versi Azure CLI terbaru.

Langkah 1: Siapkan akun Azure Anda

1. Masuk ke Azure: buka terminal atau prompt perintah Anda dan masuk ke akun Azure Anda menggunakan Azure CLI:

   az login
   

2. Atur langganan Anda: ganti <your-subscription-id> dengan ID langganan Anda:

   az account set --subscription "<your-subscription-id>"
   

Langkah 2: Membuat pasangan kunci SSH menggunakan Azure CLI

az sshkey create --name "mySSHKey" --resource-group "myResourceGroup"

atau, buat pasangan kunci SSH menggunakan ssh-keygen:

ssh-keygen -t rsa -b 4096

Untuk menyebarkan templat, Anda harus menyediakan kunci publik dari pasangan SSH. Untuk mengambil kunci publik, gunakan az sshkey show perintah :

az sshkey show --name "mySSHKey" --resource-group "myResourceGroup" --query "publicKey"

Secara default, file kunci SSH dibuat di direktori ~/.ssh . Jalankan az sshkey create perintah atau ssh-keygen untuk menimpa pasangan kunci SSH yang ada dengan nama yang sama.

Untuk mengetahui informasi selengkapnya tentang membuat kunci SSH, lihat Membuat dan mengelola kunci SSH untuk autentikasi di Azure.

Langkah 3: Tinjau templat

Unduh file templat dan parameter dari repositori AKSArc ke komputer lokal Anda. Tinjau semua nilai default dan pastikan nilai tersebut benar.

Langkah 4: Menyebarkan templat

Untuk menyebarkan kluster Kubernetes, jalankan perintah berikut:

az deployment group create \
--name "<deployment-name>" \
--resource-group "<resource-group-name>" \
--template-file "azuredeploy.json" \
--parameters "azuredeploy.parameters.json"

Perlu waktu beberapa menit untuk membuat kluster tersebut. Tunggu hingga kluster berhasil disebarkan sebelum Anda melanjutkan ke langkah berikutnya.

Langkah 5: Verifikasi penyebaran

Setelah penyebaran selesai, gunakan perintah berikut untuk memverifikasi bahwa kluster Kubernetes Anda aktif dan berjalan:

az aksarc show --resource-group "<resource-group-name>" --name "<cluster-name>" --output table

Langkah 6: Sambungkan ke kluster

1. Untuk menyambungkan ke kluster, jalankan az connectedk8s proxy perintah . Perintah mengunduh dan menjalankan biner proksi pada komputer klien, dan mengambil file kubeconfig yang terkait dengan kluster:

   az connectedk8s proxy --name <cluster name> -g <resource group>
   

   Atau, gunakan klien baris perintah Kube, kubectl. Jika Anda menggunakan Azure Cloud Shell, kubectl sudah diinstal. Untuk menginstal dan menjalankan kubectl secara lokal, jalankan az aksarc install-cli perintah .

   Konfigurasikan kubectl untuk terhubung ke kluster Kubernetes menggunakan az aksarc get-credentials perintah . Perintah ini mengunduh informasi masuk dan mengonfigurasi CLI Kube untuk menggunakannya:

   az aksarc get-credentials --resource-group "<resource-group-name>" --name "<cluster-name>"
   

2. Verifikasi koneksi ke kluster Anda menggunakan kubectl get perintah . Perintah ini mengembalikan daftar node kluster:

   kubectl get nodes -A --kubeconfig .\<path to kubecofig> 
   

   Contoh output berikut menunjukkan tiga simpul yang dibuat di langkah-langkah sebelumnya. Pastikan status simpul Siap:

   NAME                                STATUS   ROLES   AGE   VERSION
   aks-agentpool-27442051-vmss000000   Ready    agent   10m   v1.27.7
   aks-agentpool-27442051-vmss000001   Ready    agent   10m   v1.27.7
   aks-agentpool-27442051-vmss000002   Ready    agent   11m   v1.27.7
   

Langkah 7: Menyebarkan kumpulan simpul menggunakan templat Azure Resource Manager (opsional)

Serupa dengan langkah 3, unduh templat dan parameter kumpulan simpul dari repositori AKSArc dan periksa nilai default.

Menyebarkan templat dan memvalidasi hasil menggunakan Azure CLI (opsional)

Tinjau dan terapkan templat. Proses ini membutuhkan waktu beberapa menit untuk diselesaikan. Anda dapat menggunakan Azure CLI untuk memvalidasi bahwa kumpulan simpul berhasil dibuat:

az deployment group create \
--name "<deployment-name>" \
--resource-group "<resource-group-name>" \
--template-file "azuredeploy.json" \
--parameters "azuredeploy.parameters.json"

az aksarc nodepool show --cluster-name "<cluster-name>" --resource-group "<resource-group-name>" --name "<nodepool-name>"

Sumber daya templat

connectedClusters

ProvisionedClusterInstances

ExtendedLocation

Langkah berikutnya

Gambaran umum AKS Arc