Azure Red Hat OpenShift 4 クラスターを作成する

[アーティクル]
09/13/2024

Azure Red Hat OpenShift は、クラスターをすばやくデプロイおよび管理できるマネージド OpenShift サービスです。この記事では、Azure CLI または Azure portal を使って Azure Red Hat OpenShift クラスターをデプロイする方法について説明します。

Azure CLI
Azure Portal

開始する前に

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
```

アクセス許可を確認する

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

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

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

複数の 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 プルシークレットを使用すると、クラスターは OperatorHub からのオペレーターハブの他のコンテンツと共に 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

作成時には最大 50 個のワーカーノードを定義できます。クラスターを作成したら、最大 250 個のノードまでスケールアウトできます。

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

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

大規模な ARO クラスター

100 個を超えるワーカーノードを含む Azure Red Hat OpenShift クラスターをデプロイする場合は、「大規模な Azure Red Hat OpenShift クラスターをデプロイする」を参照してください

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

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

az aro get-versions --location <region>

バージョンを選択したら、az 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 portal にサインインします。

Microsoft.RedHatOpenShift リソースプロバイダーを登録します。 Azure portal を使用してリソースプロバイダーを登録する手順については、「リソースプロバイダーの登録」をご覧ください。

Azure Red Hat OpenShift クラスターを作成する

Azure portal メニュー上または [ホーム] ページから、左上のページで 3 つの水平バーの下にある [すべてのサービス] を選択します。
Azure Red Hat OpenShift クラスターを検索して選択します。
［作成］ を選択します
[基本] タブで次のオプションを構成します。
- プロジェクトの詳細:
  - Azure のサブスクリプションを選択します
  - Azure リソースグループを選択または作成します (myResourceGroup など)。
- インスタンスの詳細:
  - Azure Red Hat OpenShift クラスターのリージョンを選択します。
  - OpenShift のクラスター名(myAROCluster など) を入力します。
  - [ドメイン名] を入力します。
  - [マスター VM サイズ] と [ワーカー VM サイズ] を選択します。
  - [ワーカーノード数] (作成するワーカーノードの数) を選択します。
Note

[ドメイン名] フィールドには、ランダムな文字列が事前に設定されています。 OpenShift コンソールと API サーバーに対して自動生成される DNS 名の一部として使用されるドメイン名 (example.com など) や文字列またはプレフィックス (abc など) を指定できます。リソースグループ名が指定されていない場合、このプレフィックスは、クラスター VM をホストするために作成されるリソースグループの名前の一部としても使用されます。
[認証] タブで、次のセクションに入力します。

[サービスプリンシパル情報] で、[新規作成] または [既存] を選択します。既存のサービスプリンシパルを使用する場合は、次の情報を入力します。
- [サービスプリンシパルのクライアント ID] は appId です。
- [サービスプリンシパルのクライアントシークレット] は、暗号化解除された Secret 値です。
注意

サービスプリンシパルを作成する必要がある場合は、Azure Red Hat OpenShift クラスターでのサービスプリンシパルの作成と使用に関する記事を参照してください。

[プルシークレット] で、Red Hat プルシークレット (クラスターのプルシークレットの復号化された値) を入力します。プルシークレットがない場合は、このフィールドを空白のままにします。
[ネットワーク] タブで、必要なオプションを構成します。

Note

OpenShift 4 を実行する Azure Red Hat OpenShift クラスターでは、2 つの空のサブネット (コントロールプレーン用に 1 つとワーカーノード用に 1 つ) を持つ仮想ネットワークが必要です。

[タグ] タブで、リソースを整理するためにタグを追加します。

[確認および作成] を確認し、検証が完了したら、作成します。

Azure portal の [確認と作成] タブのスクリーンショット。

Azure Red Hat OpenShift クラスターの作成には約 35 分から 45 分かかります。デプロイが完了したら、次のいずれかの方法でリソースに移動します。
- [リソースに移動] をクリックします。または
- Azure Red Hat OpenShift クラスターリソースグループを参照し、Azure Red Hat OpenShift リソースを選択します。
  - 下のクラスターダッシュボードの例では、myResourceGroup を参照し、myAROCluster リソースを選択しています。

次のステップ

Azure Red Hat OpenShift クラスターに接続する方法を学習します。

次の方法で共有

Azure Red Hat OpenShift 4 クラスターを作成する

開始する前に

アクセス許可を確認する

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

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

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

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

クラスターを作成する

大規模な ARO クラスター

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

開始する前に

Azure Red Hat OpenShift クラスターを作成する

次のステップ

フィードバック

その他のリソース

次の方法で共有

Azure Red Hat OpenShift 4 クラスターを作成する

開始する前に

アクセス許可を確認する

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

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

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

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

クラスターを作成する

大規模な ARO クラスター

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

フィードバック

その他のリソース

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

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

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