Distribuire un cluster Kubernetes con il motore del servizio Azure Kubernetes nell'hub di Azure Stack

Articolo
12/01/2023

È possibile distribuire un cluster Kubernetes nell'hub di Azure Stack da una macchina virtuale client che esegue il motore del servizio Azure Kubernetes. In questo articolo viene esaminata la scrittura di una specifica del cluster, la distribuzione di un cluster con il file apimodel.json e il controllo del cluster distribuendo MySQL con Helm.

Definire una specifica del cluster

È possibile specificare una specifica del cluster in un file di documento usando il formato JSON denominato modello API. Il motore del servizio Azure Kubernetes usa una specifica del cluster nel modello API per creare il cluster.

È possibile trovare esempi del modello API per il sistema operativo e il numero di versione del motore del servizio Azure Kubernetes per le versioni recenti nel motore del servizio Azure Kubernetes e nel mapping di immagini corrispondente.

Trovare il numero di versione del motore del servizio Azure Kubernetes, ad esempio , v.0.63.0nella tabella.
Nella tabella Esempi di modelli API selezionare e aprire il collegamento per il sistema operativo.
Selezionare Non elaborato. È possibile usare l'URL nelle istruzioni seguenti.

Un URL del modello API può essere simile al seguente:

https://raw.githubusercontent.com/Azure/aks-engine-azurestack/master/examples/azure-stack/kubernetes-azurestack.json

Per ognuno degli esempi seguenti sostituire <URL for the API Model> con l'URL.

Aggiornare il modello API

Questa sezione esamina la creazione di un modello API per il cluster.

Iniziare usando un file modello api dell'hub di Azure Stack per Linux o Windows. Dal computer è stato installato il motore del servizio Azure Kubernetes, eseguire:
```
curl -o kubernetes-azurestack.json <URL for the API Model>
```
Nota

Se si è disconnessi, è possibile scaricare il file e copiarlo manualmente nel computer disconnesso in cui si prevede di modificarlo. È possibile copiare il file nel computer Linux usando strumenti come PuTTY o WinSCP.
Per aprire il modello API in un editor, è possibile usare nano:
```
nano ./kubernetes-azurestack.json
```
Nota

Se non è installato nano, è possibile installare nano in Ubuntu: sudo apt-get install nano.
Nel file kubernetes-azurestack.json trovare orchestratorRelease e orchestratorVersion. Selezionare una delle versioni di Kubernetes supportate; è possibile trovare la tabella della versione nelle note sulla versione. Specificare come orchestratorRelease x.xx e orchestratorVersion come x.xx.x. Per un elenco delle versioni correnti, vedere Versioni del motore del servizio Azure Kubernetes supportate
Trovare customCloudProfile e fornire l'URL al portale tenant. Ad esempio: https://portal.local.azurestack.external.
Aggiungere "identitySystem":"adfs" se si usa AD FS. Ad esempio,
```
    "customCloudProfile": {
        "portalURL": "https://portal.local.azurestack.external",
        "identitySystem": "adfs"
    },
```
Nota

Se si usa Microsoft Entra ID per il sistema di identità, non è necessario aggiungere il campo IdentitySystem.

In masterProfileimpostare i campi seguenti:

Campo	Descrizione
dnsPrefix	Immettere una stringa univoca che servirà per identificare il nome host delle macchine virtuali. Ad esempio, un nome basato sul nome del gruppo di risorse.
count	Immettere il numero di master desiderati per la distribuzione. Il minimo per una distribuzione di disponibilità elevata è 3, ma 1 è consentito per le distribuzioni non a disponibilità elevata.
vmSize	Immettere una dimensione supportata dall'hub di Azure Stack, ad esempio `Standard_D2_v2`.
Distro	Immettere `aks-ubuntu-18.04` o `aks-ubuntu-20.04`.

In agentPoolProfiles aggiornamento:

Campo	Descrizione
count	Immettere il numero di agenti desiderati per la distribuzione. Il numero massimo di nodi da usare per sottoscrizione è 50. Se si distribuiscono più cluster per sottoscrizione, assicurarsi che il numero totale di agenti non vada oltre 50. Assicurarsi di usare gli elementi di configurazione specificati nel file JSON del modello API di esempio.
vmSize	Immettere una dimensione supportata dall'hub di Azure Stack, ad esempio `Standard_D2_v2`.
Distro	Immettere `aks-ubuntu-18.04`, `aks-ubuntu-20.04` o `Windows`. Usare `Windows` per gli agenti che verranno eseguiti in Windows. Ad esempio, vedere kubernetes-windows.json

In linuxProfile aggiornamento:

Campo	Descrizione
adminUsername	Immettere il nome utente dell'amministratore della macchina virtuale.
ssh	Immettere la chiave pubblica che verrà usata per l'autenticazione SSH con macchine virtuali. Usare `ssh-rsa` e quindi la chiave. Per istruzioni sulla creazione di una chiave pubblica, vedere Creare una chiave SSH per Linux.

Se si esegue la distribuzione in una rete virtuale personalizzata, è possibile trovare istruzioni per trovare e aggiungere la chiave e i valori necessari alle matrici appropriate nel modello API in Distribuire un cluster Kubernetes in una rete virtuale personalizzata.

Nota

Il motore del servizio Azure Kubernetes per l'hub di Azure Stack non consente di fornire certificati personalizzati per la creazione del cluster.

Se si usa Windows, aggiornare windowsProfile i valori di adminUsername: e adminPassword:

"windowsProfile": {
"adminUsername": "azureuser",
"adminPassword": "",
"sshEnabled": true
}

Altre informazioni sul modello API

Per un riferimento completo di tutte le opzioni disponibili nel modello API, fare riferimento alle definizioni del cluster.
Per informazioni dettagliate sulle opzioni specifiche per l'hub di Azure Stack, vedere le specifiche specifiche della definizione del cluster dell'hub di Azure Stack.

Aggiungere il certificato quando si usa ASDK

Se si distribuisce un cluster in Azure Stack Development Kit (ASDK) e si usa Linux, è necessario aggiungere il certificato radice all'archivio certificati attendibile della macchina virtuale client che esegue il motore del servizio Azure Kubernetes.

Trovare il certificato radice nella macchina virtuale in questa directory: /var/lib/waagent/Certificates.pem.

Copiare il file di certificato:

sudo cp /var/lib/waagent/Certificates.pem /usr/local/share/ca-certificates/azurestacka.crt
sudo update-ca-certificates

Distribuire un cluster Kubernetes

Dopo aver raccolto tutti i valori necessari nel modello API, è possibile creare il cluster. A questo punto è consigliabile:

Chiedere all'operatore hub di Azure Stack di:

Verificare l'integrità del sistema, suggerire l'esecuzione Test-AzureStack e lo strumento di monitoraggio hardware del fornitore OEM.
Verificare la capacità di sistema, ad esempio risorse come memoria, archiviazione e indirizzi IP pubblici.
Specificare i dettagli della quota associata alla sottoscrizione in modo che sia possibile verificare che sia ancora disponibile spazio sufficiente per il numero di macchine virtuali che si prevede di usare.

Procedere alla distribuzione di un cluster:

Esaminare i parametri disponibili per il motore del servizio Azure Kubernetes nei flag dell'interfaccia della riga di comando dell'hub di Azure Stack.

Parametro	Esempio	Descrizione
azure-env	AzureStackCloud	Per indicare al motore del servizio Azure Kubernetes che la piattaforma di destinazione è l'uso dell'hub `AzureStackCloud`di Azure Stack.
identity-system	Adfs	facoltativo. Specificare la soluzione di gestione delle identità se si usa Active Directory Federated Services (AD FS).
posizione	locali	Nome dell'area per l'hub di Azure Stack. Per ASDK, l'area è impostata su `local`.
resource-group	kube-rg	Immettere il nome di un nuovo gruppo di risorse o selezionare un gruppo di risorse esistente. Il nome della risorsa deve essere alfanumerico e minuscolo.
api-model	./kubernetes-azurestack.json	Percorso del file di configurazione del cluster o modello API.
output-directory	kube-rg	Immettere il nome della directory per contenere il file di output apimodel.json e altri file generati.
client-id	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx	Immettere il GUID dell'entità servizio. ID client identificato come ID applicazione quando l'amministratore dell'hub di Azure Stack ha creato l'entità servizio.
client-secret	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx	Immettere il segreto dell'entità servizio. È stato configurato il segreto client durante la creazione del servizio.
subscription-id	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx	Immettere l'ID sottoscrizione. È necessario specificare una sottoscrizione per il tenant. La distribuzione nella sottoscrizione amministrativa non è supportata. Per altre informazioni, vedere Sottoscrivere un'offerta

Esempio:

Nota

Per AKSe versione 0.75.3 e versioni successive, il comando per distribuire un cluster del motore del servizio Azure Kubernetes è aks-engine-azurestack deploy.

aks-engine deploy \
--azure-env AzureStackCloud \
--location <for asdk is local> \
--resource-group kube-rg \
--api-model ./kubernetes-azurestack.json \
--output-directory kube-rg \
--client-id xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
--client-secret xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
--subscription-id xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
--identity-system adfs # required if using AD FS

Se per qualche motivo l'esecuzione ha esito negativo dopo la creazione della directory di output, è possibile correggere il problema ed eseguire nuovamente il comando. Se si esegue nuovamente la distribuzione ed è stata usata la stessa directory di output precedente, il motore del servizio Azure Kubernetes restituirà un errore che indica che la directory esiste già. È possibile sovrascrivere la directory esistente usando il flag: --force-overwrite.
Salvare la configurazione del cluster del motore del servizio Azure Kubernetes in un percorso sicuro e crittografato.

Individuare il file apimodel.json. Salvarlo in una posizione sicura. Questo file verrà usato come input in tutte le altre operazioni del motore del servizio Azure Kubernetes.

Il file apimodel.json generato contiene l'entità servizio, il segreto e la chiave pubblica SSH usata nel modello API di input. Il file include anche tutti gli altri metadati necessari dal motore del servizio Azure Kubernetes per eseguire tutte le altre operazioni. Se si perde il file, il motore del servizio Azure Kubernetes non sarà in grado di configurare il cluster.

I segreti non crittografati. Mantenere il file in un luogo crittografato e sicuro.

Verificare il cluster

Controllare il cluster connettendosi a kubectl, ottenere le informazioni e quindi ottenere gli stati dei nodi.

Ottenere il kubeconfig file da connettere al piano di controllo.
- Se è kubectl già stato installato, controllare il file per il kubeconfig cluster appena creato in questo percorso /kubeconfig/kubeconfig.jsondella directory . È possibile aggiungere l'oggetto /kubeconfig.json.kube alla directory per accedere al nuovo cluster.
  Se non è stato installato kubectl, visitare Installa strumenti per installare lo strumento da riga di comando Kubernetes. In caso contrario, seguire le istruzioni seguenti per accedere al cluster da uno dei nodi del piano di controllo.
Ottenere l'indirizzo IP pubblico di uno dei nodi del piano di controllo usando il portale dell'hub di Azure Stack.
Da un computer con accesso all'istanza dell'hub di Azure Stack connettersi tramite SSH al nuovo nodo del piano di controllo usando un client, ad esempio PuTTY o MobaXterm.
Per il nome utente SSH, usare "azureuser" e il file di chiave privata della coppia di chiavi fornita per la distribuzione del cluster.

Verificare che gli endpoint del cluster siano in esecuzione:

kubectl cluster-info

L'output dovrebbe essere simile al seguente:

Kubernetes master is running at https://democluster01.location.domain.com
CoreDNS is running at https://democluster01.location.domain.com/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy
Metrics-server is running at https://democluster01.location.domain.com/api/v1/namespaces/kube-system/services/https:metrics-server:/proxy

Esaminare quindi gli stati del nodo:

kubectl get nodes

L'output avrà un aspetto analogo al seguente:

k8s-linuxpool-29969128-0   Ready      agent    9d    v1.15.5
k8s-linuxpool-29969128-1   Ready      agent    9d    v1.15.5
k8s-linuxpool-29969128-2   Ready      agent    9d    v1.15.5
k8s-master-29969128-0      Ready      master   9d    v1.15.5
k8s-master-29969128-1      Ready      master   9d    v1.15.5
k8s-master-29969128-2      Ready      master   9d    v1.15.5

Risolvere i problemi di distribuzione del cluster

Quando si verificano errori durante la distribuzione di un cluster Kubernetes usando il motore del servizio Azure Kubernetes, è possibile controllare:

Si usano le credenziali dell'entità servizio corrette (SPN)?
Il nome SPN ha un ruolo "Collaboratori" alla sottoscrizione dell'hub di Azure Stack?
È disponibile una quota sufficiente nel piano dell'hub di Azure Stack?
L'istanza dell'hub di Azure Stack ha una patch o un aggiornamento da applicare?

Per altre informazioni, vedere l'articolo Risoluzione dei problemi nel repository GitHub azure/aks-engine-azurestack .

Ruotare il segreto del servizio

Dopo la distribuzione del cluster Kubernetes con il motore del servizio Azure Kubernetes, l'entità servizio viene usata per gestire le interazioni con l'Resource Manager di Azure nell'istanza dell'hub di Azure Stack. A un certo punto, il segreto per questa entità servizio potrebbe scadere. Se il segreto scade, è possibile aggiornare le credenziali in base a:

Aggiornamento di ogni nodo con il nuovo segreto dell'entità servizio.
Oppure aggiornare le credenziali del modello API ed eseguire l'aggiornamento.

Aggiornare manualmente ogni nodo

Ottenere un nuovo segreto per l'entità servizio dall'operatore cloud. Per istruzioni per l'hub di Azure Stack, vedere Usare un'identità dell'app per accedere alle risorse dell'hub di Azure Stack.
Usare le nuove credenziali fornite dall'operatore cloud per aggiornare /etc/kubernetes/azure.json in ogni nodo. Dopo aver eseguito l'aggiornamento, riavviare sia kubele che kube-controller-manager.

Aggiornare il cluster con l'aggiornamento del motore del servizio Azure Kubernetes

In alternativa, è possibile sostituire le credenziali nell'apimodel.json ed eseguire l'aggiornamento usando il file .json aggiornato alla stessa versione di Kubernetes o successiva. Per istruzioni sull'aggiornamento del modello, vedere Aggiornare un cluster Kubernetes nell'hub di Azure Stack

Passaggi successivi

Risolvere i problemi del motore del servizio Azure Kubernetes nell'hub di Azure Stack

Condividi tramite