ホストされたコントロール プレーン クラスターを使用してAzure Red Hat OpenShiftに接続する

適用対象: ✔️ ホストされたコントロール プレーンのアーキテクチャ

このクイック スタートでは、一時的な管理資格情報を要求して、ホストされたコントロール プレーン (HCP) クラスターを使用してAzure Red Hat OpenShiftに接続します。 資格情報によって、クラスターにアクセスするために OpenShift CLI (oc) で使用するkubeconfig ファイルが生成されます。

Prerequisites

Important

クラスターにプライベート API サーバーがある場合は、クラスターの仮想ネットワークへのプライベート ネットワーク接続を持つホストから、この記事のすべてのコマンドを実行する必要があります。 AZURE VNet ピアリング、Azure VPN Gateway、またはAzure ExpressRouteを使用して接続を確立できます。 接続をすばやくテストするには、 ジャンプ ボックス VM からの接続に関するページを参照してください。

ジャンプ ボックス VM を作成する (プライベート クラスターのみ)

クラスターにプライベート API サーバーがあり、既存のプライベート ネットワーク接続がない場合は、専用サブネットに独自の NSG を使用してジャンプ ボックス仮想マシンを作成できます。 クラスターの初期セットアップ、テスト、または 1 回限りの管理タスクには、ジャンプ ボックス VM を使用します。 オンプレミス ネットワークまたは CI/CD パイプラインからの継続的な運用アクセスには、代わりにAzure VPN GatewayまたはAzure ExpressRouteを使用します。

環境を準備する

  1. 環境変数を設定します。 プレースホルダーの値をあなた自身の値に置き換えてください。

    LOCATION="<location>"
    CUSTOMER_RG_NAME="<resource-group-name>"
    JUMPBOX_SUBNET_NAME="<subnet-name>"
    JUMPBOX_NSG_NAME="<nsg-name>"
    JUMPBOX_NAME="<jumpbox-vm-name>"
    
  2. ジャンプ ボックス VM 用の専用 NSG を作成します。

    az network nsg create \
     --name "${JUMPBOX_NSG_NAME}" \
     --resource-group "${CUSTOMER_RG_NAME}" \
     --location "${LOCATION}"
    
  3. 目的の 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>を目的のソースに置き換えます。

  4. 専用のジャンプ ボックス 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 を作成する

  1. ジャンプ ボックス 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
    
  2. ジャンプ ボックス 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}"
    
  3. SSH 経由でジャンプ ボックス VM に接続します。

    ssh azureuser@"${JUMPBOX_IP}"
    

ジャンプ ボックス VM 環境を設定する

プライベート クラスターの API サーバーにはパブリック エンドポイントがないため、仮想ネットワーク内から oc コマンドを実行する必要があります。

  1. ジャンプ ボックス VM にAzure CLIをダウンロードしてインストールします。

    この例では、Ubuntu のAzure CLIをダウンロードしてインストールします。 別のオペレーティング システムでジャンプ ボックスを作成した場合は、OS のAzure CLI Azure CLIインストール手順に従います。

    curl -fsSL 'https://azurecliprod.blob.core.windows.net/$root/deb_install.sh' | sudo bash
    
  2. Azure CLIがインストールされていることを確認します。

    az version
    
  3. Azure にサインインします。

    az login
    

    このコマンドは、デバイス コードと URL を返します。

  4. ローカル コンピューターのブラウザーで URL を開き、コードを入力して認証します。

  5. 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 kubectl
    
  6. OpenShift CLI がインストールされていることを確認します。

    oc version --client
    

クラスターに接続する

管理者の資格情報は、24 時間後に期限切れになります。

  1. まだ設定していない場合は、次の環境変数を設定します。 プレースホルダーの値をクラスターの値に置き換えます。

    CUSTOMER_RG_NAME="<resource-group-name>"
    CLUSTER_NAME="<cluster-name>"
    
  2. クラスターの一時的な管理資格情報を要求し、 kubeconfig をファイルに保存します。

    az aro hcp cluster request-credential --admin \
     --name "${CLUSTER_NAME}" \
     --resource-group "${CUSTOMER_RG_NAME}" \
     --file kubeconfig
    
  3. KUBECONFIG環境変数を、保存したkubeconfig ファイルのパスに設定します。

    export KUBECONFIG=kubeconfig
    
  4. クラスターに接続できることを確認します。

    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

次のステップ