Condividi tramite

Guida introduttiva a Edge Essentials del servizio Azure Kubernetes

  • Articolo

Questo argomento di avvio rapido descrive come configurare un cluster edge Essentials (servizio Azure Kubernetes AKS) edge Essentials con un solo computer K3S basato su Linux.

Nota

Lo scopo di questo script di avvio rapido è semplificare il processo di valutazione. Questo script richiede credenziali di livello superiore per una configurazione monouso della sottoscrizione di Azure. Questo non è destinato all'uso in produzione.

Prerequisiti

  • Vedere i requisiti di sistema. Per questa guida introduttiva, assicurarsi di avere almeno 4,5 GB di RAM gratuiti, 4 vCPU e 20 GB di spazio libero su disco.
  • Requisiti del sistema operativo: installare Windows 10/11 IoT Enterprise/Enterprise/Pro nel computer e attivare Windows. È consigliabile usare la versione più recente del client 22H2 (build del sistema operativo 19045) o Server 2022 (build del sistema operativo 20348). Puoi scaricare una versione di Windows 10 qui o Windows 11 qui.
  • Vedere le Condizioni di licenza software Microsoft quando si applicano all'uso del software. Usando lo AksEdgeQuickStart script, si accettano le Condizioni di licenza software Microsoft e il AcceptEULA flag è impostato su true che indica l'accettazione delle condizioni di licenza.
  • Ottenere i parametri della sottoscrizione di Azure: per connettere il cluster ad Azure Arc, è necessario specificare questi parametri. Se si ignorano questi parametri, la connessione Arc viene ignorata, ma il cluster è ancora distribuito:
    • Credenziali di accesso: obbligatorio per l'accesso interattivo ad Azure tramite l'interfaccia della riga di comando di Azure. L'account deve avere uno di questi ruoli Owner o AdministratorContributor .
    • ID <subscription-id>sottoscrizione: nel portale di Azure selezionare la sottoscrizione in uso e cercare l'ID sottoscrizione (GUID).
    • ID <tenant-id>tenant: nella portale di Azure cercare Microsoft Entra ID, che dovrebbe visualizzare la pagina Directory predefinita. Cercare l'ID tenant (GUID).
    • Località (area di Azure): <location>posizione in cui si vogliono creare le risorse. Vedere Azure Arc per area per le località supportate da Azure Arc enabled servers e Azure Arc enabled Kubernetes i servizi. Scegliere un'area in cui entrambi sono supportati.

Passaggio 1: Scaricare lo script per semplificare la distribuzione

Scaricare lo AksEdgeQuickStart.ps1 script in una cartella di lavoro. A seconda della configurazione dei criteri nel computer, potrebbe essere necessario sbloccare il file prima di eseguire ed eseguire Set-ExecutionPolicy per consentire l'esecuzione dello script.

Aprire una finestra di PowerShell con privilegi elevati e passare alla directory in una cartella di lavoro:

$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

Questo script automatizza i passaggi seguenti:

  • Nella cartella di lavoro lo script scarica l'archivio GitHub di Azure/AKS-Edge e decomprime in una cartella AKS-Edge-main (o AKS-Edge-tag><). Per impostazione predefinita, viene scaricato il ramo principale corrente.
  • Usa lo script AksEdgeAzureSetup per richiedere all'utente di accedere al portale di Azure usando le credenziali di Azure ed eseguire le attività seguenti:
    • Installa l'interfaccia della riga di comando di Azure.
    • Crea un gruppo di risorse aksedge-rp.
    • Crea un'entità servizio aksedge-sp con il ruolo Collaboratore limitato all'ambito del gruppo di risorse aksedge-rp . Se l'entità servizio esiste già, reimposta la password. Questa entità servizio viene usata per connettersi ad Azure Arc.
    • Registra i provider di risorse Microsoft.HybridCompute, Microsoft.GuestConfiguration, Microsoft.HybridConnectivity, Microsoft.Kubernetes, Microsoft.KubernetesConfiguration e Microsoft.ExtendedLocation.
  • Richiama la funzione Start-AideWorkflow che esegue le attività seguenti:
    • Scarica e installa l'identità del servizio gestito di Azure Kubernetes Edge Essentials.
    • Installa le funzionalità del sistema operativo host necessarie (Install-AksEdgeHostFeatures). Il computer potrebbe essere riavviato quando Hyper-V è abilitato ed è necessario riavviare di nuovo lo script.
    • Distribuisce un singolo cluster di computer con commutatore interno (solo nodo Linux).
  • Richiama la Connect-AideArc funzione se vengono forniti i parametri di Azure. Questa funzione esegue le attività seguenti:
    • Installa l'agente di Azure Connected Machine e connette il computer host ad Arc per server.
    • Connette il cluster distribuito ad Arc per Kubernetes connesso.

Suggerimento

È possibile modificare il $aksedgeConfig contenuto JSON nello AksEdgeQuickStart script per eventuali opzioni aggiuntive. Per le opzioni disponibili, vedere Configurazione JSON della distribuzione.

Passaggio 2: Distribuire AKS Edge Essentials

In un prompt di PowerShell con privilegi elevati eseguire lo AksEdgeQuickStart.ps1 script. Verrà visualizzato un cluster K3s:

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

Per installare la versione K8s, specificare il -UseK8s flag :

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

Lo script installa Il servizio Azure Kubernetes Edge Essentials e connette il cluster ad Azure usando Azure Arc.

Suggerimento

Se Hyper-V non è stato abilitato nel computer, lo script di avvio rapido abilita Hyper-V e riavvia il computer. Eseguire di nuovo lo AksEdgeQuickStart script dopo il riavvio.

Passaggio 3: Verificare la distribuzione

  1. Verificare che la distribuzione sia stata eseguita correttamente eseguendo:

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

    L'immagine seguente mostra i pod in un cluster K3S:

    Screenshot che mostra tutti i pod in esecuzione.

  2. È possibile visualizzare il cluster nel portale di Azure se si passa al gruppo di risorse:

    Screenshot che mostra il cluster nel portale di Azure

  3. Nel pannello sinistro selezionare Spazi dei nomi in Risorse Kubernetes (anteprima):

    Screenshot delle risorse Kubernetes.

  4. Per visualizzare le risorse kubernetes, è necessario un token di connessione:

    Screenshot che mostra la pagina richiesta del token di connessione.

  5. È possibile eseguire Get-AksEdgeManagedServiceToken per recuperare il token del servizio:

    Screenshot che mostra dove incollare il token nel portale.

  6. È ora possibile visualizzare le risorse nel cluster. I carichi di lavoro mostrano i pod in esecuzione nel cluster.

    kubectl get pods --all-namespaces

    Screenshot che mostra tutti i pod in Arc.

È ora disponibile un cluster AKS Edge Essentials K3S connesso ad Arc con un nodo Linux. È possibile esplorare la distribuzione di un'applicazione Linux di esempio in questo cluster.

Suggerimento

Se non sono stati forniti i dettagli della sottoscrizione di Azure durante l'esecuzione dello AksEdgeQuickStart.ps1 script, è comunque possibile connettersi ad Azure Arc seguendo la procedura descritta in questo articolo.

Passaggi successivi