3.13. AWS VPC クラスターの AWS Outpost への拡張

手順

1. 次のコマンドを実行して、クラスターのインフラストラクチャー ID をリスト表示します。この値を保存しておきます。

   $ oc get -o jsonpath='{.status.infrastructureName}{"\n"}' infrastructures.config.openshift.io cluster

2. 次のコマンドを実行して、インストールプログラムが作成したコンピュートマシンセットに関する詳細を取得します。

   1. クラスター上のコンピュートマシンセットをリスト表示します。

      $ oc get machinesets.machine.openshift.io -n openshift-machine-api

      出力例

      NAME                           DESIRED   CURRENT   READY   AVAILABLE   AGE
      <compute_machine_set_name_1>   1         1         1       1           55m
      <compute_machine_set_name_2>   1         1         1       1           55m

   2. リストされたコンピュートマシンセットのいずれかの Amazon Machine Image (AMI) ID を表示します。この値を保存しておきます。

      $ oc get machinesets.machine.openshift.io <compute_machine_set_name_1> \
        -n openshift-machine-api \
        -o jsonpath='{.spec.template.spec.providerSpec.value.ami.id}'

   3. AWS VPC クラスターのサブネット ID を表示します。この値を保存しておきます。

      $ oc get machinesets.machine.openshift.io <compute_machine_set_name_1> \
        -n openshift-machine-api \
        -o jsonpath='{.spec.template.spec.providerSpec.value.subnet.id}'

手順

1. 次のコマンドを実行して、AWS アカウントに接続されている Outpost をリスト表示します。

   $ aws outposts list-outposts

2. aws outposts list-outposts コマンドの出力の次の値を保存しておきます。

   • Outpost ID
   • Outpost の Amazon Resource Name (ARN)

   • Outpost のアベイラビリティーゾーン

     注記

     aws outposts list-outposts コマンドの出力には、アベイラビリティーゾーンに関連する 2 つの値、AvailabilityZone と AvailabilityZoneId が含まれています。Outpost 内にコンピュートマシンを作成するコンピュートマシンセットを設定するには、AvailablilityZone 値を使用します。

3. Outpost ID の値を使用して次のコマンドを実行し、Outpost で利用可能なインスタンスタイプを表示します。利用可能なインスタンスタイプの値を保存しておきます。

   $ aws outposts get-outpost-instance-types \
     --outpost-id <outpost_id_value>

4. Outpost ARN の値を使用して次のコマンドを実行し、Outpost のサブネット ID を表示します。この値を保存しておきます。

   $ aws ec2 describe-subnets \
     --filters Name=outpost-arn,Values=<outpost_arn_value>

手順

1. クラスターネットワークの現在の MTU を取得するには、次のコマンドを入力します。

   $ oc describe network.config cluster

   出力例

   ...
   Status:
     Cluster Network:
       Cidr:               10.217.0.0/22
       Host Prefix:        23
     Cluster Network MTU:  1400
     Network Type:         OVNKubernetes
     Service Network:
       10.217.4.0/23
   ...

2. MTU 移行を開始するには、次のコマンドを入力して移行設定を指定します。Machine Config Operator は、MTU の変更に備えて、クラスター内のノードをローリングリブートします。

   $ oc patch Network.operator.openshift.io cluster --type=merge --patch \
     '{"spec": { "migration": { "mtu": { "network": { "from": <overlay_from>, "to": <overlay_to> } , "machine": { "to" : <machine_to> } } } } }'

   ここでは、以下のようになります。

   <overlay_from>

   現在のクラスターネットワークの MTU 値を指定します。

   <overlay_to>

   クラスターネットワークのターゲット MTU を指定します。この値は、<machine_to> の値を基準にして設定します。OVN-Kubernetes の場合、この値は <machine_to> の値から 100 を引いた値である必要があります。

   <machine_to>

   基盤となるホストネットワークのプライマリーネットワークインターフェイスの MTU を指定します。

   クラスターの MTU を減らす例

   $ oc patch Network.operator.openshift.io cluster --type=merge --patch \
     '{"spec": { "migration": { "mtu": { "network": { "from": 1400, "to": 1000 } , "machine": { "to" : 1100} } } } }'

3. Machine Config Operator (MCO) は、各マシン設定プール内のマシンを更新するときに、各ノードを 1 つずつ再起動します。すべてのノードが更新されるまで待機する必要があります。以下のコマンドを実行してマシン設定プールのステータスを確認します。

   $ oc get machineconfigpools

   正常に更新されたノードには、UPDATED=true、UPDATING=false、DEGRADED=false のステータスがあります。

   注記

   Machine Config Operator は、デフォルトでプールごとに 1 つずつマシンを更新するため、クラスターのサイズに応じて移行にかかる合計時間が増加します。

4. ホスト上の新規マシン設定のステータスを確認します。

   1. マシン設定の状態と適用されたマシン設定の名前をリスト表示するには、以下のコマンドを入力します。

      $ oc describe node | egrep "hostname|machineconfig"

      出力例

      kubernetes.io/hostname=master-0
      machineconfiguration.openshift.io/currentConfig: rendered-master-c53e221d9d24e1c8bb6ee89dd3d8ad7b
      machineconfiguration.openshift.io/desiredConfig: rendered-master-c53e221d9d24e1c8bb6ee89dd3d8ad7b
      machineconfiguration.openshift.io/reason:
      machineconfiguration.openshift.io/state: Done

   2. 以下のステートメントが true であることを確認します。

      • machineconfiguration.openshift.io/state フィールドの値は Done です。
      • machineconfiguration.openshift.io/currentConfig フィールドの値は、machineconfiguration.openshift.io/desiredConfig フィールドの値と等しくなります。

   3. マシン設定が正しいことを確認するには、以下のコマンドを入力します。

      $ oc get machineconfig <config_name> -o yaml | grep ExecStart

      ここで、<config_name> は machineconfiguration.openshift.io/currentConfig フィールドのマシン設定の名前になります。

      マシン設定には、systemd 設定に以下の更新を含める必要があります。

      ExecStart=/usr/local/bin/mtu-migration.sh

5. MTU の移行を完了するために、OVN-Kubernetes ネットワークプラグインに対して次のコマンドを入力します。

   $ oc patch Network.operator.openshift.io cluster --type=merge --patch \
     '{"spec": { "migration": null, "defaultNetwork":{ "ovnKubernetesConfig": { "mtu": <mtu> }}}}'

   ここでは、以下のようになります。

   <mtu>

   <overlay_to> で指定した新しいクラスターネットワーク MTU を指定します。

6. MTU の移行が完了すると、各マシン設定プールノードが 1 つずつ再起動します。すべてのノードが更新されるまで待機する必要があります。以下のコマンドを実行してマシン設定プールのステータスを確認します。

   $ oc get machineconfigpools

   正常に更新されたノードには、UPDATED=true、UPDATING=false、DEGRADED=false のステータスがあります。

手順

1. このドキュメントの「VPC サブネット用の CloudFormation テンプレート」セクションに移動し、テンプレートから構文をコピーします。コピーしたテンプレートの構文を YAML ファイルとしてローカルシステムに保存します。このテンプレートは、クラスターに必要な VPC を記述しています。

2. 次のコマンドを実行して CloudFormation テンプレートをデプロイします。これにより、VPC を表す AWS リソースのスタックが作成されます。

   $ aws cloudformation create-stack --stack-name <stack_name> \1
     --region ${CLUSTER_REGION} \
     --template-body file://<template>.yaml \2
     --parameters \
       ParameterKey=VpcId,ParameterValue="${VPC_ID}" \3
       ParameterKey=ClusterName,ParameterValue="${CLUSTER_NAME}" \4
       ParameterKey=ZoneName,ParameterValue="${ZONE_NAME}" \5
       ParameterKey=PublicRouteTableId,ParameterValue="${ROUTE_TABLE_PUB}" \6
       ParameterKey=PublicSubnetCidr,ParameterValue="${SUBNET_CIDR_PUB}" \7
       ParameterKey=PrivateRouteTableId,ParameterValue="${ROUTE_TABLE_PVT}" \8
       ParameterKey=PrivateSubnetCidr,ParameterValue="${SUBNET_CIDR_PVT}" \9
       ParameterKey=PrivateSubnetLabel,ParameterValue="private-outpost" \
       ParameterKey=PublicSubnetLabel,ParameterValue="public-outpost" \
       ParameterKey=OutpostArn,ParameterValue="${OUTPOST_ARN}" 10

   1

   <stack_name> は、CloudFormation スタックの名前です (cluster-<outpost_name> など)。

   2

   <template> は、保存した CloudFormation テンプレート YAML ファイルの相対パスと名前です。

   3

   ${VPC_ID} は VPC ID であり、VPC 用の CloudFormation テンプレートの出力に含まれる値 VpcID です。

   4

   ${CLUSTER_NAME} は、新しい AWS リソース名の接頭辞として使用する ClusterName の値です。

   5

   ${ZONE_NAME} は、サブネットを作成する AWS Outposts 名の値です。

   6

   ${ROUTE_TABLE_PUB} は、Outpost 上のパブリックサブネットを関連付けるために使用する、${VPC_ID} に作成されたパブリックルートテーブル ID です。このスタックによって作成された Outpost サブネットを関連付けるパブリックルートテーブルを指定します。

   7

   ${SUBNET_CIDR_PUB} は、パブリックサブネットの作成に使用する有効な CIDR ブロックです。このブロックは、VPC CIDR ブロック VpcCidr の一部である必要があります。

   8

   ${ROUTE_TABLE_PVT} は、Outpost 上のプライベートサブネットを関連付けるために使用する、${VPC_ID} に作成されたプライベートルートテーブル ID です。このスタックによって作成された Outpost サブネットを関連付けるプライベートルートテーブルを指定します。

   9

   ${SUBNET_CIDR_PVT} は、プライベートサブネットの作成に使用する有効な CIDR ブロックです。このブロックは、VPC CIDR ブロック VpcCidr の一部である必要があります。

   10

   ${OUTPOST_ARN} は、Outpost の Amazon Resource Name (ARN) です。

   出力例

   arn:aws:cloudformation:us-east-1:123456789012:stack/<stack_name>/dbedae40-820e-11eb-2fd3-12a48460849f

手順

1. オプション: 次のコマンドを実行し、出力に Outpost 内のエッジコンピュートノードのみが含まれていることを確認して、エッジコンピュートノードに location=outposts ラベルがあることを確認します。

   $ oc get nodes -l location=outposts

2. 次のコマンドを実行して、VPC クラスター内のクラウドベースのコンピュートノードにキーと値のペアのラベルを付けます。

   $ for NODE in $(oc get node -l node-role.kubernetes.io/worker --no-headers | grep -v outposts | awk '{print$1}'); do oc label node $NODE <key_name>=<value>; done

   <key_name>=<value> は、クラウドベースのコンピュートノードを識別するために使用するラベルです。

   出力例

   node1.example.com labeled
   node2.example.com labeled
   node3.example.com labeled

3. オプション: 次のコマンドを実行し、出力に VPC クラスター内のすべてのクラウドベースのコンピュートノードが含まれていることを確認して、クラウドベースのコンピュートノードに指定したラベルがあることを確認します。

   $ oc get nodes -l <key_name>=<value>

   出力例

   NAME                   STATUS    ROLES     AGE       VERSION
   node1.example.com      Ready     worker    7h        v1.29.4
   node2.example.com      Ready     worker    7h        v1.29.4
   node3.example.com      Ready     worker    7h        v1.29.4

4. クラウドベースのサブネットの情報を Service マニフェストの annotations フィールドに追加して、Classic Load Balancer サービスを設定します。

   サービス設定の例

   apiVersion: v1
   kind: Service
   metadata:
     labels:
       app: <application_name>
     name: <application_name>
     namespace: <application_namespace>
     annotations:
       service.beta.kubernetes.io/aws-load-balancer-subnets: <aws_subnet> 1
       service.beta.kubernetes.io/aws-load-balancer-target-node-labels: <key_name>=<value> 2
   spec:
     ports:
     - name: http
       port: 80
       protocol: TCP
       targetPort: 8080
     selector:
       app: <application_name>
     type: LoadBalancer

   1

   AWS VPC クラスターのサブネット ID を指定します。

   2

   ノードラベルのペアと一致するキーと値のペアを指定します。

5. 次のコマンドを実行して Service CR を作成します。

   $ oc create -f <file_name>.yaml

検証

1. 次のコマンドを実行して、service リソースのステータスを確認して、プロビジョニングされた Classic Load Balancer のホストを表示します。

   $ HOST=$(oc get service <application_name> -n <application_namespace> --template='{{(index .status.loadBalancer.ingress 0).hostname}}')

2. 次のコマンドを実行して、プロビジョニングされた Classic Load Balancer ホストのステータスを確認します。

   $ curl $HOST

3. AWS コンソールで、ラベル付きインスタンスのみがロードバランサーのターゲットインスタンスとして表示されることを確認します。