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
Masuk ke Azure: buka terminal atau prompt perintah Anda dan masuk ke akun Azure Anda menggunakan Azure CLI:
az login
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
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>"
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
Nama | Deskripsi | Nilai |
---|---|---|
type |
Jenis sumber daya | Microsoft.Kubernetes/ConnectedClusters |
apiVersion |
Versi API sumber daya. | 2024-01-01 |
name |
Nama sumber daya. | String (diperlukan) Batas karakter: 1-63 Karakter yang valid: Alfanumerik, garis bawah, dan tanda hubung. Mulai dan akhiri dengan alfanumerik. |
location |
Lokasi geografis tempat sumber daya berada. | String (diperlukan). |
tags |
Tag sumber daya. | Kamus nama dan nilai tag. Lihat Tag dalam templat. |
extendedLocation |
Lokasi komputer virtual yang diperluas. | ExtendedLocation |
identity |
Identitas kluster yang terhubung, jika dikonfigurasi. | |
properties |
Properti kluster yang terhubung. |
ProvisionedClusterInstances
Nama | Deskripsi | Nilai |
---|---|---|
type |
Jenis sumber daya | microsoft.hybridcontainerservice/provisionedclusterinstances |
apiVersion |
Versi API sumber daya | 2024-01-01 |
name |
Nama sumber daya | String (diperlukan). Jangan ubah ini dari default. |
properties |
Properti kluster yang terhubung. | |
extendedLocation |
Lokasi kluster yang diperluas. | ExtendedLocation |
ExtendedLocation
Nama | Deskripsi | Nilai |
---|---|---|
name |
ID lokasi yang diperluas. | string |
type |
Jenis lokasi yang diperluas. | Alokasi Kustom |