Bagikan melalui


Panduan mulai cepat AKS Edge Essentials

Mulai cepat ini menjelaskan cara menyiapkan kluster khusus Linux Azure Kubernetes Service (AKS) Edge Essentials.

Catatan

Tujuan dari skrip mulai cepat ini adalah untuk memudahkan proses evaluasi. Skrip ini memerlukan kredensial tingkat yang lebih tinggi untuk penyiapan satu kali langganan Azure. Ini tidak ditujukan untuk penggunaan produksi.

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 AksEdgeQuickStart skrip, Anda menerima Ketentuan Lisensi Perangkat Lunak Microsoft dan AcceptEULA bendera diatur untuk true menunjukkan penerimaan persyaratan lisensi.
  • Dapatkan parameter langganan Azure Anda: untuk menyambungkan kluster Anda ke Azure Arc, Anda harus menyediakan parameter ini. Jika Anda melewati parameter ini, koneksi Arc dilewati, tetapi kluster masih disebarkan:
    • Kredensial masuk Anda: Diperlukan untuk masuk interaktif ke Azure menggunakan Azure CLI. Akun Anda harus memiliki salah satu peran Owner ini atau atau Contributor Administrator.
    • ID <subscription-id>Langganan Anda : Di portal Azure, pilih langganan yang Anda gunakan dan cari ID langganan (GUID).
    • ID <tenant-id> Penyewa Anda : Di portal Azure, cari ID Microsoft Entra, yang akan membawa Anda ke halaman Direktori Default. Cari ID penyewa (GUID).
    • Lokasi (wilayah Azure) <location>: Tempat Anda ingin sumber daya Anda dibuat. Lihat Azure Arc menurut Wilayah untuk lokasi yang didukung oleh Azure Arc enabled servers dan Azure Arc enabled Kubernetes layanan. 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 default, ini mengunduh cabang utama saat ini.
  • Menggunakan skrip AksEdgeAzureSetup untuk meminta pengguna masuk ke portal Azure menggunakan kredensial Azure mereka dan melakukan tugas berikut:
    • Menginstal Azure CLI.
    • Membuat grup sumber daya aksedge-rp.
    • Membuat perwakilan layanan aksedge-sp dengan peran Kontributor dibatasi untuk cakupan grup sumber daya aksedge-rp . Jika perwakilan layanan sudah ada, perwakilan layanan akan mengatur ulang kata sandinya. 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 komputer tunggal dengan sakelar internal (hanya simpul Linux).
  • Memanggil Connect-AideArc fungsi jika parameter Azure disediakan. Fungsi ini melakukan tugas-tugas berikut:
    • Menginstal Azure Connected Machine Agent dan menyambungkan komputer host ke Arc for Servers.
    • Menyambungkan kluster yang disebarkan ke Arc untuk Kubernetes yang terhubung.

Tip

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

Langkah 2: Menyebarkan AKS Edge Essentials

Dalam prompt PowerShell yang ditingkatkan, jalankan AksEdgeQuickStart.ps1 skrip. Ini memunculkan kluster K3s:

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

Untuk menginstal versi K8s, tentukan -UseK8s bendera:

.\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.

Tip

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 berjalan.

  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 pembawa 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. Beban Kerja menunjukkan 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.

Tip

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