18장. AWS 로컬 영역 작업

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:         OpenShiftSDN
     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의 경우 100 미만이어야 하며 OpenShift SDN의 경우 50 미만이어야 합니다.

   <machine_to>

   기본 호스트 네트워크의 기본 네트워크 인터페이스에 대한 MTU를 지정합니다.

   클러스터 MTU를 늘리는 예

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

3. MCO는 각 머신 구성 풀의 머신을 업데이트할 때 각 노드를 하나씩 재부팅합니다. 모든 노드가 업데이트될 때까지 기다려야 합니다. 다음 명령을 입력하여 머신 구성 풀 상태를 확인합니다.

   $ oc get mcp

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

   참고

   기본적으로 MCO는 풀당 한 번에 하나의 시스템을 업데이트하므로 클러스터 크기에 따라 마이그레이션에 걸리는 총 시간이 증가합니다.

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

      다음 구문이 올바른지 확인합니다.

      • machineconfiguration.openshift.io/state 필드의 값은 Done입니다.
      • machineconfiguration.openshift.io/currentConfig 필드의 값은 machineconfiguration.openshift.io/desiredConfig 필드의 값과 동일합니다.

   2. 머신 구성이 올바른지 확인하려면 다음 명령을 입력합니다.

      $ 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를 지정합니다.

   • OpenShift SDN 네트워크 플러그인을 사용하는 경우:

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

     다음과 같습니다.

     <mtu>

     < overlay_to>로 지정한 새 클러스터 네트워크 MTU를 지정합니다.

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

   $ oc get mcp

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

프로세스

1. 템플릿에 필요한 매개변수 값이 포함된 JSON 파일을 생성합니다.

   [
     {
       "ParameterKey": "VpcId",
       "ParameterValue": "<value_of_VpcId>" 1
     },
     {
       "ParameterKey": "PublicRouteTableId",
       "ParameterValue": "<value_of_PublicRouteTableId>" 2
     },
     {
       "ParameterKey": "ZoneName",
       "ParameterValue": "<value_of_ZoneName>" 3
     },
     {
       "ParameterKey": "SubnetName",
       "ParameterValue": "<value_of_SubnetName>"
     },
     {
       "ParameterKey": "PublicSubnetCidr",
       "ParameterValue": "10.0.192.0/20" 4
     }
   ]

   1

   VPC ID를 지정합니다. 이는 CloudFormation 템플릿의 출력에서 VpcID 값인 VPC ID를 지정합니다.

   2

   VPC의 CloudFormation 스택에서 PublicRouteTableId 의 값인 Route Table ID를 지정합니다.

   3

   "AWS Local Zones" 섹션에서 검색한 AvailabilityZones 오브젝트의 ZoneName 필드 값인 AWS 로컬 영역 이름을 지정합니다.

   4

   Local Zone 서브넷을 생성하는 데 사용되는 CIDR 블록을 지정합니다. 이 블록은 VPC CIDR 블록 VpcCidr 의 일부여야 합니다.

2. 이 항목의 서브넷 섹션에 대한 CloudFormation 템플릿 섹션에서 템플릿을 복사하여 사용자 컴퓨터에 YAML 파일로 저장합니다. 이 템플릿은 클러스터에 필요한 VPC를 설명합니다.

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

   중요

   명령은 한 줄로 입력해야 합니다.

   $ aws cloudformation create-stack --stack-name <subnet_stack_name> \ 1
        --template-body file://<template>.yaml \ 2
        --parameters file://<parameters>.json 3

   1

   < subnet_stack_name >은 CloudFormation 스택의 이름입니다(예: cluster-lz-<local_zone_shortname >). 클러스터를 제거하는 경우 이 스택의 이름이 필요합니다.

   2

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

   3

   <parameters>는 CloudFormation 매개변수 JSON 파일의 상대 경로 및 이름입니다.

   출력 예

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

4. 다음 명령을 실행하여 템플릿 구성 요소가 있는지 확인합니다.

   $ aws cloudformation describe-stacks --stack-name <subnet_stack_name>

   StackStatus에 CREATE_COMPLETE이 표시된 후 다음 매개변수의 출력 값이 표시됩니다. 클러스터를 생성하기 위해 실행하는 다른 CloudFormation 템플릿에 이러한 매개변수 값을 제공해야 합니다.

   PublicSubnetIds

   새 퍼블릭 서브넷의 ID입니다.

프로세스

1. 컴퓨팅 머신 세트 CR(사용자 정의 리소스) 샘플이 포함된 새 YAML 파일을 만들고 <file_name>.yaml이라는 이름을 지정합니다.

   <clusterID> 및 <role> 매개 변수 값을 설정해야 합니다.

2. 선택 사항: 특정 필드에 설정할 값이 확실하지 않은 경우 클러스터에서 기존 컴퓨팅 머신 세트를 확인할 수 있습니다.

   1. 클러스터의 컴퓨팅 머신 세트를 나열하려면 다음 명령을 실행합니다.

      $ oc get machinesets -n openshift-machine-api

      출력 예

      NAME                                DESIRED   CURRENT   READY   AVAILABLE   AGE
      agl030519-vplxk-worker-us-east-1a   1         1         1       1           55m
      agl030519-vplxk-worker-us-east-1b   1         1         1       1           55m
      agl030519-vplxk-worker-us-east-1c   1         1         1       1           55m
      agl030519-vplxk-worker-us-east-1d   0         0                             55m
      agl030519-vplxk-worker-us-east-1e   0         0                             55m
      agl030519-vplxk-worker-us-east-1f   0         0                             55m

   2. 특정 컴퓨팅 머신 세트 CR(사용자 정의 리소스)의 값을 보려면 다음 명령을 실행합니다.

      $ oc get machineset <machineset_name> \
        -n openshift-machine-api -o yaml

      출력 예

      apiVersion: machine.openshift.io/v1beta1
      kind: MachineSet
      metadata:
        labels:
          machine.openshift.io/cluster-api-cluster: <infrastructure_id> 1
        name: <infrastructure_id>-<role> 2
        namespace: openshift-machine-api
      spec:
        replicas: 1
        selector:
          matchLabels:
            machine.openshift.io/cluster-api-cluster: <infrastructure_id>
            machine.openshift.io/cluster-api-machineset: <infrastructure_id>-<role>
        template:
          metadata:
            labels:
              machine.openshift.io/cluster-api-cluster: <infrastructure_id>
              machine.openshift.io/cluster-api-machine-role: <role>
              machine.openshift.io/cluster-api-machine-type: <role>
              machine.openshift.io/cluster-api-machineset: <infrastructure_id>-<role>
          spec:
            providerSpec: 3
              ...

      1

      클러스터 인프라 ID입니다.

      2

      기본 노드 레이블입니다.

      참고

      사용자 프로비저닝 인프라가 있는 클러스터의 경우 컴퓨팅 머신 세트는 worker 및 infra 유형 머신만 생성할 수 있습니다.

      3

      컴퓨팅 머신 세트 CR의 <providerSpec> 섹션에 있는 값은 플랫폼에 따라 다릅니다. CR의 <providerSpec> 매개변수에 대한 자세한 내용은 공급자의 샘플 컴퓨팅 머신 세트 CR 구성을 참조하십시오.

3. 다음 명령을 실행하여 MachineSet CR을 생성합니다.

   $ oc create -f <file_name>.yaml