Bagikan melalui

Panduan mulai cepat AKS Edge Essentials

Panduan ini menjelaskan cara menyiapkan kluster K3S khusus Linux Azure Kubernetes Service (AKS) Edge Essentials pada satu mesin.

Catatan

  • Tujuan dari skrip mulai cepat ini adalah untuk memudahkan proses evaluasi. Skrip ini memerlukan kredensial dengan tingkat yang lebih tinggi untuk penyiapan awal langganan Azure. Skrip tidak ditujukan untuk penggunaan produksi.
  • Secara default, skrip mulai cepat ini mengaktifkan plugin Key Management Service (KMS) (pratinjau) dengan mengatur Init.KmsPlugin menjadi true. Untuk informasi selengkapnya, lihat Mengaktifkan enkripsi rahasia pada kluster AKS Edge Essentials.

Prasyarat

  • Lihat persyaratan sistem. Untuk mulai cepat ini, pastikan Anda memiliki minimal 4,5 GB RAM gratis, 4 vCPU dan ruang disk kosong 20 GB.
  • Persyaratan OS: instal Windows 10/11 IoT Enterprise/Enterprise/Pro di komputer Anda dan aktifkan Windows. Sebaiknya gunakan klien terbaru versi 22H2 (OS build 19045) atau Server 2022 (OS build 20348). Anda dapat mengunduh versi Windows 10 di sini atau Windows 11 di sini.
  • Lihat Ketentuan Lisensi Perangkat Lunak Microsoft saat berlaku untuk penggunaan perangkat lunak oleh Anda. Dengan menggunakan skrip AksEdgeQuickStart, Anda menerima Ketentuan Lisensi Perangkat Lunak Microsoft dan penanda AcceptEULA diatur ke true guna menunjukkan penerimaan persyaratan lisensi.
  • Dapatkan parameter langganan Azure Anda: untuk menyambungkan kluster Anda ke Azure Arc, Anda harus menyediakan parameter ini. Jika Anda mengabaikan parameter ini, koneksi Arc diabaikan, tetapi kluster tetap diterapkan.
    • Kredensial masuk Anda: Diperlukan untuk masuk interaktif ke Azure menggunakan Azure CLI. Akun Anda harus memiliki salah satu dari peran ini: Owner, Contributor, atau Administrator.
    • ID Langganan Anda: Di portal Azure, pilih langganan yang Anda gunakan dan cari ID Langganan (GUID).
    • ID Penyewa Anda<tenant-id>: Di portal Azure, cari Microsoft Entra ID, yang akan membawa Anda ke halaman Default Directory. Cari ID penyewa (GUID).
    • Lokasi (wilayah Azure)<location>: Tempat Anda ingin sumber daya Anda dibuat. Lihat Azure Arc berdasarkan Wilayah untuk lokasi yang didukung oleh layanan Azure Arc enabled servers dan Azure Arc enabled Kubernetes. Pilih wilayah tempat keduanya didukung.

Langkah 1: Unduh skrip untuk penyebaran yang mudah

AksEdgeQuickStart.ps1 Unduh skrip ke folder yang berfungsi. Bergantung pada penyiapan kebijakan pada komputer Anda, Anda mungkin harus membuka blokir file sebelum menjalankan dan menjalankan Set-ExecutionPolicy untuk mengizinkan eksekusi skrip.

Buka jendela PowerShell yang ditingkatkan, dan ubah direktori ke folder yang berfungsi:

$url = "https://raw.githubusercontent.com/Azure/AKS-Edge/main/tools/scripts/AksEdgeQuickStart/AksEdgeQuickStart.ps1"
Invoke-WebRequest -Uri $url -OutFile .\AksEdgeQuickStart.ps1
Unblock-File .\AksEdgeQuickStart.ps1
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force

Skrip ini mengotomatiskan langkah-langkah berikut:

  • Di folder kerja, skrip mengunduh arsip GitHub Azure/AKS-Edge dan membuka zip ke folder AKS-Edge-main (atau AKS-Edge-tag<>). Secara otomatis, ini akan mengunduh cabang utama saat ini.
  • Menggunakan skrip AksEdgeAzureSetup untuk meminta pengguna masuk ke portal Azure menggunakan kredensial Azure mereka dan melakukan tugas berikut:
    • Memasang Azure CLI.
    • Membuat grup sumber daya aksedge-rp.
    • Membuat perwakilan layanan aksedge-sp dengan Kontributor peran yang dibatasi pada lingkup grup sumber daya aksedge-rp. Jika perwakilan layanan sudah ada, kata sandinya akan diatur ulang. Perwakilan layanan ini digunakan untuk menyambungkan ke Azure Arc.
    • Mendaftarkan penyedia sumber daya Microsoft.HybridCompute, Microsoft.GuestConfiguration, Microsoft.HybridConnectivity, Microsoft.Kubernetes, Microsoft.KubernetesConfiguration, dan Microsoft.ExtendedLocation.
  • Start-AideWorkflow Memanggil fungsi yang melakukan tugas berikut:
    • Mengunduh dan menginstal MSI AKS Edge Essentials.
    • Menginstal fitur OS host yang diperlukan (Install-AksEdgeHostFeatures). Komputer mungkin memulai ulang ketika Hyper-V diaktifkan, dan Anda harus memulai ulang skrip lagi.
    • Menyebarkan kluster mesin tunggal dengan switch internal (hanya node Linux).
  • Memanggil fungsi Connect-AideArc jika parameter Azure disediakan. Fungsi ini melakukan tugas-tugas berikut:
    • Menginstal Azure Connected Machine Agent dan menyambungkan komputer host ke Arc for Servers.
    • Menghubungkan kluster yang telah diterapkan ke Arc untuk integrasi dengan Kubernetes.

Kiat

Anda dapat mengubah $aksedgeConfig konten json dalam AksEdgeQuickStart skrip untuk opsi tambahan apa pun. Untuk opsi yang tersedia, lihat konfigurasi JSON penyebaran.

Langkah 2: Menyebarkan AKS Edge Essentials

Dalam prompt PowerShell yang memiliki elevasi, jalankan skrip AksEdgeQuickStart.ps1. Ini menghadirkan kluster K3s.

.\AksEdgeQuickStart.ps1 -SubscriptionId "<subscription-id>" -TenantId "<tenant-id>" -Location "<location>"

Untuk menginstal versi K8s, tentukan parameter -UseK8s:

.\AksEdgeQuickStart.ps1 -SubscriptionId "<subscription-id>" -TenantId "<tenant-id>" -Location "<location>" -UseK8s

Skrip menginstal AKS Edge Essentials dan menghubungkan kluster Anda ke Azure menggunakan Azure Arc.

Petunjuk

Jika Hyper-V tidak diaktifkan di komputer Anda, skrip mulai cepat mengaktifkan Hyper-V dan memulai ulang komputer Anda. Jalankan AksEdgeQuickStart skrip lagi setelah boot ulang.

Langkah 3: Memverifikasi penyebaran

  1. Konfirmasikan bahwa penyebaran berhasil dengan menjalankan:

    kubectl get nodes -o wide
kubectl get pods -A -o wide

    Gambar berikut menunjukkan pod pada kluster K3S:

    Cuplikan layar memperlihatkan semua pod yang aktif.

  2. Anda dapat melihat kluster di portal Azure jika Anda menavigasi ke grup sumber daya Anda:

    Cuplikan layar memperlihatkan kluster di portal microsoft Azure

  3. Di panel kiri, pilih Namespace di bawah sumber daya Kubernetes (pratinjau):

    Cuplikan layar sumber daya Kubernetes.

  4. Untuk melihat sumber daya Kubernetes, Anda memerlukan token pembawa:

    Cuplikan layar memperlihatkan halaman token akses yang diperlukan.

  5. Anda dapat menjalankan Get-AksEdgeManagedServiceToken untuk mengambil token layanan Anda:

    Cuplikan layar memperlihatkan tempat menempelkan token di portal.

  6. Sekarang Anda dapat melihat sumber daya di kluster Anda. Workloads menampilkan pod yang berjalan di kluster Anda.

    kubectl get pods --all-namespaces

    Cuplikan layar memperlihatkan semua pod di Arc.

Anda sekarang memiliki kluster AKS Edge Essentials K3S yang terhubung dengan Arc dengan node Linux. Anda dapat menjelajahi penyebaran contoh aplikasi Linux pada kluster ini.

Petunjuk

Jika Anda tidak memberikan detail langganan Azure saat menjalankan AksEdgeQuickStart.ps1 skrip, Anda masih bisa tersambung ke Azure Arc dengan mengikuti langkah-langkah dalam artikel ini.

Langkah berikutnya