チュートリアル:Azure Red Hat OpenShift 4 クラスターを作成する

[アーティクル]
03/25/2023

このチュートリアルは、3 部構成のパート 1 です。OpenShift 4 が実行される Azure Red Hat OpenShift クラスターを作成する環境を準備し、クラスターを作成します。学習内容は次のとおりです。

前提条件を設定する
必要な仮想ネットワークとサブネットを作成する
クラスターのデプロイ

開始する前に

CLI をローカルにインストールして使用する場合、このチュートリアルでは、Azure CLI バージョン 2.30.0 以降を実行している必要があります。バージョンを確認するには、az --version を実行します。インストールまたはアップグレードする必要がある場合は、Azure CLI のインストールに関するページを参照してください。

OpenShift クラスターを作成して実行するには、Azure Red Hat OpenShift に少なくとも 40 コアが必要です。新しい Azure サブスクリプションの既定の Azure リソースクォータは、この要件を満たしていません。リソースの制限の引き上げを依頼するには、「標準クォータ:VM シリーズでの制限の引き上げ」を参照してください。

たとえば、サポートされる仮想マシンファミリの最小 SKU "Standard DSv3" の現在のサブスクリプションクォータを確認するには、次のコマンドを実行します。
```
LOCATION=eastus
az vm list-usage -l $LOCATION \
--query "[?contains(name.value, 'standardDSv3Family')]" \
-o table
```

アクセス許可を確認する

このチュートリアルでは、クラスターの仮想ネットワークを含むリソースグループを作成します。これを行うために、共同作成者とユーザーアクセス管理者のアクセス許可、または仮想ネットワークに対する直接の所有者アクセス許可、またはそれを含むリソースグループまたはサブスクリプションに対する所有者アクセス許可が必要です。

また、クラスターのアプリケーションとサービスプリンシパルを作成するために、ツールに対する十分な Azure Active Directory アクセス許可 (テナントのメンバーユーザー、またはアプリケーション管理者ロールが割り当てられたゲスト) も必要になります。詳細については、メンバーとゲストおよびAzure Active Directory を使ったユーザーに対する管理者と管理者以外のロールの割り当てに関するページを参照してください。

リソースプロバイダーを登録する

複数の Azure サブスクリプションがある場合は、適切なサブスクリプション ID を指定します。
```
az account set --subscription <SUBSCRIPTION ID>
```
Microsoft.RedHatOpenShift リソースプロバイダーを登録します。
```
az provider register -n Microsoft.RedHatOpenShift --wait
```
Microsoft.Compute リソースプロバイダーを登録します。
```
az provider register -n Microsoft.Compute --wait
```
Microsoft.Storage リソースプロバイダーを登録します。
```
az provider register -n Microsoft.Storage --wait
```
Microsoft.Authorization リソースプロバイダーを登録します。
```
az provider register -n Microsoft.Authorization --wait
```

Red Hat プルシークレットを取得する (省略可能)

Note

ARO プルシークレットを使用することで、ARO の RH OpenShift ライセンスのコストが変わることはありません。

Red Hat プルシークレットを使用すると、クラスターは他のコンテンツと共に Red Hat コンテナーレジストリにアクセスできます。この手順は省略可能ですが、実施することをお勧めします。 pull-secret に cloud.openshift.com フィールドが含まれている場合でも、このフィールドはシークレットから削除されます。このフィールドにより、RedHat にデータを送信する追加の監視機能が有効になるので、既定では無効になっています。この機能を有効にするには、https://docs.openshift.com/container-platform/4.11/support/remote_health_monitoring/enabling-remote-health-reporting.html を参照してください。

Red Hat OpenShift クラスターマネージャーポータルに移動し、サインインします。

Red Hat アカウントにログインするか、お使いのビジネスメールアドレスを使用して新しい Red Hat アカウントを作成し、使用条件に同意する必要があります。
[Download pull secret] (プルシークレットのダウンロード) を選択し、ARO クラスターで使用するプルシークレットをダウンロードします。

保存済みの pull-secret.txt ファイルは安全な場所に保管してください。 Red Hat または認定パートナーのサンプルやオペレーターを含むクラスターを作成する必要がある場合は、クラスターを作成するたびにこのファイルが使用されます。

az aro create コマンドを実行する場合は、--pull-secret @pull-secret.txt パラメーターを使用してプルシークレットを参照できます。 pull-secret.txt ファイルを格納したディレクトリから az aro create を実行します。それ以外の場合は、@pull-secret.txt を @/path/to/my/pull-secret.txt で置き換えます。

プルシークレットをコピーする場合や他のスクリプトで参照する場合は、プルシークレットを有効な JSON 文字列として書式設定する必要があります。

クラスターのカスタムドメインを準備する (省略可能)

az aro create コマンドを実行するときに、--domain foo.example.com パラメーターを使用してクラスターのカスタムドメインを指定することができます。

注意

Azure CLI を使用してクラスターを作成する場合、ドメイン名の追加は省略可能ですが、ポータル経由でクラスターを追加する場合は、ドメイン名 (OpenShift コンソールと API サーバーの自動生成された DNS 名の一部として使用されるプレフィックス) が必要です。詳細については、「クイックスタート: Azure portal を使用した Azure Red Hat OpenShift クラスターのデプロイ」を参照してください。

クラスターのカスタムドメインを指定する場合は、次の点に注意してください。

クラスターを作成した後、指定した --domain に対して DNS サーバーに次の 2 つの DNS A レコードを作成する必要があります。
- api - API サーバーの IP アドレスを指します
- *.apps - イングレス IP アドレスを指します
- クラスターの作成後に次のコマンドを実行して、これらの値を取得します: az aro show -n -g --query '{api:apiserverProfile.ip, ingress:ingressProfiles[0].ip}'。
OpenShift コンソールは、組み込みのドメイン (https://console-openshift-console.apps.<random>.<location>.aroapp.io) ではなく、https://console-openshift-console.apps.example.com のような URL で使用できるようになります。
OpenShift では、既定で、*.apps.example.com カスタムドメインに作成されたすべてのルートに自己署名証明書が使用されます。クラスターに接続した後でカスタム DNS を使用する場合は、OpenShift のドキュメントに従って、イングレスコントローラー用のカスタム CA と、API サーバー用のカスタム CA を構成する必要があります。

2 つの空のサブネットを含む仮想ネットワークを作成する

次に、2 つの空のサブネットを含む仮想ネットワークを作成します。要件を満たす仮想ネットワークが既にある場合は、この手順を省略できます。

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

リソースグループを作成します。

Azure リソースグループは、Azure リソースが展開され管理される論理グループです。リソースグループを作成する際は、場所を指定するよう求められます。この場所は、リソースグループのメタデータが格納される場所です。また、リソースの作成時に別のリージョンを指定しない場合は、Azure でリソースが実行される場所でもあります。 az group create コマンドを使用して、リソースグループを作成します。

Note

Azure Red Hat OpenShift は、Azure リソースグループを作成できるすべてのリージョンで使用可能なわけではありません。 Azure Red Hat OpenShift がサポートされている場所については、「使用可能なリージョン」を参照してください。
```
az group create \
  --name $RESOURCEGROUP \
  --location $LOCATION
```
次の出力例では、正常に作成されたリソースグループが示されています。
```
{
  "id": "/subscriptions/<guid>/resourceGroups/aro-rg",
  "location": "eastus",
  "name": "aro-rg",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "type": "Microsoft.Resources/resourceGroups"
}
```
仮想ネットワークを作成します。

OpenShift 4 を実行する Azure Red Hat OpenShift クラスターでは、マスターノードとワーカーノード用の 2 つの空のサブネットを持つ仮想ネットワークが必要です。これのために新しい仮想ネットワークを作成することも、既存の仮想ネットワークを使用することもできます。

先ほど作成したのと同じリソースグループ内に新しい仮想ネットワークを作成します。
```
az network vnet create \
   --resource-group $RESOURCEGROUP \
   --name aro-vnet \
   --address-prefixes 10.0.0.0/22
```
次の出力例では、正常に作成された仮想ネットワークが示されています。
```
{
  "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"
  }
}
```

マスターノード用の空のサブネットを追加します。

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

ワーカーノード用の空のサブネットを追加します。

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

クラスターを作成する

次のコマンドを実行して、クラスターを作成します。次のいずれかのオプションを使用する場合は、必要に応じてコマンドを変更してください。

必要に応じて、Red Hat プルシークレットを渡して、クラスターが他のコンテンツと共に Red Hat コンテナーレジストリにアクセスできるよう設定できます。 --pull-secret @pull-secret.txt 引数をコマンドに追加します。
必要に応じて、カスタムドメインを使用することもできます。 --domain foo.example.com 引数をコマンドに追加し、foo.example.com を独自のカスタムドメインで置き換えます。

Note

省略可能な引数をコマンドに追加する場合は、先行するコマンド行の引数の末尾に、円記号を付けて閉じてください。

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

az aro create コマンドを実行した後、クラスターが作成されるまでに通常約 35 分かかります。

ARO の別のバージョンの選択

クラスターの作成時に、特定のバージョンの ARO を使用することを選択できます。まず、CLI を使用して、使用可能な ARO のバージョンを調べます。

az aro get-versions --location <region>

バージョンを選択したら、aro create コマンドに --version パラメーターを使用してそれを指定します。

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

次のステップ

チュートリアルのこの部分で学習した内容は次のとおりです。

前提条件を設定し、必要な仮想ネットワークとサブネットを作成する
クラスターのデプロイ

次のチュートリアルに進みます。

Azure Red Hat OpenShift クラスターに接続する

チュートリアル:Azure Red Hat OpenShift 4 クラスターを作成する

開始する前に

アクセス許可を確認する

リソースプロバイダーを登録する

Red Hat プルシークレットを取得する (省略可能)

クラスターのカスタムドメインを準備する (省略可能)

2 つの空のサブネットを含む仮想ネットワークを作成する

クラスターを作成する

ARO の別のバージョンの選択

次のステップ

その他のリソース

その他のリソース

チュートリアル:Azure Red Hat OpenShift 4 クラスターを作成する

開始する前に

アクセス許可を確認する

リソース プロバイダーを登録する

Red Hat プル シークレットを取得する (省略可能)

クラスターのカスタム ドメインを準備する (省略可能)

2 つの空のサブネットを含む仮想ネットワークを作成する

クラスターを作成する

ARO の別のバージョンの選択

次のステップ

その他のリソース

その他のリソース

リソースプロバイダーを登録する

Red Hat プルシークレットを取得する (省略可能)

クラスターのカスタムドメインを準備する (省略可能)