3.3. CLI でピア Pod を使用した OpenShift Sandboxed Containers ワークロードのデプロイ

手順

1. シークレットオブジェクトに必要なパラメーター値を収集します。それぞれの値を必ず書き留めてください。

   1. インスタンス ID を取得します。

      $ INSTANCE_ID=$(oc get nodes -l 'node-role.kubernetes.io/worker' -o jsonpath='{.items[0].spec.providerID}' | sed 's#[^ ]*/##g')

      この値はシークレットオブジェクト自体には必要ありませんが、シークレットオブジェクトの他の値を取得するために使用されます。

   2. AWS リージョンを取得します。

      $ AWS_REGION=$(oc get infrastructure/cluster -o jsonpath='{.status.platformStatus.aws.region}') && echo "AWS_REGION: \"$AWS_REGION\""

   3. AWS サブネット ID を取得します。

      $ AWS_SUBNET_ID=$(aws ec2 describe-instances --instance-ids ${INSTANCE_ID} --query 'Reservations[*].Instances[*].SubnetId' --region ${AWS_REGION} --output text) && echo "AWS_SUBNET_ID: \"$AWS_SUBNET_ID\""

   4. AWS VPC ID を取得します。

      $ AWS_VPC_ID=$(aws ec2 describe-instances --instance-ids ${INSTANCE_ID} --query 'Reservations[*].Instances[*].VpcId' --region ${AWS_REGION} --output text) && echo "AWS_VPC_ID: \"$AWS_VPC_ID\""

   5. AWS セキュリティーグループ ID を取得します。

      $ AWS_SG_IDS=$(aws ec2 describe-instances --instance-ids ${INSTANCE_ID} --query 'Reservations[*].Instances[*].SecurityGroups[*].GroupId' --region $AWS_REGION --output json | jq -r '.[][][]' | paste -sd ",") && echo "AWS_SG_IDS: \"$AWS_SG_IDS\""

2. 次のマニフェストで YAML ファイルを作成します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: peer-pods-secret
     namespace: openshift-sandboxed-containers-operator
   type: Opaque
   stringData:
     AWS_ACCESS_KEY_ID: "<enter value>" 1
     AWS_SECRET_ACCESS_KEY: "<enter value>" 2
     AWS_REGION: "<enter value>" 3
     AWS_SUBNET_ID: "<enter value>" 4
     AWS_VPC_ID: "<enter value>" 5
     AWS_SG_IDS: "<enter value>" 6

   1

   開始する前に準備した AWS_ACCESS_KEY_ID 値を入力します。

   2

   開始する前に準備した AWS_SECRET_ACCESS_KEY 値を入力します。

   3

   取得した AWS_REGION 値を入力します。

   4

   取得した AWS_SUBNET_ID 値を入力します。

   5

   取得した AWS_VPC_ID 値を入力します。

   6

   取得した AWS_SG_IDS 値を入力します。

3. シークレットオブジェクトを適用します。

   $ oc apply -f peer-pods-secret.yaml

手順

1. 次のマニフェストで YAML ファイルを作成します。

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: peer-pods-cm
     namespace: openshift-sandboxed-containers-operator
   data:
     CLOUD_PROVIDER: "aws"
     VXLAN_PORT: "9000"
     PODVM_INSTANCE_TYPE: "t3.medium" 1
     PODVM_INSTANCE_TYPES: "t2.small,t2.medium,t3.large" 2
     PROXY_TIMEOUT: "5m"

   1

   ワークロードでタイプが定義されていない場合に使用されるデフォルトのインスタンスタイプを定義します。

   2

   Pod の作成時に指定できるすべてのインスタンスタイプを一覧表示します。これにより、必要なメモリーと CPU が少ないワークロードには小さなインスタンスを定義したり、より大きなワークロードには大きなインスタンスを定義したりできます。

2. ConfigMap を適用します。

   $ oc apply -f peer-pods-cm.yaml

手順

1. Azure サブスクリプション ID を取得します。

   $ AZURE_SUBSCRIPTION_ID=$(az account list --query "[?isDefault].id" -o tsv) && echo "AZURE_SUBSCRIPTION_ID: \"$AZURE_SUBSCRIPTION_ID\""

2. RBAC コンテンツを生成します。これにより、クライアント ID、クライアントシークレット、およびテナント ID が生成されます。

   $ az ad sp create-for-rbac --role Contributor --scopes /subscriptions/$AZURE_SUBSCRIPTION_ID --query "{ client_id: appId, client_secret: password, tenant_id: tenant }

   以下の出力が表示されます。

   {
     "client_id": `AZURE_CLIENT_ID`,
     "client_secret": `AZURE_CLIENT_SECRET`,
     "tenant_id": `AZURE_TENANT_ID`
   }

3. シークレットオブジェクトで使用するために、RBAC 出力の値を保存します。

4. シークレットオブジェクトの追加のパラメーター値を収集します。それぞれの値を必ず書き留めてください。

   1. リソースグループを取得します。

      $ AZURE_RESOURCE_GROUP=$(oc get infrastructure/cluster -o jsonpath='{.status.platformStatus.azure.resourceGroupName}') && echo "AZURE_RESOURCE_GROUP: \"$AZURE_RESOURCE_GROUP\""

   2. Azure リージョンを取得します。

      $ AZURE_REGION=$(az group show --resource-group ${AZURE_RESOURCE_GROUP} --query "{Location:location}" --output tsv) && echo "AZURE_REGION: \"$AZURE_REGION\""

5. 次のマニフェストで YAML ファイルを作成します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: peer-pods-secret
     namespace: openshift-sandboxed-containers-operator
   type: Opaque
   stringData:
     AZURE_CLIENT_ID: "<enter value>" 1
     AZURE_CLIENT_SECRET: "<enter value>" 2
     AZURE_TENANT_ID: "<enter value>" 3
     AZURE_SUBSCRIPTION_ID: "<enter value>" 4
     AZURE_REGION: "<enter value>" 5
     AZURE_RESOURCE_GROUP: "<enter value>" 6

   1

   RBAC ファイルで生成した AZURE_CLIENT_ID 値を入力します。

   2

   RBAC ファイルで生成した AZURE_CLIENT_SECRET 値を入力します。

   3

   RBAC ファイルで生成した AZURE_TENANT_ID 値を入力します。

   4

   取得した AZURE_SUBSCRIPTION_ID 値を入力します。

   5

   取得した AZURE_REGION 値を入力します。

   6

   取得した AZURE_RESOURCE_GROUP 値を入力します。

6. シークレットオブジェクトを適用します。

   $ oc apply -f peer-pods-secret.yaml

手順

1. Azure ピア Pod ConfigMap の設定値を収集します。それぞれの値を必ず書き留めてください。

   1. Azure VNet 名を取得します。

      $ AZURE_VNET_NAME=$(az network vnet list --resource-group ${AZURE_RESOURCE_GROUP} --query "[].{Name:name}" --output tsv)

      この値は ConfigMap には必要ありませんが、Azure サブネット ID を取得するために使用されます。

   2. Azure サブネット ID を取得します。

      $ AZURE_SUBNET_ID=$(az network vnet subnet list --resource-group ${AZURE_RESOURCE_GROUP} --vnet-name $AZURE_VNET_NAME --query "[].{Id:id} | [? contains(Id, 'worker')]" --output tsv) && echo "AZURE_SUBNET_ID: \"$AZURE_SUBNET_ID\""

   3. Azure ネットワークセキュリティーグループ (NSG) ID を取得します。

      $ AZURE_NSG_ID=$(az network nsg list --resource-group ${AZURE_RESOURCE_GROUP} --query "[].{Id:id}" --output tsv) && echo "AZURE_NSG_ID: \"$AZURE_NSG_ID\""

2. 次のマニフェストで YAML ファイルを作成します。

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: peer-pods-cm
     namespace: openshift-sandboxed-containers-operator
   data:
     CLOUD_PROVIDER: "azure"
     VXLAN_PORT: "9000"
     AZURE_INSTANCE_SIZE: "Standard_B2als_v2" 1
     AZURE_INSTANCE_SIZES: "Standard_B2als_v2,Standard_D2as_v5,Standard_D4as_v5,Standard_D2ads_v5" 2
     AZURE_SUBNET_ID: "<enter value>" 3
     AZURE_NSG_ID: "<enter value>" 4
     PROXY_TIMEOUT: "5m"
     DISABLECVM: "true"

   1

   インスタンスがワークロードに定義されていない場合に使用されるデフォルトのインスタンスサイズを定義します。

   2

   Pod の作成時に指定できるすべてのインスタンスサイズを一覧表示します。これにより、必要なメモリーと CPU が少ないワークロードには小さなインスタンスを定義したり、より大きなワークロードには大きなインスタンスを定義したりできます。

   3

   取得した AZURE_SUBNET_ID 値を入力します。

   4

   取得した AZURE_NSG_ID 値を入力します。

3. ConfigMap を適用します。

   $ oc apply -f peer-pods-cm.yaml

手順

1. SSH 鍵を生成します。

   $ ssh-keygen -f ./id_rsa -N ""

2. SSH シークレットオブジェクトを作成します。

   $ oc create secret generic ssh-key-secret -n openshift-sandboxed-containers-operator --from-file=id_rsa.pub=./id_rsa.pub --from-file=id_rsa=./id_rsa

手順

1. IBM Z KVM ホストにログインし、libvirt がストレージ管理に使用するシェル変数を設定します。

   1. 次のコマンドを実行して、libvirt プールの名前を設定します。

      $ export LIBVIRT_POOL=<name_of_libvirt_pool_to_create>

   2. 次のコマンドを実行して、libvirt プールの名前を設定します。

      $ export LIBVIRT_VOL_NAME=<name_of_libvirt_volume_to_create>

   3. 次のコマンドを実行して、デフォルトのストレージプールの場所のパスを設定します。

      $ export LIBVIRT_POOL_DIRECTORY=<name_of_target_directory> 1

      1

      libvirt に読み取りおよび書き込みアクセス許可があることを確認するには、libvirt のストレージディレクトリーのサブディレクトリーを使用します。デフォルトは /var/lib/libvirt/images/ です。

2. 次のコマンドを実行して、libvirt プールを作成します。

   $ virsh pool-define-as $LIBVIRT_POOL --type dir --target "$LIBVIRT_POOL_DIRECTORY"

3. 次のコマンドを実行して、libvirt プールを開始します。

   $ virsh pool-start $LIBVIRT_POOL

4. 次のコマンドを実行して、プールの libvirt ボリュームを作成します。

   $ virsh -c qemu:///system \
     vol-create-as --pool $LIBVIRT_POOL \
     --name $LIBVIRT_VOL_NAME \
     --capacity 20G \
     --allocation 2G \
     --prealloc-metadata \
     --format qcow2

手順

1. システムの RHEL ORG_ID および ACTIVATION_KEY シェル変数を設定します。

   1. サブスクライブされた RHEL システムを使用する場合は、次のコマンドを実行して、組織 ID と Red Hat Subscription Management (RHSM) のアクティベーションキーを保持するファイルにシェル環境変数を設定します。

      $ export ORG_ID=$(cat ~/.rh_subscription/orgid)
      
      $ export ACTIVATION_KEY=$(cat ~/.rh_subscription/activation_key)

   2. サブスクライブされていない RHEL システムを使用する場合は、次のコマンドを実行して適切なサブスクリプション値を設定します。

      $ export ORG_ID=<RHEL_ORGID_VALUE>
      
      $ export ACTIVATION_KEY=<RHEL_ACVTIVATION_KEY>

2. IBM Z システムにログインし、以下の手順を実行します。

   1. s390x RHEL KVM ゲストイメージを Red Hat カスタマーポータル から libvirt ストレージディレクトリーにダウンロードして、libvirt に正しいアクセスを許可します。デフォルトのディレクトリーは /var/lib/libvirt/images です。このイメージは、関連するバイナリーを含むピア Pod VM イメージを生成するために使用されます。

   2. 次のコマンドを実行して、ダウンロードしたイメージの IMAGE_URL シェル環境変数を設定します。

      $ export IMAGE_URL=<location_of_downloaded_KVM_guest_image> 1

      1

      前の手順でダウンロードした KVM ゲストイメージのパスを入力します。

   3. 次のコマンドを実行して、ゲスト KVM イメージを登録します。

      $ export REGISTER_CMD="subscription-manager register --org=${ORG_ID} \
        --activationkey=${ACTIVATION_KEY}"

   4. 次のコマンドを実行して、ゲスト KVM イメージをカスタマイズします。

      $ virt-customize -v -x -a ${IMAGE_URL} --run-command "${REGISTER_CMD}"

   5. 次のコマンドを実行して、イメージのチェックサムを設定します。

      $ export IMAGE_CHECKSUM=$(sha256sum ${IMAGE_URL} | awk '{ print $1 }')

手順

1. 次のマニフェストを使用して YAML ファイル peer-pods-secret.yaml を作成します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: peer-pods-secret
     namespace: openshift-sandboxed-containers-operator
   type: Opaque
   stringData:
     CLOUD_PROVIDER: "libvirt" 1
     LIBVIRT_URI: "<libvirt_gateway_uri>" 2
     LIBVIRT_POOL: "<libvirt_pool>" 3
     LIBVIRT_VOL_NAME: "<libvirt_volume>" 4

   1

   クラウドプロバイダーとして libvirt を入力します。

   2

   取得した libvirt_gateway_uri 値を入力します。

   3

   取得した libvirt_pool 値を入力します。

   4

   取得した libvirt_volume 値を入力します。

2. シークレットオブジェクトを作成します。

   $ oc apply -f peer-pods-secret.yaml

手順

1. 次のマニフェストを使用して YAML ファイル peer-pods-cm.yaml を作成します。

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: peer-pods-cm
     namespace: openshift-sandboxed-containers-operator
   data:
     CLOUD_PROVIDER: "libvirt"
     PROXY_TIMEOUT: "15m"

2. ConfigMap を適用します。

   $ oc apply -f peer-pods-cm.yaml

手順

1. SSH 鍵を生成します。

   $ ssh-keygen -f ./id_rsa -N ""

2. SSH 公開キーを KVM ホストにコピーします。

   $ ssh-copy-id -i ./id_rsa.pub <KVM_HOST_ADDRESS> 1

   1

   KVM ホストの IP アドレスを入力します。

3. シークレットオブジェクトを作成します。

   $ oc create secret generic ssh-key-secret \
       -n openshift-sandboxed-containers-operator \
       --from-file=id_rsa.pub=./id_rsa.pub \
       --from-file=id_rsa=./id_rsa

4. SSH キーを削除します。

   $ shred –remove id_rsa.pub id_rsa