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. 나열된 컴퓨팅 머신 세트 중 하나에 대한 AMI(Amazon Machine Image) 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 리소스 이름(ARN)입니다.

   • Outpost 가용성 영역입니다.

     참고

     aws outposts list-outposts 명령의 출력에는 AvailabilityZone 및 AvailabilityZoneId과 관련된 두 개의 값이 포함됩니다. AvailablilityZone 값을 사용하여 Outpost에 컴퓨팅 시스템을 생성하는 컴퓨팅 머신 세트를 구성합니다.

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는 각 머신 구성 풀에서 머신을 업데이트하므로 각 노드를 하나씩 재부팅합니다. 모든 노드가 업데이트될 때까지 기다려야 합니다. 다음 명령을 입력하여 머신 구성 풀 상태를 확인합니다.

   $ oc get machineconfigpools

   업데이트된 노드의 상태가 UPDATED=true, UPDATING=false,DEGRADED=false입니다.

   참고

   기본적으로 Machine Config Operator는 풀당 한 번에 하나의 머신을 업데이트하여 클러스터 크기에 따라 마이그레이션에 걸리는 총 시간을 늘립니다.

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. 다음 구문이 올바른지 확인합니다.

      • 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 마이그레이션을 완료한 후 각 머신 구성 풀 노드는 하나씩 재부팅됩니다. 모든 노드가 업데이트될 때까지 기다려야 합니다. 다음 명령을 입력하여 머신 구성 풀 상태를 확인합니다.

   $ oc get machineconfigpools

   업데이트된 노드의 상태가 UPDATED=true, UPDATING=false,DEGRADED=false입니다.

프로세스

1. "CloudFormation template for the VPC subnet"이라는 문서의 섹션으로 이동하여 템플릿에서 구문을 복사합니다. 복사한 템플릿 구문을 로컬 시스템에 YAML 파일로 저장합니다. 이 템플릿은 클러스터에 필요한 VPC를 설명합니다.

2. 다음 명령을 실행하여 VPC를 나타내는 AWS 리소스 스택을 생성하는 CloudFormation 템플릿을 배포합니다.

   $ 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&gt;).

   2

   <template >은 상대 경로이며 저장한 CloudFormation 템플릿 YAML 파일의 이름입니다.

   3

   ${VPC_ID} 는 VPC의 CloudFormation 템플릿 출력에 있는 VpcID 값인 VPC ID입니다.

   4

   ${CLUSTER_NAME} 은 새 AWS 리소스 이름의 접두사로 사용할 ClusterName 의 값입니다.

   5

   ${ZONE_NAME} 은 서브넷을 생성할 AWS Outposts 이름의 값입니다.

   6

   ${ROUTE_ Cryostat_PUB} 은 Outpost의 공용 서브넷을 연결하는 데 사용되는 ${VPC_ID} 에서 생성된 공개 경로 테이블 ID입니다. 이 스택에서 생성한 Outpost 서브넷을 연결할 공용 경로 테이블을 지정합니다.

   7

   ${SUBNET_CIDR_PUB} 는 공용 서브넷을 생성하는 데 사용되는 유효한 CIDR 블록입니다. 이 블록은 VPC CIDR 블록 VpcCidr 의 일부여야 합니다.

   8

   ${ROUTE_ Cryostat_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.30.3
   node2.example.com      Ready     worker    7h        v1.30.3
   node3.example.com      Ready     worker    7h        v1.30.3

4. 서비스 매니페스트의 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. 다음 명령을 실행하여 프로비저닝된 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 콘솔에서 레이블이 지정된 인스턴스만 로드 밸런서의 대상 인스턴스로 표시되는지 확인합니다.