Prepara un cluster per Operazioni di Azure IoT

Per preparare un cluster Kubernetes abilitato per Azure Arc, è necessario:

• Una sottoscrizione Azure con il ruolo Owner o una combinazione dei ruoli Contributor e Amministratore accesso utente. È possibile controllare il livello di accesso passando alla sottoscrizione, selezionando Controlla di accesso (IAM) sul lato sinistro del portale di Azure e quindi selezionando Visualizzare l'accesso. Se non si ha una sottoscrizione Azure, crearne una gratuitamente prima di iniziare.

• Il interfaccia della riga di comando di Azure installato nel computer di sviluppo. Controlla le estensioni interfaccia della riga di comando di Azure disponibili per la versione minima richiesta per l'estensione connectedk8s. Usare az --version per controllare la versione e az upgrade per aggiornarla, se necessario. Per altre informazioni, vedere Installare il interfaccia della riga di comando di Azure.

• L'estensione connectedk8s per la interfaccia della riga di comando di Azure. Usare il comando seguente per aggiungere l'estensione o aggiornarla alla versione più recente:

  az extension add --upgrade --name connectedk8s
  

• Gruppo di risorse Azure. Per ogni gruppo di risorse è supportata una sola istanza di Operazioni di Azure IoT. Per creare un nuovo gruppo di risorse, usare il comando az group create. Per l'elenco delle aree Azure attualmente supportate, vedere Aree supportate.

  az group create --location $LOCATION --resource-group $RESOURCE_GROUP --subscription $SUBSCRIPTION_ID
  

• Hardware che soddisfa i requisiti di sistema:

  • Ambienti supportati da Operazioni di Azure IoT
  • Requisiti di sistema per Kubernetes con Azure Arc abilitato.
  • RequisitiK3s.

• Se si intende distribuire Operazioni di Azure IoT in un cluster multinodo con tolleranza di errore abilitata, esaminare i requisiti hardware e di archiviazione in Prepare Linux for Edge Volumes.

Per preparare un cluster Kubernetes abilitato per Azure Arc, è necessario:

• Sottoscrizione Azure. Se non si ha una sottoscrizione Azure, crearne una gratuitamente prima di iniziare.

• Hardware che soddisfa i requisiti di sistema:

  • Ambienti supportati da Operazioni di Azure IoT
  • Requisiti di sistema per Kubernetes con Azure Arc abilitato.
  • .NET Aspire requisiti e matrice di supporto.
  • .NET Aspire linee guida per la rete.

Per preparare un cluster Kubernetes abilitato per Azure Arc, è necessario:

• Sottoscrizione Azure. Se non si ha una sottoscrizione Azure, crearne una gratuitamente prima di iniziare.

• Un server o un cluster Azure Locale.

• Hardware che soddisfa i requisiti di sistema:

  • Ambienti supportati da Operazioni di Azure IoT
  • Requisiti di sistema per Kubernetes con Azure Arc abilitato.

Per preparare un cluster di carico di lavoro vSphere Kubernetes Service (VKS), è necessario:

• Una sottoscrizione Azure con il ruolo Owner o una combinazione dei ruoli Contributor e Amministratore accesso utente. È possibile controllare il livello di accesso passando alla sottoscrizione, selezionando Controlla di accesso (IAM) sul lato sinistro del portale di Azure e quindi selezionando Visualizzare l'accesso. Se non si ha una sottoscrizione Azure, crearne una gratuitamente prima di iniziare.

• Il interfaccia della riga di comando di Azure installato nel computer di sviluppo. Controlla le estensioni interfaccia della riga di comando di Azure disponibili per la versione minima richiesta per l'estensione connectedk8s. Usare az --version per controllare la versione e az upgrade per aggiornarla, se necessario. Per altre informazioni, vedere Installare il interfaccia della riga di comando di Azure.

• L'estensione connectedk8s per la interfaccia della riga di comando di Azure. Usare il comando seguente per aggiungere l'estensione o aggiornarla alla versione più recente:

  az extension add --upgrade --name connectedk8s
  

• Gruppo di risorse Azure. Per ogni gruppo di risorse è supportata una sola istanza di Operazioni di Azure IoT. Per creare un nuovo gruppo di risorse, usare il comando az group create. Per l'elenco delle aree Azure attualmente supportate, vedere Aree supportate.

  az group create --location $LOCATION --resource-group $RESOURCE_GROUP --subscription $SUBSCRIPTION_ID
  

• Utilizzando il servizio vSphere Kubernetes.

• Hardware che soddisfa i requisiti di sistema:

  • Ambienti supportati da Operazioni di Azure IoT
  • Requisiti di sistema per Kubernetes con Azure Arc abilitato.

SUBSCRIPTION_ID=<subscription-id>
RESOURCE_GROUP=<resource-group-name>
AIO_INSTANCE_NAME=<instance-name>
CLUSTER_NAME=<cluster-name>
LOCATION=<region>

$SUBSCRIPTION_ID = "<subscription-id>"
$RESOURCE_GROUP = "<resource-group-name>"
$AIO_INSTANCE_NAME = "<instance-name>"
$CLUSTER_NAME = "<cluster-name>"
$LOCATION = "<region>"

Per preparare un cluster Kubernetes K3s in Ubuntu:

1. Creare un cluster K3s a nodo singolo o multinodo. Per esempi, vedere la guida introduttiva di K3s o i progetti correlati a K3s.

2. Controlla che K3s sia installato kubectl. In caso contrario, seguire le istruzioni per installare kubectl su Linux.

   kubectl version --client
   

3. Seguire le istruzioni per installare Helm.

4. Crea un file YAML di configurazione K3s in .kube/config:

   mkdir ~/.kube
   sudo KUBECONFIG=~/.kube/config:/etc/rancher/k3s/k3s.yaml kubectl config view --flatten > ~/.kube/merged
   mv ~/.kube/merged ~/.kube/config
   chmod  0600 ~/.kube/config
   export KUBECONFIG=~/.kube/config
   #switch to k3s context
   kubectl config use-context default
   sudo chmod 644 /etc/rancher/k3s/k3s.yaml
   

5. Eseguire il comando seguente per aumentare i limiti di controllo/istanza dell'utente.

   echo fs.inotify.max_user_instances=8192 | sudo tee -a /etc/sysctl.conf
   echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
   
   sudo sysctl -p
   

6. Per prestazioni migliori, aumentare il limite del descrittore di file:

   echo fs.file-max = 100000 | sudo tee -a /etc/sysctl.conf
   
   sudo sysctl -p
   

Abilita Azure Arc nel tuo cluster K3s

Collega il tuo cluster ad Azure Arc così potrai gestirlo da remoto.

1. Da una macchina che ha kubectl accesso al tuo cluster, accedi a interfaccia della riga di comando di Azure con il tuo account utente Microsoft Entra che contiene i ruoli richiesti per l'abbonamento Azure:

   az login
   

   Se in qualsiasi momento ricevi un errore che dice che il tuo dispositivo deve essere gestito per accedere alla tua risorsa, riavvia az login e assicurati di accedere in modo interattivo tramite un browser.

2. Dopo aver effettuato l'accesso, la interfaccia della riga di comando di Azure mostra tutti i tuoi abbonamenti e indica il tuo abbonamento predefinito con un asterisco*. Per continuare con la sottoscrizione predefinita, selezionare Enter. In caso contrario, digitare il numero della sottoscrizione Azure che si desidera usare.

3. Registrare i provider di risorse necessari nella sottoscrizione.

   Note

   Devi eseguire questo passaggio solo una volta per abbonamento. Per registrare i fornitori di risorse, è necessario il permesso per svolgere l'operazione /register/action , che include i ruoli di Contributore e Proprietario in abbonamento. Per altre informazioni, vedere Provider e tipi di risorse di Azure.

   az provider register -n "Microsoft.ExtendedLocation"
   az provider register -n "Microsoft.Kubernetes"
   az provider register -n "Microsoft.KubernetesConfiguration"
   az provider register -n "Microsoft.IoTOperations"
   az provider register -n "Microsoft.DeviceRegistry"
   az provider register -n "Microsoft.SecretSyncController"
   

4. Usare il comando az connectedk8s connect per abilitare Arc il cluster Kubernetes e gestirlo come parte del gruppo di risorse Azure.

   az connectedk8s connect --name $CLUSTER_NAME -l $LOCATION --resource-group $RESOURCE_GROUP --subscription $SUBSCRIPTION_ID --enable-oidc-issuer --enable-workload-identity --disable-auto-upgrade
   

   Per evitare aggiornamenti non pianificati per Azure Arc e le estensioni di sistema Arc che Operazioni di Azure IoT usa come dipendenze, questo comando disabilita l'aggiornamento automatico. Invece, Aggiornare manualmente gli agenti in base alle esigenze.

   Importante

   Se l'ambiente usa un server proxy o un gateway Azure Arc, modificare il comando az connectedk8s connect con le informazioni del proxy:

   1. Seguire le istruzioni riportate in Connettersi usando un server proxy in uscita o Integrare i cluster Kubernetes in Azure Arc con Azure Arc Gateway.
   2. Aggiungere 169.254.169.254 al parametro --proxy-skip-range del comando az connectedk8s connect. Azure Registro dispositivi usa questo endpoint locale per ottenere i token di accesso per l'autorizzazione.

   Operazioni di Azure IoT non supporta i server proxy che richiedono un certificato attendibile.

5. Ottenere l'URL dell'autorità di certificazione del cluster.

   az connectedk8s show --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME --query oidcIssuerProfile.issuerUrl --output tsv
   

   Salvare l'output di questo comando da usare nei passaggi successivi.

6. Crea un file di configurazione K3s.

   sudo nano /etc/rancher/k3s/config.yaml
   

7. Aggiungere il contenuto seguente al file config.yaml, sostituendo il segnaposto <SERVICE_ACCOUNT_ISSUER> con l'URL dell'autorità di certificazione del cluster.

   kube-apiserver-arg:
    - service-account-issuer=<SERVICE_ACCOUNT_ISSUER>
    - service-account-max-token-expiration=24h
   

8. Salvare il file e uscire dall'editor nano.

9. Prepararsi per abilitare il servizio Azure Arc, posizione personalizzata, nel cluster Arc ottenendo l'ID dell'oggetto posizione personalizzata e salvandolo come variabile d'ambiente, OBJECT_ID. Devi accedere ad interfaccia della riga di comando di Azure con un account utente Microsoft Entra, non un principale di servizio, per eseguire correttamente il comando. Eseguire il comando seguente esattamente come scritto, senza modificare il valore GUID.

   export OBJECT_ID=$(az ad sp show --id bc313c14-388c-4e7d-a58e-70017303ee3b --query id -o tsv)
   

   Note

   Se viene visualizzato l'errore: "Impossibile recuperare l'oid dell'app 'custom-locations'. Procedere senza abilitare la funzionalità. Privilegi insufficienti per completare l'operazione", l'entità servizio potrebbe non disporre delle autorizzazioni necessarie per recuperare l'ID oggetto della posizione personalizzata. Accedi a interfaccia della riga di comando di Azure con un account utente Microsoft Entra che soddisfi i prerequisiti. Per altre informazioni, vedere Creare e gestire posizioni personalizzate.

10. Usare il comando az connectedk8s enable-features per abilitare la funzionalità di posizione personalizzata nel cluster Arc. Questo comando utilizza la variabile di ambiente OBJECT_ID che hai salvato nel passaggio precedente per impostare il valore del parametro custom-locations-oid. Eseguire questo comando nel computer in cui è stato distribuito il cluster Kubernetes:

    az connectedk8s enable-features -n $CLUSTER_NAME -g $RESOURCE_GROUP --custom-locations-oid $OBJECT_ID --features cluster-connect custom-locations
    

11. Riavviare K3s.

    systemctl restart k3s
    

Edge Essentials Servizio Azure Kubernetes è un'implementazione kubernetes locale di Servizio Azure Kubernetes (AKS) che automatizza l'esecuzione di applicazioni in contenitori su larga scala. .NET Aspire include una piattaforma Kubernetes supportata da Microsoft che comprende una distribuzione Kubernetes leggera con un ingombro ridotto e un'esperienza di installazione semplice che supporta hardware edge di classe PC o 'leggero'.

Lo scriptAksEdgeQuickStartForAio.ps1 automatizza la creazione e la connessione di un cluster ed è il percorso consigliato per distribuire Operazioni di Azure IoT su .NET Aspire.

Per istruzioni sull'esecuzione dello script, vedere Configurare un cluster .NET Aspire per Operazioni di Azure IoT.

• Per istruzioni su come creare e abilitare Arc su un cluster AKS in Azure Locale, vedere Creare cluster Kubernetes usando interfaccia della riga di comando di Azure.
• Per istruzioni su come distribuire un cluster del servizio Azure Kubernetes in Azure Locale con l'identità del carico di lavoro (anteprima) abilitata per la sicurezza avanzata, vedere Deploy e configurare l'identità del carico di lavoro in un cluster del servizio Azure Kubernetes. Puoi abilitare la funzione di identità del carico di lavoro solo durante la creazione del cluster. L'esecuzione di Operazioni di Azure IoT con impostazioni sicure richiede l'identità del carico di lavoro.

Di default, un cluster Kubernetes include un pool di nodi che può eseguire container Linux. Se aggiungi altri pool di nodi dopo la creazione, assicurati di impostare il sistema operativo su Linux. Operazioni di Azure IoT non supporta la distribuzione nei nodi di Windows.

Dopo aver avuto un cluster Kubernetes abilitato per Azure Arc, puoi distribuire Operazioni di Azure IoT.

Per preparare un cluster di carico di lavoro VKS, è necessario un cluster di carico VKS a nodo singolo o multi-nodo.

Aggiornare le impostazioni di ammissione di sicurezza dei pod

Prima di implementare Operazioni di Azure IoT, aggiorna le impostazioni di Pod Security Admission sul tuo cluster VKS. Applicando questo file, vengono create in anticipo le etichette del namespace e la sicurezza del pod viene impostata su privileged.

kubectl apply -f https://raw.githubusercontent.com/Azure-Samples/explore-iot-operations/main/samples/tanzu-config/psa.yaml

Abilita il tuo cluster VKS con Arc

Collega il tuo cluster ad Azure Arc così potrai gestirlo da remoto.

1. Sulla macchina dove hai distribuito il cluster Kubernetes, accedi ad interfaccia della riga di comando di Azure con il tuo account utente Microsoft Entra che contiene i ruoli richiesti per l'abbonamento Azure:

   az login
   

2. Dopo aver effettuato l'accesso, la interfaccia della riga di comando di Azure mostra tutti i tuoi abbonamenti e indica il tuo abbonamento predefinito con un asterisco*. Per continuare con la sottoscrizione predefinita, selezionare Enter. In caso contrario, digitare il numero della sottoscrizione Azure che si desidera usare.

3. Registrare i provider di risorse necessari nella sottoscrizione.

   Note

   Devi eseguire questo passaggio solo una volta per abbonamento. Per registrare i fornitori di risorse, è necessario il permesso per svolgere l'operazione /register/action , che include i ruoli di Contributore e Proprietario in abbonamento. Per altre informazioni, vedere Provider e tipi di risorse di Azure.

   az provider register -n "Microsoft.ExtendedLocation"
   az provider register -n "Microsoft.Kubernetes"
   az provider register -n "Microsoft.KubernetesConfiguration"
   az provider register -n "Microsoft.IoTOperations"
   az provider register -n "Microsoft.DeviceRegistry"
   az provider register -n "Microsoft.SecretSyncController"
   

4. Usare il comando az connectedk8s connect per abilitare Arc il cluster Kubernetes e gestirlo come parte del gruppo di risorse Azure.

   az connectedk8s connect --name $CLUSTER_NAME -l $LOCATION --resource-group $RESOURCE_GROUP --subscription $SUBSCRIPTION_ID --enable-oidc-issuer --enable-workload-identity --disable-auto-upgrade
   

   Per evitare aggiornamenti non pianificati per Azure Arc e le estensioni di sistema Arc che Operazioni di Azure IoT usa come dipendenze, questo comando disabilita l'aggiornamento automatico. Invece, Aggiornare manualmente gli agenti in base alle esigenze.

   Importante

   Se l'ambiente usa un server proxy o un gateway Azure Arc, modificare il comando az connectedk8s connect con le informazioni del proxy:

   1. Seguire le istruzioni riportate in Connettersi usando un server proxy in uscita o Integrare i cluster Kubernetes in Azure Arc con Azure Arc Gateway.
   2. Aggiungere 169.254.169.254 al parametro --proxy-skip-range del comando az connectedk8s connect. Azure Registro dispositivi usa questo endpoint locale per ottenere i token di accesso per l'autorizzazione.

   Operazioni di Azure IoT non supporta i server proxy che richiedono un certificato attendibile.

5. Configura l'identità del carico di lavoro sul tuo cluster VKS. Per le istruzioni, vedi Distribuisci e configura l'identità del carico di lavoro su un cluster AKS. L'esecuzione di Operazioni di Azure IoT con impostazioni sicure richiede l'identità del carico di lavoro.

6. Prepararsi per abilitare il servizio Azure Arc, posizione personalizzata, nel cluster Arc ottenendo l'ID dell'oggetto posizione personalizzata e salvandolo come variabile d'ambiente, OBJECT_ID. Devi accedere ad interfaccia della riga di comando di Azure con un account utente Microsoft Entra, non un principale di servizio, per eseguire correttamente il comando. Eseguire il comando seguente esattamente come scritto, senza modificare il valore GUID.

   export OBJECT_ID=$(az ad sp show --id bc313c14-388c-4e7d-a58e-70017303ee3b --query id -o tsv)
   

   Note

   Se viene visualizzato l'errore: "Impossibile recuperare l'oid dell'app 'custom-locations'. Procedere senza abilitare la funzionalità. Privilegi insufficienti per completare l'operazione", l'entità servizio potrebbe non disporre delle autorizzazioni necessarie per recuperare l'ID oggetto della posizione personalizzata. Accedi a interfaccia della riga di comando di Azure con un account utente Microsoft Entra che soddisfi i prerequisiti. Per altre informazioni, vedere Creare e gestire posizioni personalizzate.

7. Usare il comando az connectedk8s enable-features per abilitare la funzionalità di posizione personalizzata nel cluster Arc. Questo comando usa la variabile di ambiente OBJECT_ID salvata dal passaggio precedente per impostare il valore per il parametro custom-locations-oid. Eseguire questo comando nel computer in cui è stato distribuito il cluster Kubernetes:

   az connectedk8s enable-features -n $CLUSTER_NAME -g $RESOURCE_GROUP --custom-locations-oid $OBJECT_ID --features cluster-connect custom-locations