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')

      Copy to Clipboard Toggle word wrap

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

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

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

      Copy to Clipboard Toggle word wrap

   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\""

      Copy to Clipboard Toggle word wrap

   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\""

      Copy to Clipboard Toggle word wrap

   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\""

      Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

手順

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"

   Copy to Clipboard Toggle word wrap

   1

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

   2

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

2. ConfigMap を適用します。

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

   Copy to Clipboard Toggle word wrap

手順

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

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

   Copy to Clipboard Toggle word wrap

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 }

   Copy to Clipboard Toggle word wrap

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

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

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

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

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

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

      Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

手順

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

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

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

      Copy to Clipboard Toggle word wrap

      この値は 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\""

      Copy to Clipboard Toggle word wrap

   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\""

      Copy to Clipboard Toggle word wrap

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"

   Copy to Clipboard Toggle word wrap

   1

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

   2

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

   3

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

   4

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

3. ConfigMap を適用します。

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

   Copy to Clipboard Toggle word wrap

手順

1. SSH 鍵を生成します。

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

手順

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

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

      $ export LIBVIRT_POOL=<name_of_libvirt_pool_to_create>

      Copy to Clipboard Toggle word wrap

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

      $ export LIBVIRT_VOL_NAME=<name_of_libvirt_volume_to_create>

      Copy to Clipboard Toggle word wrap

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

      $ export LIBVIRT_POOL_DIRECTORY=<name_of_target_directory> 

      1

      Copy to Clipboard Toggle word wrap

      1

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

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

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

   Copy to Clipboard Toggle word wrap

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

   $ virsh pool-start $LIBVIRT_POOL

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

手順

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)

      Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap

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

      Copy to Clipboard Toggle word wrap

      1

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

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

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

      Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap

手順

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

   Copy to Clipboard Toggle word wrap

   1

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

   2

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

   3

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

   4

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

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

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

   Copy to Clipboard Toggle word wrap

手順

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"

   Copy to Clipboard Toggle word wrap

2. ConfigMap を適用します。

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

   Copy to Clipboard Toggle word wrap

手順

1. SSH 鍵を生成します。

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

   Copy to Clipboard Toggle word wrap

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

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

   1

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

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

   $ shred –remove id_rsa.pub id_rsa

   Copy to Clipboard Toggle word wrap