Bagikan melalui


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

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

Langkah berikutnya

Gambaran umum AKS Arc