適用対象: ✔️ ホストされたコントロール プレーンのアーキテクチャ
このクイック スタートでは、一時的な管理資格情報を要求して、ホストされたコントロール プレーン (HCP) クラスターを使用してAzure Red Hat OpenShiftに接続します。
資格情報によって、クラスターにアクセスするために OpenShift CLI (oc) で使用するkubeconfig ファイルが生成されます。
Prerequisites
- Azure CLI バージョン 2.93.0 以降 バージョンを見つけるには、
az --versionを実行します。 インストールまたはアップグレードが必要な場合は、Azure CLI のインストールを参照してください。 - ホストされたコントロール プレーンクラスターを使用してデプロイされたAzure Red Hat OpenShift。 ない場合は、「ホストされたコントロール プレーン クラスターを使用してAzure Red Hat OpenShiftを作成する」を参照してください。
- OpenShift CLI (
oc)。 インストールするには、 OpenShift CLI のドキュメントを参照してください。
Important
クラスターにプライベート API サーバーがある場合は、クラスターの仮想ネットワークへのプライベート ネットワーク接続を持つホストから、この記事のすべてのコマンドを実行する必要があります。 AZURE VNet ピアリング、Azure VPN Gateway、またはAzure ExpressRouteを使用して接続を確立できます。 接続をすばやくテストするには、 ジャンプ ボックス VM からの接続に関するページを参照してください。
ジャンプ ボックス VM を作成する (プライベート クラスターのみ)
クラスターにプライベート API サーバーがあり、既存のプライベート ネットワーク接続がない場合は、専用サブネットに独自の NSG を使用してジャンプ ボックス仮想マシンを作成できます。 クラスターの初期セットアップ、テスト、または 1 回限りの管理タスクには、ジャンプ ボックス VM を使用します。 オンプレミス ネットワークまたは CI/CD パイプラインからの継続的な運用アクセスには、代わりにAzure VPN GatewayまたはAzure ExpressRouteを使用します。
環境を準備する
環境変数を設定します。 プレースホルダーの値をあなた自身の値に置き換えてください。
LOCATION="<location>" CUSTOMER_RG_NAME="<resource-group-name>" JUMPBOX_SUBNET_NAME="<subnet-name>" JUMPBOX_NSG_NAME="<nsg-name>" JUMPBOX_NAME="<jumpbox-vm-name>"ジャンプ ボックス VM 用の専用 NSG を作成します。
az network nsg create \ --name "${JUMPBOX_NSG_NAME}" \ --resource-group "${CUSTOMER_RG_NAME}" \ --location "${LOCATION}"目的の IP または CIDR 範囲に制限された受信 SSH 規則を追加します。
az network nsg rule create \ --resource-group "${CUSTOMER_RG_NAME}" \ --nsg-name "${JUMPBOX_NSG_NAME}" \ --name "AllowSSH" \ --priority 1000 \ --protocol Tcp \ --destination-port-ranges 22 \ --source-address-prefixes "<source-ip-address>" \ --access Allow \ --direction Inbound<source-ip-address>を目的のソースに置き換えます。専用のジャンプ ボックス VM サブネットを作成します。
az network vnet subnet create \ --name "${JUMPBOX_SUBNET_NAME}" \ --vnet-name "${CUSTOMER_VNET_NAME}" \ --resource-group "${CUSTOMER_RG_NAME}" \ --address-prefixes 10.0.2.0/28 \ --network-security-group "${JUMPBOX_NSG_NAME}"
ジャンプ ボックス VM を作成する
ジャンプ ボックス VM を作成します。
az vm create \ --resource-group "${CUSTOMER_RG_NAME}" \ --name "${JUMPBOX_NAME}" \ --image Ubuntu2204 \ --admin-username azureuser \ --vnet-name "${CUSTOMER_VNET_NAME}" \ --subnet "${JUMPBOX_SUBNET_NAME}" \ --size Standard_B2s \ --generate-ssh-keysジャンプ ボックス VM のパブリック IP アドレスを取得します。
JUMPBOX_IP=$(az vm show \ --resource-group "${CUSTOMER_RG_NAME}" \ --name "${JUMPBOX_NAME}" \ --show-details \ --query publicIps \ --output tsv) echo "Jump box VM IP: ${JUMPBOX_IP}"SSH 経由でジャンプ ボックス VM に接続します。
ssh azureuser@"${JUMPBOX_IP}"
ジャンプ ボックス VM 環境を設定する
プライベート クラスターの API サーバーにはパブリック エンドポイントがないため、仮想ネットワーク内から oc コマンドを実行する必要があります。
ジャンプ ボックス VM にAzure CLIをダウンロードしてインストールします。
この例では、Ubuntu のAzure CLIをダウンロードしてインストールします。 別のオペレーティング システムでジャンプ ボックスを作成した場合は、OS のAzure CLI Azure CLIインストール手順に従います。
curl -fsSL 'https://azurecliprod.blob.core.windows.net/$root/deb_install.sh' | sudo bashAzure CLIがインストールされていることを確認します。
az versionAzure にサインインします。
az loginこのコマンドは、デバイス コードと URL を返します。
ローカル コンピューターのブラウザーで URL を開き、コードを入力して認証します。
OpenShift CLI をインストールします。
curl -sL https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/openshift-client-linux.tar.gz \ | sudo tar -C /usr/local/bin -xz oc kubectlOpenShift CLI がインストールされていることを確認します。
oc version --client
クラスターに接続する
管理者の資格情報は、24 時間後に期限切れになります。
まだ設定していない場合は、次の環境変数を設定します。 プレースホルダーの値をクラスターの値に置き換えます。
CUSTOMER_RG_NAME="<resource-group-name>" CLUSTER_NAME="<cluster-name>"クラスターの一時的な管理資格情報を要求し、
kubeconfigをファイルに保存します。az aro hcp cluster request-credential --admin \ --name "${CLUSTER_NAME}" \ --resource-group "${CUSTOMER_RG_NAME}" \ --file kubeconfigKUBECONFIG環境変数を、保存したkubeconfigファイルのパスに設定します。export KUBECONFIG=kubeconfigクラスターに接続できることを確認します。
oc auth whoami次の出力例は、正常な接続を示しています。
ATTRIBUTE VALUE Username system:customer-break-glass:<user-id> Groups [system:masters system:authenticated] Extra: authentication.kubernetes.io/credential-id <credential-id>
クリーンアップ
管理者の資格情報を無効にする
クラスターのすべての管理者資格情報を取り消す場合は、次のコマンドを実行します。
az aro hcp cluster revoke-credential \
--name "${CLUSTER_NAME}" \
--resource-group "${CUSTOMER_RG_NAME}"
ジャンプ ボックス VM を削除する
プライベート クラスターに接続するジャンプ ボックス VM を作成した場合は、継続的な料金が発生しないように VM を削除します。
az vm delete \
--resource-group "${CUSTOMER_RG_NAME}" \
--name "${JUMPBOX_NAME}" \
--yes