Esercitazione: Creare un cluster Azure Red Hat OpenShift 4

Articolo
10/18/2023

In questa esercitazione, parte 1 di tre, si prepara l'ambiente per creare un cluster Azure Red Hat OpenShift che esegue OpenShift 4 e creare un cluster. Scopri come:

Configurare i prerequisiti
Creare la rete virtuale e le subnet necessarie
Distribuire un cluster

Operazioni preliminari

Se si sceglie di installare e usare l'interfaccia della riga di comando in locale, per questa esercitazione è necessario eseguire l'interfaccia della riga di comando di Azure versione 2.30.0 o successiva. Eseguire az --version per trovare la versione. Se è necessario eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure.

Azure Red Hat OpenShift richiede almeno 40 core per creare ed eseguire un cluster OpenShift. La quota di risorse di Azure predefinita per una nuova sottoscrizione di Azure non soddisfa questo requisito. Per richiedere un aumento del limite di risorse, vedere Quota standard: aumentare i limiti per serie di macchine virtuali.

Ad esempio, per controllare la quota di sottoscrizione corrente dello SKU della famiglia di macchine virtuali più piccola supportata "DSv3 standard":
```
LOCATION=eastus
az vm list-usage -l $LOCATION \
--query "[?contains(name.value, 'standardDSv3Family')]" \
-o table
```

Verificare le autorizzazioni

Durante questa esercitazione si creerà un gruppo di risorse che contiene la rete virtuale per il cluster. A tale scopo, sono necessarie le autorizzazioni Collaboratore e Accesso utente Amministrazione istrator o Proprietario, direttamente nella rete virtuale o nel gruppo di risorse o nella sottoscrizione che lo contiene.

Sono necessarie anche autorizzazioni di Microsoft Entra sufficienti (un utente membro del tenant o un guest assegnato con l'amministratore applicazione ruolo) per consentire agli strumenti di creare un'applicazione e un'entità servizio per conto del cluster. Per altri dettagli, vedere Membri e guest e Assegnare ruoli di amministratore e non amministratore agli utenti con MICROSOFT Entra ID .

Registrare i provider di risorse

Se sono presenti più sottoscrizioni di Azure, specificare l'ID sottoscrizione pertinente:
```
az account set --subscription <SUBSCRIPTION ID>
```
Registrare il provider di risorse Microsoft.RedHatOpenShift:
```
az provider register -n Microsoft.RedHatOpenShift --wait
```
Registrare il provider di risorse Microsoft.Compute:
```
az provider register -n Microsoft.Compute --wait
```
Registrare il provider di risorse Microsoft.Storage:
```
az provider register -n Microsoft.Storage --wait
```
Registrare il provider di risorse Microsoft.Authorization:
```
az provider register -n Microsoft.Authorization --wait
```

Ottenere un segreto pull di Red Hat (facoltativo)

Nota

Il segreto pull ARO non modifica il costo della licenza RH OpenShift per ARO.

Un segreto di pull di Red Hat consente al cluster di accedere ai registri contenitori Red Hat, insieme ad altri contenuti, ad esempio operatori di OperatorHub. Questo passaggio è facoltativo ma consigliato. Se si decide di aggiungere il segreto pull in un secondo momento, seguire queste indicazioni. Il campo cloud.openshift.com viene rimosso dal segreto anche se il segreto pull contiene tale campo. Questo campo abilita una funzionalità di monitoraggio aggiuntiva, che invia i dati a RedHat ed è quindi disabilitata per impostazione predefinita. Per abilitare questa funzionalità, vedere https://docs.openshift.com/container-platform/4.11/support/remote_health_monitoring/enabling-remote-health-reporting.html .

Passare al portale di Gestione cluster Di Red Hat OpenShift e accedere.

Dovrai accedere al tuo account Red Hat o creare un nuovo account Red Hat con il tuo indirizzo di posta elettronica aziendale e accettare i termini e le condizioni.
Selezionare Scarica segreto pull e scaricare un segreto pull da usare con il cluster ARO.

Conservare il file pull-secret.txt salvato in una posizione sicura. Il file verrà usato per ogni creazione di cluster se è necessario creare un cluster che includa gli esempi o gli operatori per Red Hat o i partner certificati.

Quando si esegue il comando az aro create, è possibile fare riferimento al segreto di pull usando il parametro --pull-secret @pull-secret.txt. Eseguire az aro create dalla directory in cui è stato archiviato il file pull-secret.txt. In caso contrario, sostituire @pull-secret.txt con @/path/to/my/pull-secret.txt.

Se si copia il segreto pull o lo si fa riferimento in altri script, il segreto pull deve essere formattato come stringa JSON valida.

Preparare un dominio personalizzato per il cluster (facoltativo)

Quando si esegue il comando az aro create, è possibile specificare un dominio personalizzato per il cluster con il parametro --domain foo.example.com.

Nota

Anche se l'aggiunta di un nome di dominio è facoltativa quando si crea un cluster tramite l'interfaccia della riga di comando di Azure, è necessario un nome di dominio (o un prefisso usato come parte del nome DNS generato automaticamente per la console di OpenShift e i server API) quando si aggiunge un cluster tramite il portale. Per altre informazioni, vedere Avvio rapido: Distribuire un cluster Azure Red Hat OpenShift usando il portale di Azure.

Se si specifica un dominio personalizzato per il cluster, tenere presente quanto segue:

Dopo aver creato il cluster, è necessario creare due record DNS A nel server DNS per l'oggetto --domain specificato:
- api, che punta all'indirizzo IP del server API
- *.apps - che punta all'indirizzo IP in ingresso
- Recuperare questi valori eseguendo il comando seguente dopo la creazione del cluster: az aro show -n -g --query '{api:apiserverProfile.ip, ingress:ingressProfiles[0].ip}'.
La console OpenShift sarà disponibile a un indirizzo URL come https://console-openshift-console.apps.example.com, invece di quello del dominio predefinito https://console-openshift-console.apps.<random>.<location>.aroapp.io.
Per impostazione predefinita, OpenShift usa certificati autofirmati per tutte le route create in domini personalizzati *.apps.example.com. Se si sceglie di usare un DNS personalizzato dopo la connessione al cluster, è necessario attenersi alla documentazione di OpenShift per configurare un'autorità di certificazione personalizzata per il controller del traffico in ingresso e un'autorità di certificazione personalizzata per il server API.

Creare una rete virtuale contenente due subnet vuote

Si creerà quindi una rete virtuale contenente due subnet vuote. Se si dispone di una rete virtuale esistente che soddisfa le proprie esigenze, è possibile ignorare questo passaggio.

Impostare le variabili seguenti nell'ambiente della shell in cui si eseguiranno i comandi az.

LOCATION=eastus                 # the location of your cluster
RESOURCEGROUP=aro-rg            # the name of the resource group where you want to create your cluster
CLUSTER=cluster                 # the name of your cluster

Creare un gruppo di risorse.

Un gruppo di risorse di Azure è un gruppo logico in cui le risorse di Azure vengono distribuite e gestite. Quando si crea un gruppo di risorse, viene chiesto di specificare una posizione. È la località in cui vengono archiviati i metadati del gruppo di risorse e anche quella in cui vengono eseguite le risorse in Azure se non si specifica un'altra area durante la creazione della risorsa. Creare un gruppo di risorse con il comando az group create.

Nota

Azure Red Hat OpenShift non è disponibile in tutte le aree in cui è possibile creare un gruppo di risorse di Azure. Per informazioni su dove è supportato Azure Red Hat OpenShift, vedere Available regions (Aree disponibili).
```
az group create \
  --name $RESOURCEGROUP \
  --location $LOCATION
```
L'output di esempio seguente mostra il gruppo di risorse creato correttamente:
```
{
  "id": "/subscriptions/<guid>/resourceGroups/aro-rg",
  "location": "eastus",
  "name": "aro-rg",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "type": "Microsoft.Resources/resourceGroups"
}
```

Creare una rete virtuale.

I cluster di Azure Red Hat OpenShift che eseguono OpenShift 4 richiedono una rete virtuale con due subnet vuote, per i nodi master e di lavoro. È possibile creare una nuova rete virtuale o usare una rete virtuale esistente.

Creare una nuova rete virtuale nello stesso gruppo di risorse creato in precedenza:

az network vnet create \
   --resource-group $RESOURCEGROUP \
   --name aro-vnet \
   --address-prefixes 10.0.0.0/22

L'output di esempio seguente mostra la rete virtuale creata correttamente:

{
  "newVNet": {
    "addressSpace": {
      "addressPrefixes": [
        "10.0.0.0/22"
      ]
    },
    "dhcpOptions": {
      "dnsServers": []
    },
    "id": "/subscriptions/<guid>/resourceGroups/aro-rg/providers/Microsoft.Network/virtualNetworks/aro-vnet",
    "location": "eastus",
    "name": "aro-vnet",
    "provisioningState": "Succeeded",
    "resourceGroup": "aro-rg",
    "type": "Microsoft.Network/virtualNetworks"
  }
}

Aggiungere una subnet vuota per i nodi master.

az network vnet subnet create \
  --resource-group $RESOURCEGROUP \
  --vnet-name aro-vnet \
  --name master-subnet \
  --address-prefixes 10.0.0.0/23

Aggiungere una subnet vuota per i nodi di lavoro.

az network vnet subnet create \
  --resource-group $RESOURCEGROUP \
  --vnet-name aro-vnet \
  --name worker-subnet \
  --address-prefixes 10.0.2.0/23

Creare il cluster

Eseguire il comando seguente per creare un cluster. Se si sceglie di usare una delle opzioni seguenti, modificare il comando di conseguenza:

Facoltativamente, è possibile passare il segreto pull di Red Hat, che consente al cluster di accedere ai registri contenitori Red Hat insieme ad altri contenuti. Aggiungere l'argomento --pull-secret @pull-secret.txt al comando.
Se si vuole, è possibile usare un dominio personalizzato. Aggiungere l'argomento --domain foo.example.com al comando, sostituendo foo.example.com con il dominio personalizzato.

Nota

Se si aggiungono argomenti facoltativi al comando, chiudere l'argomento nella riga precedente del comando con una barra rovesciata finale.

az aro create \
  --resource-group $RESOURCEGROUP \
  --name $CLUSTER \
  --vnet aro-vnet \
  --master-subnet master-subnet \
  --worker-subnet worker-subnet

Dopo l'esecuzione di az aro create, la creazione di un cluster richiede in genere circa 35 minuti.

Selezione di una versione ARO diversa

È possibile scegliere di usare una versione specifica di ARO durante la creazione del cluster. Usare prima di tutto l'interfaccia della riga di comando per eseguire una query per le versioni ARO disponibili:

az aro get-versions --location <region>

Dopo aver scelto la versione, specificarla usando il --version parametro nel az aro create comando :

az aro create \
  --resource-group $RESOURCEGROUP \
  --name $CLUSTER \
  --vnet aro-vnet \
  --master-subnet master-subnet \
  --worker-subnet worker-subnet \
  --version <x.y.z>

Passaggi successivi

In questa parte dell'esercitazione si è appreso come:

Configurare i prerequisiti e creare la rete virtuale e le subnet necessarie
Distribuire un cluster

Passare all'esercitazione successiva:

Connettersi a un cluster di Azure Red Hat OpenShift

Esercitazione: Creare un cluster Azure Red Hat OpenShift 4

Operazioni preliminari

Verificare le autorizzazioni

Registrare i provider di risorse

Ottenere un segreto pull di Red Hat (facoltativo)

Preparare un dominio personalizzato per il cluster (facoltativo)

Creare una rete virtuale contenente due subnet vuote

Creare il cluster

Selezione di una versione ARO diversa

Passaggi successivi

Risorse aggiuntive