Alibaba에 설치

OpenShift Container Platform 4.12

Alibaba Cloud에 OpenShift Container Platform 설치

Red Hat OpenShift Documentation Team

초록

이 문서에서는 Alibaba Cloud에 OpenShift Container Platform을 설치하는 방법을 설명합니다.

1장. Alibaba Cloud에 설치 준비

중요

OpenShift Container Platform의 Alibaba Cloud는 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

1.1. 사전 요구 사항

OpenShift Container Platform 설치 및 업데이트 프로세스에 대한 세부 사항을 검토했습니다.
클러스터 설치 방법 선택 및 사용자를 위한 준비에 대한 문서를 읽습니다.

1.2. Alibaba Cloud에 OpenShift Container Platform을 설치하기 위한 요구사항

Alibaba Cloud에 OpenShift Container Platform을 설치하기 전에 도메인을 구성하고 등록하고, 설치에 대한 RAM(리소스 액세스 관리) 사용자를 생성하고, 설치에 지원되는 Alibaba Cloud 데이터 센터 지역 및 영역을 검토해야 합니다.

1.3. Alibaba 클라우드 도메인 등록 및 구성

OpenShift Container Platform을 설치하려면 사용하는 Alibaba Cloud 계정에 전용 공개 호스팅 영역이 있어야 합니다. 도메인에 대한 권한도 이 영역에 있어야 합니다. 이 서비스는 클러스터와 외부 연결에 필요한 클러스터 DNS 확인 및 이름 조회 기능을 제공합니다.

프로세스

도메인 또는 하위 도메인과 등록 기관을 식별합니다. 기존 도메인 및 등록 기관을 이전하거나 Alibaba Cloud 또는 다른 소스를 통해 새 도메인을 구입할 수 있습니다.
참고
Alibaba Cloud를 통해 새 도메인을 구입하는 경우 관련 DNS 변경 사항이 전파되는 데 시간이 걸립니다. Alibaba Cloud를 통한 도메인 구매에 대한 자세한 내용은 Alibaba Cloud 도메인을 참조하십시오.
기존 도메인 및 등록 기관을 사용하는 경우 해당 DNS를 Alibaba Cloud로 마이그레이션합니다. Alibaba Cloud 설명서에서 도메인 이름 전송을 참조하십시오.
도메인에 맞게 DNS를 구성합니다. 여기에는 다음이 포함됩니다.
- 일반 도메인 이름 등록.
- 도메인 이름에 대한 실제 이름 확인을 완료.
- 인터넷 콘텐츠 공급자(ICP) 제출 요청.
- 도메인 이름 확인 활성화.
  적절한 루트 도메인(예: openshiftcorp.com) 또는 하위 도메인(예: clusters.openshiftcorp.com)을 사용합니다.
하위 도메인을 사용하는 경우 회사의 절차에 따라 상위 도메인에 위임 레코드를 추가합니다.

1.4. 지원되는 Alibaba 리전

OpenShift Container Platform 클러스터를 Alibaba 리전 및 영역 설명서에 나열된 리전에 배포할 수 있습니다.

1.5. 다음 단계

필요한 Alibaba 클라우드 리소스를 만듭니다.

2장. 필요한 Alibaba 클라우드 리소스 생성

OpenShift Container Platform을 설치하기 전에 Alibaba Cloud 콘솔을 사용하여 OpenShift Container Platform을 Alibaba Cloud에 설치할 수 있는 충분한 권한이 있는 RAM(Resource Access Management) 사용자를 생성해야 합니다. 또한 이 사용자는 새 RAM 사용자를 생성할 수 있는 권한이 있어야 합니다. ccoctl 툴을 구성하고 사용하여 필요한 권한으로 OpenShift Container Platform 구성 요소에 대한 새 인증 정보를 생성할 수도 있습니다.

중요

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

2.1. 필요한 RAM 사용자 생성

설치하려면 충분한 권한이 있는 Alibaba Cloud 리소스 액세스 관리(RAM) 사용자가 있어야 합니다. Alibaba Cloud Resource Access Management 콘솔을 사용하여 새 사용자를 생성하거나 기존 사용자를 수정할 수 있습니다. 나중에 이 사용자의 권한을 기반으로 OpenShift Container Platform에서 인증 정보를 생성합니다.

RAM 사용자를 구성할 때 다음 요구 사항을 고려해야 합니다.

사용자에게 RuntimeClass Cloud AccessKey ID 및 AccessKey 시크릿 쌍이 있어야 합니다.
- 새 사용자의 경우 사용자를 생성할 때 액세스 모드에 대해 Open API Access를 선택할 수 있습니다. 이 모드에서는 필요한 AccessKey 쌍을 생성합니다.
- 기존 사용자의 경우 AccessKey 쌍을 추가하거나 해당 사용자의 AccessKey 쌍을 가져올 수 있습니다.
  참고
  생성된 AccessKey 시크릿은 한 번만 표시됩니다. API 호출에 AccessKey 쌍이 필요하므로 AccessKey 쌍을 즉시 저장해야 합니다.
로컬 컴퓨터의 ~/.alibabacloud/credentials 파일에 AccessKey ID와 시크릿을 추가합니다. 콘솔에 로그인하면 이 파일이 자동으로 생성됩니다. CCO(Cloud Credential Operator) 유틸리티 ccoutil은 Credential Request 오브젝트를 처리할 때 이러한 인증 정보를 사용합니다.
예를 들면 다음과 같습니다.
```
[default]                          # Default client
type = access_key                  # Certification type: access_key
access_key_id = LTAI5t8cefXKmt                # Key 1
access_key_secret = wYx56mszAN4Uunfh            # Secret
```
1
여기에 AccessKeyID 및 AccessKeySecret을 추가합니다.

RAM 사용자에게는 OpenShift Container Platform 클러스터를 생성할 수 있는 충분한 권한이 계정에 충분한 권한이 있는지 확인하려면 AdministratorAccess 정책이 있어야 합니다. 이 정책은 모든 NetNamespace Cloud 리소스를 관리할 수 있는 권한을 부여합니다.

AdministratorAccess 정책을 RAM 사용자에게 연결하면 해당 사용자에게 모든 RuntimeClass Cloud 서비스 및 리소스에 대한 전체 액세스 권한이 부여됩니다. 전체 액세스 권한이 있는 사용자를 생성하지 않으려면 설치를 위해 RAM 사용자에게 추가할 수 있는 다음 작업으로 사용자 지정 정책을 생성합니다. 이러한 작업은 OpenShift Container Platform을 설치하기에 충분합니다.

작은 정보

다음 JSON 코드를 copy 및 paste the following JSON code to create a custom poicy를 사용하여 JSON 코드를 복사하여 붙여넣을 수 있습니다. 사용자 지정 정책 생성에 대한 자세한 내용은 RuntimeClass Cloud 설명서에서 사용자 지정 정책 만들기를 참조하십시오.

예 2.1. 사용자 정의 정책 JSON 파일의 예

{
  "Version": "1",
  "Statement": [
    {
      "Action": [
        "tag:ListTagResources",
        "tag:UntagResources"
      ],
      "Resource": "*",
      "Effect": "Allow"
    },
    {
      "Action": [
        "vpc:DescribeVpcs",
        "vpc:DeleteVpc",
        "vpc:DescribeVSwitches",
        "vpc:DeleteVSwitch",
        "vpc:DescribeEipAddresses",
        "vpc:DescribeNatGateways",
        "vpc:ReleaseEipAddress",
        "vpc:DeleteNatGateway",
        "vpc:DescribeSnatTableEntries",
        "vpc:CreateSnatEntry",
        "vpc:AssociateEipAddress",
        "vpc:ListTagResources",
        "vpc:TagResources",
        "vpc:DescribeVSwitchAttributes",
        "vpc:CreateVSwitch",
        "vpc:CreateNatGateway",
        "vpc:DescribeRouteTableList",
        "vpc:CreateVpc",
        "vpc:AllocateEipAddress",
        "vpc:ListEnhanhcedNatGatewayAvailableZones"
      ],
      "Resource": "*",
      "Effect": "Allow"
    },
    {
      "Action": [
        "ecs:ModifyInstanceAttribute",
        "ecs:DescribeSecurityGroups",
        "ecs:DeleteSecurityGroup",
        "ecs:DescribeSecurityGroupReferences",
        "ecs:DescribeSecurityGroupAttribute",
        "ecs:RevokeSecurityGroup",
        "ecs:DescribeInstances",
        "ecs:DeleteInstances",
        "ecs:DescribeNetworkInterfaces",
        "ecs:DescribeInstanceRamRole",
        "ecs:DescribeUserData",
        "ecs:DescribeDisks",
        "ecs:ListTagResources",
        "ecs:AuthorizeSecurityGroup",
        "ecs:RunInstances",
        "ecs:TagResources",
        "ecs:ModifySecurityGroupPolicy",
        "ecs:CreateSecurityGroup",
        "ecs:DescribeAvailableResource",
        "ecs:DescribeRegions",
        "ecs:AttachInstanceRamRole"
      ],
      "Resource": "*",
      "Effect": "Allow"
    },
    {
      "Action": [
        "pvtz:DescribeRegions",
        "pvtz:DescribeZones",
        "pvtz:DeleteZone",
        "pvtz:DeleteZoneRecord",
        "pvtz:BindZoneVpc",
        "pvtz:DescribeZoneRecords",
        "pvtz:AddZoneRecord",
        "pvtz:SetZoneRecordStatus",
        "pvtz:DescribeZoneInfo",
        "pvtz:DescribeSyncEcsHostTask",
        "pvtz:AddZone"
      ],
      "Resource": "*",
      "Effect": "Allow"
    },
    {
      "Action": [
        "slb:DescribeLoadBalancers",
        "slb:SetLoadBalancerDeleteProtection",
        "slb:DeleteLoadBalancer",
        "slb:SetLoadBalancerModificationProtection",
        "slb:DescribeLoadBalancerAttribute",
        "slb:AddBackendServers",
        "slb:DescribeLoadBalancerTCPListenerAttribute",
        "slb:SetLoadBalancerTCPListenerAttribute",
        "slb:StartLoadBalancerListener",
        "slb:CreateLoadBalancerTCPListener",
        "slb:ListTagResources",
        "slb:TagResources",
        "slb:CreateLoadBalancer"
      ],
      "Resource": "*",
      "Effect": "Allow"
    },
    {
      "Action": [
        "ram:ListResourceGroups",
        "ram:DeleteResourceGroup",
        "ram:ListPolicyAttachments",
        "ram:DetachPolicy",
        "ram:GetResourceGroup",
        "ram:CreateResourceGroup",
        "ram:DeleteRole",
        "ram:GetPolicy",
        "ram:DeletePolicy",
        "ram:ListPoliciesForRole",
        "ram:CreateRole",
        "ram:AttachPolicyToRole",
        "ram:GetRole",
        "ram:CreatePolicy",
        "ram:CreateUser",
        "ram:DetachPolicyFromRole",
        "ram:CreatePolicyVersion",
        "ram:DetachPolicyFromUser",
        "ram:ListPoliciesForUser",
        "ram:AttachPolicyToUser",
        "ram:CreateUser",
        "ram:GetUser",
        "ram:DeleteUser",
        "ram:CreateAccessKey",
        "ram:ListAccessKeys",
        "ram:DeleteAccessKey",
        "ram:ListUsers",
        "ram:ListPolicyVersions"
      ],
      "Resource": "*",
      "Effect": "Allow"
    },
    {
      "Action": [
        "oss:DeleteBucket",
        "oss:DeleteBucketTagging",
        "oss:GetBucketTagging",
        "oss:GetBucketCors",
        "oss:GetBucketPolicy",
        "oss:GetBucketLifecycle",
        "oss:GetBucketReferer",
        "oss:GetBucketTransferAcceleration",
        "oss:GetBucketLog",
        "oss:GetBucketWebSite",
        "oss:GetBucketInfo",
        "oss:PutBucketTagging",
        "oss:PutBucket",
        "oss:OpenOssService",
        "oss:ListBuckets",
        "oss:GetService",
        "oss:PutBucketACL",
        "oss:GetBucketLogging",
        "oss:ListObjects",
        "oss:GetObject",
        "oss:PutObject",
        "oss:DeleteObject"
      ],
      "Resource": "*",
      "Effect": "Allow"
    },
    {
      "Action": [
        "alidns:DescribeDomainRecords",
        "alidns:DeleteDomainRecord",
        "alidns:DescribeDomains",
        "alidns:DescribeDomainRecordInfo",
        "alidns:AddDomainRecord",
        "alidns:SetDomainRecordStatus"
      ],
      "Resource": "*",
      "Effect": "Allow"
    },
    {
      "Action": "bssapi:CreateInstance",
      "Resource": "*",
      "Effect": "Allow"
    },
    {
      "Action": "ram:PassRole",
      "Resource": "*",
      "Effect": "Allow",
      "Condition": {
        "StringEquals": {
          "acs:Service": "ecs.aliyuncs.com"
        }
      }
    }
  ]
}

RAM 사용자를 만들고 권한을 부여하는 방법에 대한 자세한 내용은 RAM 사용자 생성 및 RAM 사용자에게 권한 부여 를 참조하십시오.

2.2. Cloud Credential Operator 유틸리티 구성

클러스터 내 구성 요소에 대해 장기 RAM AccessKeys(AK)를 제공하는 RAM 사용자와 정책을 할당하려면 CCO(Cloud Credential Operator) 유틸리티(ccoctl) 바이너리를 추출하고 준비합니다.

참고

ccoctl 유틸리티는 Linux 환경에서 실행해야 하는 Linux 바이너리입니다.

사전 요구 사항

클러스터 관리자 액세스 권한이 있는 OpenShift Container Platform 계정에 액세스할 수 있습니다.
OpenShift CLI(oc)가 설치되어 있습니다.

프로세스

다음 명령을 실행하여 OpenShift Container Platform 릴리스 이미지를 가져옵니다.
```
$ RELEASE_IMAGE=$(./openshift-install version | awk '/release image/ {print $3}')
```
다음 명령을 실행하여 OpenShift Container Platform 릴리스 이미지에서 CCO 컨테이너 이미지를 가져옵니다.
```
$ CCO_IMAGE=$(oc adm release info --image-for='cloud-credential-operator' $RELEASE_IMAGE -a ~/.pull-secret)
```
참고
$RELEASE_IMAGE 의 아키텍처가 ccoctl 툴을 사용할 환경의 아키텍처와 일치하는지 확인합니다.
다음 명령을 실행하여 OpenShift Container Platform 릴리스 이미지 내에서 ccoctl 바이너리를 추출합니다.
```
$ oc image extract $CCO_IMAGE --file="/usr/bin/ccoctl" -a ~/.pull-secret
```
다음 명령을 실행하여 ccoctl 을 실행할 수 있도록 권한을 변경합니다.
```
$ chmod 775 ccoctl
```

검증

ccoctl 을 사용할 준비가 되었는지 확인하려면 다음 명령을 실행하여 도움말 파일을 표시합니다.

$ ccoctl --help

ccoctl --help의 출력

OpenShift credentials provisioning tool

Usage:
  ccoctl [command]

Available Commands:
  alibabacloud Manage credentials objects for alibaba cloud
  aws          Manage credentials objects for AWS cloud
  gcp          Manage credentials objects for Google cloud
  help         Help about any command
  ibmcloud     Manage credentials objects for IBM Cloud
  nutanix      Manage credentials objects for Nutanix

Flags:
  -h, --help   help for ccoctl

Use "ccoctl [command] --help" for more information about a command.

추가 리소스

수동으로 유지 관리되는 인증 정보로 클러스터 업데이트 준비

2.3. 다음 단계

다음 방법 중 하나를 사용하여 OpenShift Container Platform 설치 프로그램에서 프로비저닝한 Alibaba Cloud 인프라에 클러스터를 설치합니다.
- Alibaba Cloud에 빠르게 클러스터 설치: 기본 구성 옵션을 사용하여 클러스터를 빠르게 설치할 수 있습니다.
- Alibaba Cloud에 사용자 지정 클러스터 설치: 설치 프로그램을 통해 설치 단계에서 일부 사용자 지정을 적용할 수 있습니다. 다른 많은 사용자 정의 옵션은 설치 후 사용할 수 있습니다.

3장. Alibaba Cloud에 빠르게 클러스터 설치

OpenShift Container Platform 버전 4.12에서는 기본 구성 옵션을 사용하는 클러스터를 Alibaba Cloud에 설치할 수 있습니다.

중요

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

3.1. 사전 요구 사항

OpenShift Container Platform 설치 및 업데이트 프로세스에 대한 세부 사항을 검토했습니다.
클러스터 설치 방법 선택 및 사용자를 위한 준비에 대한 문서를 읽습니다.
도메인을 등록했습니다.
방화벽을 사용하는 경우 클러스터가 액세스해야 하는 사이트를 허용하도록 방화벽을 구성했습니다.
필요한 Alibaba 클라우드 리소스를 생성 했습니다.
사용자의 환경에서 Cloud Resource Access Management(RAM) API에 액세스할 수 없거나 kube-system 네임스페이스에 관리자 수준의 인증 정보 시크릿을 저장하지 않으려면 수동으로 리소스 액세스 관리(RAM) 인증 정보를 생성하고 유지 관리할 수 있습니다.

3.2. OpenShift Container Platform 용 인터넷 액세스

OpenShift Container Platform 4.12에서 클러스터를 설치하려면 인터넷 액세스가 필요합니다.

다음의 경우 인터넷 액세스가 필요합니다.

OpenShift Cluster Manager Hybrid Cloud Console 에 액세스하여 설치 프로그램을 다운로드하고 서브스크립션 관리를 수행합니다. 클러스터가 인터넷에 액세스할 수 있고 Telemetry 서비스를 비활성화하지 않은 경우, 클러스터에 자동으로 권한이 부여됩니다.
Quay.io에 액세스. 클러스터를 설치하는 데 필요한 패키지를 받을 수 있습니다.
클러스터 업데이트를 수행하는 데 필요한 패키지를 받을 수 있습니다.

중요

클러스터가 직접 인터넷에 액세스할 수 없는 경우, 프로비저닝하는 일부 유형의 인프라에서 제한된 네트워크 설치를 수행할 수 있습니다. 이 프로세스 동안 필요한 콘텐츠를 다운로드하고 이를 사용하여 설치 패키지로 미러 레지스트리를 채웁니다. 설치 유형에 따라서는 클러스터를 설치하는 환경에 인터넷 액세스가 필요하지 않을 수도 있습니다. 클러스터를 업데이트하기 전에 미러 레지스트리의 내용을 업데이트합니다.

3.3. 클러스터 노드 SSH 액세스를 위한 키 쌍 생성

OpenShift Container Platform을 설치하는 동안 SSH 공개 키를 설치 프로그램에 지정할 수 있습니다. 키는 Ignition 구성 파일을 통해 RHCOS(Red Hat Enterprise Linux CoreOS) 노드에 전달되며 노드에 대한 SSH 액세스를 인증하는 데 사용됩니다. 키는 각 노드에서 core 사용자의 ~/.ssh/authorized_keys 목록에 추가되어 암호 없는 인증을 활성화합니다.

키가 노드에 전달되면 키 쌍을 사용하여 사용자 core로 RHCOS 노드에 SSH로 SSH 연결을 수행할 수 있습니다 . SSH를 통해 노드에 액세스하려면 로컬 사용자의 SSH에서 개인 키 ID를 관리해야 합니다.

설치 디버깅 또는 재해 복구를 수행하기 위해 클러스터 노드에 SSH를 실행하려면 설치 프로세스 중에 SSH 공용 키를 지정해야 합니다. ./openshift-install gather 명령에도 SSH 공개 키가 클러스터 노드에 있어야 합니다.

중요

재해 복구 및 디버깅이 필요한 프로덕션 환경에서는이 단계를 생략하지 마십시오.

참고

AWS 키 쌍과 같이 플랫폼 고유의 방식으로 구성된 키가 아닌 로컬 키를 사용해야 합니다.

프로세스

로컬 시스템에 클러스터 노드의 인증에 사용할 기존 SSH 키 쌍이 없는 경우 새로 생성합니다. 예를 들어 Linux 운영 체제를 사용하는 컴퓨터에서 다음 명령을 실행합니다.
```
$ ssh-keygen -t ed25519 -N '' -f <path>/<file_name> 1
```
1
새 SSH 키의 경로 및 파일 이름(예: ~/.ssh/id_ed25519 )을 지정합니다. 기존 키 쌍이 있는 경우 공개 키가 '~/.ssh 디렉터리에 있는지 확인하십시오.
참고
x86_64,ppc64le, s390x 아키텍처에서 FIPS 검증 또는 진행중인 모듈 In Process 암호화 라이브러리를 사용하는 OpenShift Container Platform 클러스터를 설치하려면 ed25519 알고리즘을 사용하는 키를 생성하지 마십시오. 대신 rsa 또는 ecdsa 알고리즘을 사용하는 키를 생성합니다.
공개 SSH 키를 확인합니다.
```
$ cat <path>/<file_name>.pub
```
예를 들어 다음을 실행하여 ~/.ssh/id_ed25519.pub 공개 키를 확인합니다.
```
$ cat ~/.ssh/id_ed25519.pub
```
아직 추가되지 않은 경우 로컬 사용자의 SSH 에이전트에 SSH 개인 키 ID를 추가합니다. 키의 SSH 에이전트 관리는 클러스터 노드에 암호 없는 SSH 인증을 수행하거나 ./openshift-install gather 명령을 사용하려는 경우 필요합니다.
참고
일부 배포에서는 ~/.ssh/id_rsa 및 ~/.ssh/id_dsa와 같은 기본 SSH 개인 키 ID가 자동으로 관리됩니다.
1. ssh-agent 프로세스가 로컬 사용자에 대해 실행되지 않은 경우 백그라운드 작업으로 시작합니다.
```
$ eval "$(ssh-agent -s)"
```
  출력 예
```
Agent pid 31874
```
  참고
  클러스터가 FIPS 모드인 경우 FIPS 호환 알고리즘만 사용하여 SSH 키를 생성합니다. 키는 RSA 또는 ECDSA여야 합니다.
ssh-agent에 SSH 개인 키를 추가합니다.
```
$ ssh-add <path>/<file_name> 1
```
1
SSH 개인 키의 경로와 파일 이름을 지정합니다(예: ~/.ssh/id_ed25519).
출력 예
```
Identity added: /home/<you>/<path>/<file_name> (<computer_name>)
```

다음 단계

OpenShift Container Platform을 설치할 때 SSH 공개 키를 설치 프로그램에 지정합니다.

3.4. 설치 프로그램 받기

OpenShift Container Platform을 설치하기 전에 설치에 사용하는 호스트에 설치 파일을 다운로드합니다.

사전 요구 사항

500MB의 로컬 디스크 공간이 있는 Linux 또는 macOS를 실행하는 컴퓨터가 있습니다.

프로세스

OpenShift Cluster Manager 사이트의 인프라 공급자 페이지에 액세스합니다. Red Hat 계정이 있으면 사용자 자격 증명으로 로그인합니다. 계정이 없으면 계정을 만드십시오.
인프라 공급자를 선택합니다.
설치 유형 페이지로 이동하여 호스트 운영 체제 및 아키텍처에 해당하는 설치 프로그램을 다운로드하여 설치 구성 파일을 저장할 디렉터리에 파일을 배치합니다.
중요
설치 프로그램은 클러스터를 설치하는 데 사용하는 컴퓨터에 여러 파일을 만듭니다. 클러스터 설치를 마친 후 설치 프로그램과 설치 프로그램으로 생성되는 파일을 보관해야 합니다. 클러스터를 삭제하려면 두 파일이 모두 필요합니다.
중요
클러스터 설치에 실패하거나 설치 프로그램으로 만든 파일을 삭제해도 클러스터는 제거되지 않습니다. 클러스터를 제거하려면 해당 클라우드 공급자에 적용되는 OpenShift Container Platform 설치 제거 절차를 완료해야 합니다.
설치 프로그램 파일의 압축을 풉니다. 예를 들어 Linux 운영 체제를 사용하는 컴퓨터에서 다음 명령을 실행합니다.
```
$ tar -xvf openshift-install-linux.tar.gz
```
Red Hat OpenShift Cluster Manager에서 설치 풀 시크릿을 다운로드합니다. 이 풀 시크릿을 사용하면 OpenShift Container Platform 구성 요소에 대한 컨테이너 이미지를 제공하는 Quay.io를 포함하여 인증 기관에서 제공하는 서비스로 인증할 수 있습니다.

3.5. 설치 구성 파일 만들기

vGPU Cloud에 설치하는 OpenShift Container Platform 클러스터를 사용자 지정할 수 있습니다.

사전 요구 사항

OpenShift Container Platform 설치 프로그램과 클러스터의 풀 시크릿을 받습니다.
서브스크립션 수준에서 서비스 권한을 확보합니다.

프로세스

install-config.yaml 파일을 생성합니다.
1. 설치 프로그램이 포함된 디렉터리로 변경하고 다음 명령을 실행합니다.
```
$ ./openshift-install create install-config --dir <installation_directory> 1
```
  1
  <installation_directory>는 설치 프로그램이 생성하는 파일을 저장할 디렉터리 이름을 지정합니다.
  디렉터리를 지정할 때 다음을 수행합니다.
  - 디렉터리에 실행 권한이 있는지 확인합니다. 설치 디렉토리에서 Terraform 바이너리를 실행하려면 이 권한이 필요합니다.
  - 빈 디렉터리를 사용합니다. 부트스트랩 X.509 인증서와 같은 일부 설치 자산은 단기간에 만료되므로 설치 디렉터리를 재사용해서는 안 됩니다. 다른 클러스터 설치의 개별 파일을 재사용하려면 해당 파일을 사용자 디렉터리에 복사하면 됩니다. 그러나 설치 자산의 파일 이름은 릴리스간에 변경될 수 있습니다. 따라서 이전 OpenShift Container Platform 버전에서 설치 파일을 복사할 때는 주의하십시오.
2. 화면에 나타나는 지시에 따라 클라우드에 대한 구성 세부 사항을 입력합니다.
  1. 선택사항: 클러스터 시스템에 액세스하는 데 사용할 SSH 키를 선택합니다.
    참고
    설치 디버깅 또는 재해 복구를 수행하려는 프로덕션 OpenShift Container Platform 클러스터의 경우 ssh-agent 프로세스가 사용하는 SSH 키를 지정합니다.
  2. 대상 플랫폼으로 alibabacloud 를 선택합니다.
  3. 클러스터를 배포할 리전을 선택합니다.
  4. 클러스터를 배포할 기본 도메인을 선택합니다. 기본 도메인은 클러스터용으로 생성한 퍼블릭 DNS 영역에 해당합니다.
  5. 클러스터에 대한 설명이 포함된 이름을 입력합니다.
  6. Red Hat OpenShift Cluster Manager에서 풀 시크릿 을 붙여넣습니다.
RuntimeClass 클라우드에 클러스터를 설치하려면 CCO(Cloud Credential Operator)가 수동 모드에서 작동해야 합니다. install-config.yaml 파일을 수정하여 credentialsMode 매개변수를 Manual 로 설정합니다.
credentialsMode 가 Manual로 설정된 install-config.yaml 구성 파일의 예
```
apiVersion: v1
baseDomain: cluster1.example.com
credentialsMode: Manual 1
compute:
- architecture: amd64
  hyperthreading: Enabled
 ...
```
1
이 행을 추가하여 credentialsMode를 Manual로 설정합니다.
여러 클러스터를 설치하는 데 사용할 수 있도록 install-config.yaml 파일을 백업합니다.
중요
install-config.yaml 파일은 설치 과정에서 사용됩니다. 이 파일을 재사용하려면 지금 백업해야 합니다.

3.6. 필요한 설치 매니페스트 생성

클러스터가 머신을 구성하는 데 필요한 Kubernetes 매니페스트 및 Ignition 구성 파일을 생성해야 합니다.

프로세스

설치 프로그램이 포함된 디렉터리에서 다음 명령을 실행하여 매니페스트를 생성합니다.
```
$ openshift-install create manifests --dir <installation_directory>
```
다음과 같습니다.
<installation_directory>
설치 프로그램이 파일을 생성하는 디렉터리를 지정합니다.

3.7. ccoctl 툴을 사용하여 OpenShift Container Platform 구성 요소의 인증 정보 생성

OpenShift Container Platform Cloud Credential Operator (CCO) 유틸리티를 사용하여 각 클러스터 내 구성 요소에 대해 RuntimeClass Cloud RAM 사용자 및 정책 생성을 자동화할 수 있습니다.

참고

기본적으로 ccoctl은 명령이 실행되는 디렉터리에 오브젝트를 생성합니다. 다른 디렉터리에 오브젝트를 생성하려면 --output-dir 플래그를 사용합니다. 이 절차에서는 <path_to_ccoctl_output_dir>을 사용하여 이 디렉터리를 나타냅니다.

사전 요구 사항

다음이 있어야 합니다.

ccoctl 바이너리를 추출하여 준비합니다.
OpenShift Container Platform 클러스터를 생성할 수 있는 충분한 권한이 있는 RAM 사용자가 생성되어 있어야 합니다.
해당 RAM 사용자의 AccessKeyID (access_key_id) 및 AccessKeySecret (access_key_secret)을 로컬 컴퓨터의 ~/.alibabacloud/credentials 파일에 추가했습니다.

프로세스

다음 명령을 실행하여 $RELEASE_IMAGE 변수를 설정합니다.

$ RELEASE_IMAGE=$(./openshift-install version | awk '/release image/ {print $3}')

다음 명령을 실행하여 OpenShift Container Platform 릴리스 이미지에서 CredentialsRequest 오브젝트 목록을 추출합니다.
```
$ oc adm release extract \
--credentials-requests \
--cloud=alibabacloud \
--to=<path_to_directory_with_list_of_credentials_requests>/credrequests \ 1
$RELEASE_IMAGE
```
1
credrequests 는 CredentialsRequest 오브젝트 목록이 저장되는 디렉터리입니다. 이 명령은 디렉터리가 없는 경우 해당 디렉터리를 생성합니다.
참고
이 명령을 실행하는 데 시간이 다소 걸릴 수 있습니다.
클러스터에서 클러스터 기능을 사용하여 하나 이상의 선택적 구성 요소를 비활성화하는 경우 비활성화된 구성 요소에 대한 CredentialsRequest 사용자 정의 리소스를 삭제합니다.
Alibaba Cloud에서 OpenShift Container Platform 4.12의 credrequests 디렉터리 콘텐츠 예
```
0000_30_machine-api-operator_00_credentials-request.yaml 1
0000_50_cluster-image-registry-operator_01-registry-credentials-request-alibaba.yaml 2
0000_50_cluster-ingress-operator_00-ingress-credentials-request.yaml 3
0000_50_cluster-storage-operator_03_credentials_request_alibaba.yaml 4
```
1
Machine API Operator CR이 필요합니다.
2
Image Registry Operator CR이 필요합니다.
3
Ingress Operator CR이 필요합니다.
4
Storage Operator CR은 선택적 구성 요소이며 클러스터에서 비활성화될 수 있습니다.
ccoctl 툴을 사용하여 redrequests 디렉터리의 모든 CredentialsRequest 오브젝트를 처리합니다.
1. 툴을 사용하려면 다음 명령을 실행합니다.
```
$ ccoctl alibabacloud create-ram-users \
--name <name> \
--region=<alibaba_region> \
--credentials-requests-dir=<path_to_directory_with_list_of_credentials_requests>/credrequests \
--output-dir=<path_to_ccoctl_output_dir>
```
  다음과 같습니다.
  - <name>은 추적을 위해 생성된 클라우드 리소스에 태그를 지정하는 데 사용되는 이름입니다.
  - <alibaba_region>은 클라우드 리소스가 생성될 Alibaba Cloud 지역입니다.
  - <path_to_directory_with_list_of_credentials_requests>/credrequests는 CredentialsRequest 개체의 파일이 포함된 디렉터리입니다.
  - <path_to_ccoctl_output_dir>은 생성된 구성 요소 인증 정보 시크릿을 배치할 디렉터리입니다.
  참고
  클러스터에서 TechPreviewNoUpgrade 기능 세트에서 활성화한 기술 프리뷰 기능을 사용하는 경우 --enable-tech-preview 매개변수를 포함해야 합니다.
  출력 예
```
2022/02/11 16:18:26 Created RAM User: user1-alicloud-openshift-machine-api-alibabacloud-credentials
2022/02/11 16:18:27 Ready for creating new ram policy user1-alicloud-openshift-machine-api-alibabacloud-credentials-policy-policy
2022/02/11 16:18:27 RAM policy user1-alicloud-openshift-machine-api-alibabacloud-credentials-policy-policy has created
2022/02/11 16:18:28 Policy user1-alicloud-openshift-machine-api-alibabacloud-credentials-policy-policy has attached on user user1-alicloud-openshift-machine-api-alibabacloud-credentials
2022/02/11 16:18:29 Created access keys for RAM User: user1-alicloud-openshift-machine-api-alibabacloud-credentials
2022/02/11 16:18:29 Saved credentials configuration to: user1-alicloud/manifests/openshift-machine-api-alibabacloud-credentials-credentials.yaml
...
```
  참고
  RAM 사용자는 두 개의 AccessKey를 동시에 가질 수 있습니다. ccoctl alibabacloud create-ram-users를 두 번 이상 실행하면 이전에 생성된 매니페스트 시크릿이 오래되어 새로 생성된 시크릿을 다시 적용해야 합니다.
2. OpenShift Container Platform 시크릿이 생성되었는지 확인합니다.
```
$ ls <path_to_ccoctl_output_dir>/manifests
```
  출력 예:
```
openshift-cluster-csi-drivers-alibaba-disk-credentials-credentials.yaml
openshift-image-registry-installer-cloud-credentials-credentials.yaml
openshift-ingress-operator-cloud-credentials-credentials.yaml
openshift-machine-api-alibabacloud-credentials-credentials.yaml
```
  Alibaba Cloud를 쿼리하여 RAM 사용자 및 정책의 생성 여부를 확인할 수 있습니다. 자세한 내용은 RAM 사용자 및 정책을 나열에 대한 Alibaba Cloud 문서를 참조하십시오.
생성된 자격 증명 파일을 대상 매니페스트 디렉터리에 복사합니다.
```
$ cp ./<path_to_ccoctl_output_dir>/manifests/*credentials.yaml ./<path_to_installation>dir>/manifests/
```
다음과 같습니다.
<path_to_ccoctl_output_dir>
ccoctl alibabacloud create-ram-users 명령으로 생성된 디렉터리를 지정합니다.
<path_to_installation_dir>
설치 프로그램이 파일을 생성하는 디렉터리를 지정합니다.

3.8. 클러스터 배포

호환되는 클라우드 플랫폼에 OpenShift Container Platform을 설치할 수 있습니다.

중요

최초 설치 과정에서 설치 프로그램의 create cluster 명령을 한 번만 실행할 수 있습니다.

사전 요구 사항

클러스터를 호스팅하는 클라우드 플랫폼으로 계정을 구성합니다.
OpenShift Container Platform 설치 프로그램과 클러스터의 풀 시크릿을 받습니다.
호스트의 클라우드 공급자 계정에 클러스터를 배포할 수 있는 올바른 권한이 있는지 확인합니다. 잘못된 권한이 있는 계정으로 인해 누락된 권한이 표시되는 오류 메시지와 함께 설치 프로세스가 실패합니다.

프로세스

설치 프로그램이 포함된 디렉터리로 변경하고 클러스터 배포를 초기화합니다.
```
$ ./openshift-install create cluster --dir <installation_directory> \ 1
    --log-level=info 2
```
1
<installation_directory> 값으로 사용자 지정한 ./install-config.yaml 파일의 위치를 지정합니다.
2
다른 설치 세부 사항을 보려면 info 대신 warn, debug 또는 error를 지정합니다.
참고
호스트에 구성된 클라우드 공급자 계정에 클러스터를 배포하기에 충분한 권한이 없는 경우, 설치 프로세스가 중단되고 누락된 권한을 알리는 메시지가 표시됩니다.

검증

클러스터 배포가 성공적으로 완료되면 다음을 수행합니다.

터미널에는 웹 콘솔에 대한 링크 및 kubeadmin 사용자의 인증 정보를 포함하여 클러스터에 액세스하는 지침이 표시됩니다.
인증 정보도 < installation_directory>/.openshift_install.log 로 출력합니다.

중요

설치 프로그램 또는 설치 프로그램이 생성하는 파일을 삭제하지 마십시오. 클러스터를 삭제하려면 두 가지가 모두 필요합니다.

출력 예

...
INFO Install complete!
INFO To access the cluster as the system:admin user when using 'oc', run 'export KUBECONFIG=/home/myuser/install_dir/auth/kubeconfig'
INFO Access the OpenShift web-console here: https://console-openshift-console.apps.mycluster.example.com
INFO Login to the console with user: "kubeadmin", and password: "password"
INFO Time elapsed: 36m22s

중요

설치 프로그램에서 생성하는 Ignition 구성 파일에 24시간 후에 만료되는 인증서가 포함되어 있습니다. 이 인증서는 그 후에 갱신됩니다. 인증서를 갱신하기 전에 클러스터가 종료되고 24시간이 지난 후에 클러스터가 다시 시작되면 클러스터는 만료된 인증서를 자동으로 복구합니다. 예외적으로 kubelet 인증서를 복구하려면 대기 중인 node-bootstrapper 인증서 서명 요청(CSR)을 수동으로 승인해야 합니다. 자세한 내용은 만료된 컨트롤 플레인 인증서에서 복구 문서를 참조하십시오.
24 시간 인증서는 클러스터를 설치한 후 16시간에서 22시간으로 인증서가 교체되기 때문에 생성된 후 12시간 이내에 Ignition 구성 파일을 사용하는 것이 좋습니다. 12시간 이내에 Ignition 구성 파일을 사용하면 설치 중에 인증서 업데이트가 실행되는 경우 설치 실패를 방지할 수 있습니다.

3.9. 바이너리를 다운로드하여 OpenShift CLI 설치

명령줄 인터페이스를 사용하여 OpenShift Container Platform과 상호 작용하기 위해 OpenShift CLI(oc)를 설치할 수 있습니다. Linux, Windows 또는 macOS에 oc를 설치할 수 있습니다.

중요

이전 버전의 oc를 설치한 경우, OpenShift Container Platform 4.12의 모든 명령을 완료하는 데 해당 버전을 사용할 수 없습니다. 새 버전의 oc를 다운로드하여 설치합니다.

Linux에서 OpenShift CLI 설치

다음 절차를 사용하여 Linux에서 OpenShift CLI(oc) 바이너리를 설치할 수 있습니다.

프로세스

Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
제품 변형 드롭다운 목록에서 아키텍처를 선택합니다.
버전 드롭다운 목록에서 적절한 버전을 선택합니다.
OpenShift v4.12 Linux Client 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.
아카이브의 압축을 풉니다.
```
$ tar xvf <file>
```
oc 바이너리를 PATH에 있는 디렉터리에 배치합니다.
PATH를 확인하려면 다음 명령을 실행합니다.
```
$ echo $PATH
```

검증

OpenShift CLI를 설치한 후 oc 명령을 사용할 수 있습니다.
```
$ oc <command>
```

Windows에서 OpenSfhit CLI 설치

다음 절차에 따라 Windows에 OpenShift CLI(oc) 바이너리를 설치할 수 있습니다.

프로세스

Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
버전 드롭다운 목록에서 적절한 버전을 선택합니다.
OpenShift v4.12 Windows Client 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.
ZIP 프로그램으로 아카이브의 압축을 풉니다.
oc 바이너리를 PATH에 있는 디렉터리로 이동합니다.
PATH를 확인하려면 명령 프롬프트를 열고 다음 명령을 실행합니다.
```
C:\> path
```

검증

OpenShift CLI를 설치한 후 oc 명령을 사용할 수 있습니다.
```
C:\> oc <command>
```

macOS에 OpenShift CLI 설치

다음 절차에 따라 macOS에서 OpenShift CLI(oc) 바이너리를 설치할 수 있습니다.

프로세스

Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
버전 드롭다운 목록에서 적절한 버전을 선택합니다.
OpenShift v4.12 macOS Client 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.
참고
macOS ARM64의 경우 OpenShift v4.12 macOS ARM64 Client 항목을 선택합니다.
아카이브의 압축을 해제하고 압축을 풉니다.
oc 바이너리 PATH의 디렉터리로 이동합니다.
PATH를 확인하려면 터미널을 열고 다음 명령을 실행합니다.
```
$ echo $PATH
```

검증

OpenShift CLI를 설치한 후 oc 명령을 사용할 수 있습니다.
```
$ oc <command>
```

3.10. CLI를 사용하여 클러스터에 로그인

클러스터 kubeconfig 파일을 내보내서 기본 시스템 사용자로 클러스터에 로그인할 수 있습니다. kubeconfig 파일에는 CLI에서 올바른 클러스터 및 API 서버에 클라이언트를 연결하는 데 사용하는 클러스터에 대한 정보가 포함되어 있습니다. 이 파일은 클러스터별로 고유하며 OpenShift Container Platform 설치 과정에서 생성됩니다.

사전 요구 사항

OpenShift Container Platform 클러스터를 배포했습니다.
oc CLI를 설치했습니다.

프로세스

kubeadmin 인증 정보를 내보냅니다.
```
$ export KUBECONFIG=<installation_directory>/auth/kubeconfig 1
```
1
<installation_directory>는 설치 파일을 저장한 디렉터리의 경로를 지정합니다.
내보낸 구성을 사용하여 oc 명령을 성공적으로 실행할 수 있는지 확인합니다.
```
$ oc whoami
```
출력 예
```
system:admin
```

3.11. 웹 콘솔을 사용하여 클러스터에 로그인

kubeadmin 사용자는 OpenShift Container Platform 설치 후 기본적으로 존재합니다. OpenShift Container Platform 웹 콘솔을 사용하여 kubeadmin 사용자로 클러스터에 로그인할 수 있습니다.

사전 요구 사항

설치 호스트에 대한 액세스 권한이 있어야 합니다.
클러스터 설치를 완료했으며 모든 클러스터 Operator를 사용할 수 있습니다.

프로세스

설치 호스트의 kubeadmin-password 파일에서 kubeadmin 사용자의 암호를 가져옵니다.
```
$ cat <installation_directory>/auth/kubeadmin-password
```
참고
대안으로 설치 호스트의 <installation_directory>/.openshift_install.log 로그 파일에서 kubeadmin 암호를 가져올 수 있습니다.
OpenShift Container Platform 웹 콘솔 경로를 나열합니다.
```
$ oc get routes -n openshift-console | grep 'console-openshift'
```
참고
대안으로 설치 호스트의 <installation_directory>/.openshift_install.log 로그 파일에서 OpenShift Container Platform 경로를 가져올 수 있습니다.
출력 예
```
console     console-openshift-console.apps.<cluster_name>.<base_domain>            console     https   reencrypt/Redirect   None
```
웹 브라우저의 이전 명령 출력에 자세히 설명된 경로로 이동하고 kubeadmin 사용자로 로그인합니다.

3.12. OpenShift Container Platform의 Telemetry 액세스

OpenShift Container Platform 4.12에서 클러스터 상태 및 업데이트 진행에 대한 메트릭을 제공하기 위해 기본적으로 실행되는 Telemetry 서비스에는 인터넷 액세스가 필요합니다. 클러스터가 인터넷에 연결되어 있으면 Telemetry가 자동으로 실행되고 OpenShift Cluster Manager Hybrid Cloud Console 에 클러스터가 등록됩니다.

OpenShift Cluster Manager Hybrid Cloud Console 인벤토리가 올바르거나 OpenShift Cluster Manager를 사용하여 자동으로 또는 OpenShift Cluster Manager를 사용하여 수동으로 유지 관리되는지 확인한 후 subscription watch를 사용하여 계정 또는 다중 클러스터 수준에서 OpenShift Container Platform 서브스크립션을 추적합니다.

추가 리소스

OpenShift Container Platform 웹 콘솔 액세스 및 이해에 대한 자세한 내용은 웹 콘솔 액세스를 참조하십시오.
Telemetry 서비스에 대한 자세한 내용은 원격 상태 모니터링 정보를 참조하십시오.

3.13. 다음 단계

4장. 사용자 지정으로 Alibaba Cloud에 클러스터 설치

OpenShift Container Platform 버전 4.12에서는 설치 프로그램이 Alibaba Cloud에 프로비저닝하는 인프라에 사용자 지정 클러스터를 설치할 수 있습니다. 설치를 사용자 지정하려면 클러스터를 설치하기 전에 install-config.yaml 파일에서 매개변수를 수정합니다.

참고

OpenShift Container Platform 설치 구성의 범위는 의도적으로 한정됩니다. 단순성과 성공을 보장하도록 설계되었습니다. 설치가 완료된 후 많은 추가 OpenShift Container Platform 구성 작업을 완료할 수 있습니다.

중요

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

4.1. 사전 요구 사항

OpenShift Container Platform 설치 및 업데이트 프로세스에 대한 세부 사항을 검토했습니다.
클러스터 설치 방법 선택 및 사용자를 위한 준비에 대한 문서를 읽습니다.
도메인을 등록했습니다.
방화벽을 사용하는 경우 클러스터가 액세스해야 하는 사이트를 허용하도록 방화벽을 구성했습니다.
사용자의 환경에서 Cloud Resource Access Management(RAM) API에 액세스할 수 없거나 kube-system 네임스페이스에 관리자 수준의 인증 정보 시크릿을 저장하지 않으려면 수동으로 리소스 액세스 관리(RAM) 인증 정보를 생성 및 유지 관리할 수 있습니다.

4.2. OpenShift Container Platform 용 인터넷 액세스

OpenShift Container Platform 4.12에서 클러스터를 설치하려면 인터넷 액세스가 필요합니다.

다음의 경우 인터넷 액세스가 필요합니다.

OpenShift Cluster Manager Hybrid Cloud Console 에 액세스하여 설치 프로그램을 다운로드하고 서브스크립션 관리를 수행합니다. 클러스터가 인터넷에 액세스할 수 있고 Telemetry 서비스를 비활성화하지 않은 경우, 클러스터에 자동으로 권한이 부여됩니다.
Quay.io에 액세스. 클러스터를 설치하는 데 필요한 패키지를 받을 수 있습니다.
클러스터 업데이트를 수행하는 데 필요한 패키지를 받을 수 있습니다.

중요

4.3. 클러스터 노드 SSH 액세스를 위한 키 쌍 생성

중요

재해 복구 및 디버깅이 필요한 프로덕션 환경에서는이 단계를 생략하지 마십시오.

참고

AWS 키 쌍과 같이 플랫폼 고유의 방식으로 구성된 키가 아닌 로컬 키를 사용해야 합니다.

프로세스

로컬 시스템에 클러스터 노드의 인증에 사용할 기존 SSH 키 쌍이 없는 경우 새로 생성합니다. 예를 들어 Linux 운영 체제를 사용하는 컴퓨터에서 다음 명령을 실행합니다.
```
$ ssh-keygen -t ed25519 -N '' -f <path>/<file_name> 1
```
1
새 SSH 키의 경로 및 파일 이름(예: ~/.ssh/id_ed25519 )을 지정합니다. 기존 키 쌍이 있는 경우 공개 키가 '~/.ssh 디렉터리에 있는지 확인하십시오.
참고
x86_64,ppc64le, s390x 아키텍처에서 FIPS 검증 또는 진행중인 모듈 In Process 암호화 라이브러리를 사용하는 OpenShift Container Platform 클러스터를 설치하려면 ed25519 알고리즘을 사용하는 키를 생성하지 마십시오. 대신 rsa 또는 ecdsa 알고리즘을 사용하는 키를 생성합니다.
공개 SSH 키를 확인합니다.
```
$ cat <path>/<file_name>.pub
```
예를 들어 다음을 실행하여 ~/.ssh/id_ed25519.pub 공개 키를 확인합니다.
```
$ cat ~/.ssh/id_ed25519.pub
```
아직 추가되지 않은 경우 로컬 사용자의 SSH 에이전트에 SSH 개인 키 ID를 추가합니다. 키의 SSH 에이전트 관리는 클러스터 노드에 암호 없는 SSH 인증을 수행하거나 ./openshift-install gather 명령을 사용하려는 경우 필요합니다.
참고
일부 배포에서는 ~/.ssh/id_rsa 및 ~/.ssh/id_dsa와 같은 기본 SSH 개인 키 ID가 자동으로 관리됩니다.
1. ssh-agent 프로세스가 로컬 사용자에 대해 실행되지 않은 경우 백그라운드 작업으로 시작합니다.
```
$ eval "$(ssh-agent -s)"
```
  출력 예
```
Agent pid 31874
```
  참고
  클러스터가 FIPS 모드인 경우 FIPS 호환 알고리즘만 사용하여 SSH 키를 생성합니다. 키는 RSA 또는 ECDSA여야 합니다.
ssh-agent에 SSH 개인 키를 추가합니다.
```
$ ssh-add <path>/<file_name> 1
```
1
SSH 개인 키의 경로와 파일 이름을 지정합니다(예: ~/.ssh/id_ed25519).
출력 예
```
Identity added: /home/<you>/<path>/<file_name> (<computer_name>)
```

다음 단계

OpenShift Container Platform을 설치할 때 SSH 공개 키를 설치 프로그램에 지정합니다.

4.4. 설치 프로그램 받기

OpenShift Container Platform을 설치하기 전에 설치에 사용하는 호스트에 설치 파일을 다운로드합니다.

사전 요구 사항

500MB의 로컬 디스크 공간이 있는 Linux 또는 macOS를 실행하는 컴퓨터가 있습니다.

프로세스

OpenShift Cluster Manager 사이트의 인프라 공급자 페이지에 액세스합니다. Red Hat 계정이 있으면 사용자 자격 증명으로 로그인합니다. 계정이 없으면 계정을 만드십시오.
인프라 공급자를 선택합니다.
설치 유형 페이지로 이동하여 호스트 운영 체제 및 아키텍처에 해당하는 설치 프로그램을 다운로드하여 설치 구성 파일을 저장할 디렉터리에 파일을 배치합니다.
중요
설치 프로그램은 클러스터를 설치하는 데 사용하는 컴퓨터에 여러 파일을 만듭니다. 클러스터 설치를 마친 후 설치 프로그램과 설치 프로그램으로 생성되는 파일을 보관해야 합니다. 클러스터를 삭제하려면 두 파일이 모두 필요합니다.
중요
클러스터 설치에 실패하거나 설치 프로그램으로 만든 파일을 삭제해도 클러스터는 제거되지 않습니다. 클러스터를 제거하려면 해당 클라우드 공급자에 적용되는 OpenShift Container Platform 설치 제거 절차를 완료해야 합니다.
설치 프로그램 파일의 압축을 풉니다. 예를 들어 Linux 운영 체제를 사용하는 컴퓨터에서 다음 명령을 실행합니다.
```
$ tar -xvf openshift-install-linux.tar.gz
```
Red Hat OpenShift Cluster Manager에서 설치 풀 시크릿을 다운로드합니다. 이 풀 시크릿을 사용하면 OpenShift Container Platform 구성 요소에 대한 컨테이너 이미지를 제공하는 Quay.io를 포함하여 인증 기관에서 제공하는 서비스로 인증할 수 있습니다.

4.4.1. 설치 구성 파일 만들기

vGPU Cloud에 설치하는 OpenShift Container Platform 클러스터를 사용자 지정할 수 있습니다.

사전 요구 사항

OpenShift Container Platform 설치 프로그램과 클러스터의 풀 시크릿을 받습니다.
서브스크립션 수준에서 서비스 권한을 확보합니다.

프로세스

install-config.yaml 파일을 생성합니다.
1. 설치 프로그램이 포함된 디렉터리로 변경하고 다음 명령을 실행합니다.
```
$ ./openshift-install create install-config --dir <installation_directory> 1
```
  1
  <installation_directory>는 설치 프로그램이 생성하는 파일을 저장할 디렉터리 이름을 지정합니다.
  디렉터리를 지정할 때 다음을 수행합니다.
  - 디렉터리에 실행 권한이 있는지 확인합니다. 설치 디렉토리에서 Terraform 바이너리를 실행하려면 이 권한이 필요합니다.
  - 빈 디렉터리를 사용합니다. 부트스트랩 X.509 인증서와 같은 일부 설치 자산은 단기간에 만료되므로 설치 디렉터리를 재사용해서는 안 됩니다. 다른 클러스터 설치의 개별 파일을 재사용하려면 해당 파일을 사용자 디렉터리에 복사하면 됩니다. 그러나 설치 자산의 파일 이름은 릴리스간에 변경될 수 있습니다. 따라서 이전 OpenShift Container Platform 버전에서 설치 파일을 복사할 때는 주의하십시오.
2. 화면에 나타나는 지시에 따라 클라우드에 대한 구성 세부 사항을 입력합니다.
  1. 선택사항: 클러스터 시스템에 액세스하는 데 사용할 SSH 키를 선택합니다.
    참고
    설치 디버깅 또는 재해 복구를 수행하려는 프로덕션 OpenShift Container Platform 클러스터의 경우 ssh-agent 프로세스가 사용하는 SSH 키를 지정합니다.
  2. 대상 플랫폼으로 alibabacloud 를 선택합니다.
  3. 클러스터를 배포할 리전을 선택합니다.
  4. 클러스터를 배포할 기본 도메인을 선택합니다. 기본 도메인은 클러스터용으로 생성한 퍼블릭 DNS 영역에 해당합니다.
  5. 클러스터에 대한 설명이 포함된 이름을 입력합니다.
  6. Red Hat OpenShift Cluster Manager에서 풀 시크릿 을 붙여넣습니다.
RuntimeClass 클라우드에 클러스터를 설치하려면 CCO(Cloud Credential Operator)가 수동 모드에서 작동해야 합니다. install-config.yaml 파일을 수정하여 credentialsMode 매개변수를 Manual 로 설정합니다.
credentialsMode 가 Manual로 설정된 install-config.yaml 구성 파일의 예
```
apiVersion: v1
baseDomain: cluster1.example.com
credentialsMode: Manual 1
compute:
- architecture: amd64
  hyperthreading: Enabled
 ...
```
1
이 행을 추가하여 credentialsMode를 Manual로 설정합니다.
install-config.yaml 파일을 수정합니다. 사용 가능한 매개변수에 대한 자세한 정보는 “설치 구성 매개변수” 섹션에서 확인할 수 있습니다.
여러 클러스터를 설치하는 데 사용할 수 있도록 install-config.yaml 파일을 백업합니다.
중요
install-config.yaml 파일은 설치 과정에서 사용됩니다. 이 파일을 재사용하려면 지금 백업해야 합니다.

4.4.2. 필요한 설치 매니페스트 생성

클러스터가 머신을 구성하는 데 필요한 Kubernetes 매니페스트 및 Ignition 구성 파일을 생성해야 합니다.

프로세스

설치 프로그램이 포함된 디렉터리에서 다음 명령을 실행하여 매니페스트를 생성합니다.
```
$ openshift-install create manifests --dir <installation_directory>
```
다음과 같습니다.
<installation_directory>
설치 프로그램이 파일을 생성하는 디렉터리를 지정합니다.

4.4.3. ccoctl 툴을 사용하여 OpenShift Container Platform 구성 요소의 인증 정보 생성

참고

사전 요구 사항

다음이 있어야 합니다.

ccoctl 바이너리를 추출하여 준비합니다.
OpenShift Container Platform 클러스터를 생성할 수 있는 충분한 권한이 있는 RAM 사용자가 생성되어 있어야 합니다.
해당 RAM 사용자의 AccessKeyID (access_key_id) 및 AccessKeySecret (access_key_secret)을 로컬 컴퓨터의 ~/.alibabacloud/credentials 파일에 추가했습니다.

프로세스

다음 명령을 실행하여 $RELEASE_IMAGE 변수를 설정합니다.

$ RELEASE_IMAGE=$(./openshift-install version | awk '/release image/ {print $3}')

다음 명령을 실행하여 OpenShift Container Platform 릴리스 이미지에서 CredentialsRequest 오브젝트 목록을 추출합니다.
```
$ oc adm release extract \
--credentials-requests \
--cloud=alibabacloud \
--to=<path_to_directory_with_list_of_credentials_requests>/credrequests \ 1
$RELEASE_IMAGE
```
1
credrequests 는 CredentialsRequest 오브젝트 목록이 저장되는 디렉터리입니다. 이 명령은 디렉터리가 없는 경우 해당 디렉터리를 생성합니다.
참고
이 명령을 실행하는 데 시간이 다소 걸릴 수 있습니다.
클러스터에서 클러스터 기능을 사용하여 하나 이상의 선택적 구성 요소를 비활성화하는 경우 비활성화된 구성 요소에 대한 CredentialsRequest 사용자 정의 리소스를 삭제합니다.
Alibaba Cloud에서 OpenShift Container Platform 4.12의 credrequests 디렉터리 콘텐츠 예
```
0000_30_machine-api-operator_00_credentials-request.yaml 1
0000_50_cluster-image-registry-operator_01-registry-credentials-request-alibaba.yaml 2
0000_50_cluster-ingress-operator_00-ingress-credentials-request.yaml 3
0000_50_cluster-storage-operator_03_credentials_request_alibaba.yaml 4
```
1
Machine API Operator CR이 필요합니다.
2
Image Registry Operator CR이 필요합니다.
3
Ingress Operator CR이 필요합니다.
4
Storage Operator CR은 선택적 구성 요소이며 클러스터에서 비활성화될 수 있습니다.
ccoctl 툴을 사용하여 redrequests 디렉터리의 모든 CredentialsRequest 오브젝트를 처리합니다.
1. 툴을 사용하려면 다음 명령을 실행합니다.
```
$ ccoctl alibabacloud create-ram-users \
--name <name> \
--region=<alibaba_region> \
--credentials-requests-dir=<path_to_directory_with_list_of_credentials_requests>/credrequests \
--output-dir=<path_to_ccoctl_output_dir>
```
  다음과 같습니다.
  - <name>은 추적을 위해 생성된 클라우드 리소스에 태그를 지정하는 데 사용되는 이름입니다.
  - <alibaba_region>은 클라우드 리소스가 생성될 Alibaba Cloud 지역입니다.
  - <path_to_directory_with_list_of_credentials_requests>/credrequests는 CredentialsRequest 개체의 파일이 포함된 디렉터리입니다.
  - <path_to_ccoctl_output_dir>은 생성된 구성 요소 인증 정보 시크릿을 배치할 디렉터리입니다.
  참고
  클러스터에서 TechPreviewNoUpgrade 기능 세트에서 활성화한 기술 프리뷰 기능을 사용하는 경우 --enable-tech-preview 매개변수를 포함해야 합니다.
  출력 예
```
2022/02/11 16:18:26 Created RAM User: user1-alicloud-openshift-machine-api-alibabacloud-credentials
2022/02/11 16:18:27 Ready for creating new ram policy user1-alicloud-openshift-machine-api-alibabacloud-credentials-policy-policy
2022/02/11 16:18:27 RAM policy user1-alicloud-openshift-machine-api-alibabacloud-credentials-policy-policy has created
2022/02/11 16:18:28 Policy user1-alicloud-openshift-machine-api-alibabacloud-credentials-policy-policy has attached on user user1-alicloud-openshift-machine-api-alibabacloud-credentials
2022/02/11 16:18:29 Created access keys for RAM User: user1-alicloud-openshift-machine-api-alibabacloud-credentials
2022/02/11 16:18:29 Saved credentials configuration to: user1-alicloud/manifests/openshift-machine-api-alibabacloud-credentials-credentials.yaml
...
```
  참고
  RAM 사용자는 두 개의 AccessKey를 동시에 가질 수 있습니다. ccoctl alibabacloud create-ram-users를 두 번 이상 실행하면 이전에 생성된 매니페스트 시크릿이 오래되어 새로 생성된 시크릿을 다시 적용해야 합니다.
2. OpenShift Container Platform 시크릿이 생성되었는지 확인합니다.
```
$ ls <path_to_ccoctl_output_dir>/manifests
```
  출력 예:
```
openshift-cluster-csi-drivers-alibaba-disk-credentials-credentials.yaml
openshift-image-registry-installer-cloud-credentials-credentials.yaml
openshift-ingress-operator-cloud-credentials-credentials.yaml
openshift-machine-api-alibabacloud-credentials-credentials.yaml
```
  Alibaba Cloud를 쿼리하여 RAM 사용자 및 정책의 생성 여부를 확인할 수 있습니다. 자세한 내용은 RAM 사용자 및 정책을 나열에 대한 Alibaba Cloud 문서를 참조하십시오.
생성된 자격 증명 파일을 대상 매니페스트 디렉터리에 복사합니다.
```
$ cp ./<path_to_ccoctl_output_dir>/manifests/*credentials.yaml ./<path_to_installation>dir>/manifests/
```
다음과 같습니다.
<path_to_ccoctl_output_dir>
ccoctl alibabacloud create-ram-users 명령으로 생성된 디렉터리를 지정합니다.
<path_to_installation_dir>
설치 프로그램이 파일을 생성하는 디렉터리를 지정합니다.

4.4.4. 설치 구성 매개변수

OpenShift Container Platform 클러스터를 배포하기 전에 매개변수 값을 제공하여 클러스터를 호스팅할 클라우드 플랫폼에서 사용자 계정을 설명하고 선택사항으로 클러스터의 플랫폼을 사용자 지정합니다. install-config.yaml 설치 구성 파일을 생성할 때 명령줄을 통해 필요한 매개변수 값을 제공합니다. 클러스터를 사용자 지정하면 install-config.yaml 파일을 수정하여 플랫폼에 대한 세부 정보를 제공할 수 있습니다.

참고

설치한 후에는 install-config.yaml 파일에서 이러한 매개변수를 수정할 수 없습니다.

4.4.4.1. 필수 구성 매개변수

필수 설치 구성 매개변수는 다음 표에 설명되어 있습니다.

표 4.1. 필수 매개 변수
매개변수	설명	값
`apiVersion`	`install-config.yaml` 콘텐츠의 API 버전입니다. 현재 버전은 `v1`입니다. 설치 프로그램에서 이전 API 버전도 지원할 수 있습니다.	문자열
`baseDomain`	클라우드 공급자의 기본 도메인입니다. 기본 도메인은 OpenShift Container Platform 클러스터 구성 요소에 대한 경로를 생성하는 데 사용됩니다. 클러스터의 전체 DNS 이름은 `baseDomain`과 `metadata.name` 매개변수 값의 조합으로, `<metadata.name>.<baseDomain>` 형식입니다.	정규화된 도메인 또는 하위 도메인 이름(예: `example.com`).
`metadata`	Kubernetes 리소스 `ObjectMeta`로 `name` 매개변수만 사용합니다.	개체
`metadata.name`	클러스터의 이름입니다. 클러스터의 DNS 레코드는 `{{.metadata.name}}.{{. baseDomain}}` 형식의 모든 하위 도메인입니다.	소문자, 하이픈(`-`), 마침표(`.`)로 구성되는 문자열(예: `dev`)입니다.
`platform`	설치를 수행할 특정 플랫폼에 대한 구성: `alibabacloud`,aws ,`baremetal`,`azure`,`gcp`,`ibmcloud`,`nutanix`,`openstack`,`ovirt`,`vsphere`, `{}`. `platform.<platform>` 매개변수에 대한 자세한 내용은 다음 표에서 사용자 플랫폼에 해당하는 정보를 참조하십시오.	개체
`pullSecret`	Red Hat OpenShift Cluster Manager에서 풀 시크릿을 가져와서 Quay.io와 같은 서비스에서 OpenShift Container Platform 구성 요소의 컨테이너 이미지 다운로드를 인증합니다.	{ "auths":{ "cloud.openshift.com":{ "auth":"b3Blb=", "email":"you@example.com" }, "quay.io":{ "auth":"b3Blb=", "email":"you@example.com" } } }

4.4.4.2. 네트워크 구성 매개변수

기존 네트워크 인프라의 요구 사항에 따라 설치 구성을 사용자 지정할 수 있습니다. 예를 들어 클러스터 네트워크의 IP 주소 블록을 확장하거나 기본값과 다른 IP 주소 블록을 제공할 수 있습니다.

IPv4 주소만 지원됩니다.

참고

Red Hat OpenShift Data Foundation 재해 복구 솔루션에서는 Globalnet이 지원되지 않습니다. 지역 재해 복구 시나리오의 경우 각 클러스터의 클러스터 및 서비스 네트워크에 대해 겹치지 않는 개인 IP 주소를 사용해야 합니다.

표 4.2. 네트워크 매개변수
매개변수	설명	값
`networking`	클러스터의 네트워크의 구성입니다.	개체 참고 설치한 후에는 `networking` 오브젝트에서 지정된 매개변수를 수정할 수 없습니다.
`networking.networkType`	설치할 Red Hat OpenShift Networking 네트워크 플러그인입니다.	`OpenShiftSDN` 또는 `OVNKubernetes` 중 하나이며, `OpenShiftSDN` 은 모든 Linux 네트워크를 위한 CNI 플러그인입니다. `OVNKubernetes` 는 Linux 네트워크 및 하이브리드 네트워크용 CNI 플러그인으로, Linux 및 Windows 서버가 모두 포함됩니다. 기본값은 `OVNKubernetes` 입니다.
`networking.clusterNetwork`	Pod의 IP 주소 블록입니다. 기본값은 `10.128.0.0/14`이며, 호스트 접두사는 `/23`입니다. 여러 IP 주소 블록을 지정하는 경우 블록이 겹치지 않아야 합니다.	개체의 배열입니다. 예를 들면 다음과 같습니다. networking: clusterNetwork: - cidr: 10.128.0.0/14 hostPrefix: 23
`networking.clusterNetwork.cidr`	`networking.clusterNetwork`를 사용하는 경우 필수 항목입니다. IP 주소 블록입니다. IPv4 네트워크입니다.	CIDR(Classless Inter-Domain Routing) 표기법의 IP 주소 블록입니다. IPv4 블록의 접두사 길이는 `0` 에서 `32` 사이입니다.
`networking.clusterNetwork.hostPrefix`	개별 노드 각각에 할당할 서브넷 접두사 길이입니다. 예를 들어 `hostPrefix`를 `23`으로 설정하는 경우, 지정된 `cidr` 이외 `/23` 서브넷이 각 노드에 할당됩니다. `23`의 `hostPrefix` 값은 510(2^(32 - 23) - 2) Pod IP 주소를 제공합니다.	서브넷 접두사입니다. 기본값은 `23`입니다.
`networking.serviceNetwork`	서비스의 IP 주소 블록입니다. 기본값은 `172.30.0.0/16`입니다. OpenShift SDN 및 OVN-Kubernetes 네트워크 플러그인은 서비스 네트워크에 대한 단일 IP 주소 블록만 지원합니다.	CIDR 형식의 IP 주소 블록이 있는 어레이입니다. 예를 들면 다음과 같습니다. networking: serviceNetwork: - 172.30.0.0/16
`networking.machineNetwork`	시스템의 IP 주소 블록입니다. 여러 IP 주소 블록을 지정하는 경우 블록이 겹치지 않아야 합니다.	개체의 배열입니다. 예를 들면 다음과 같습니다. networking: machineNetwork: - cidr: 10.0.0.0/16
`networking.machineNetwork.cidr`	`networking.machineNetwork`를 사용하는 경우 필수 항목입니다. IP 주소 블록입니다. libvirt를 제외한 모든 플랫폼의 기본값은 `10.0.0.0/16`입니다. libvirt의 기본값은 `192.168.126.0/24`입니다.	CIDR 표기법의 IP 네트워크 블록입니다. 예: `10.0.0.0/16` 참고 기본 NIC가 상주하는 CIDR과 일치하도록 `networking.machineNetwork`를 설정합니다.

4.4.4.3. 선택적 구성 매개변수

선택적 설치 구성 매개변수는 다음 표에 설명되어 있습니다.

표 4.3. 선택적 매개변수
매개변수	설명	값
`additionalTrustBundle`	노드의 신뢰할 수 있는 인증서 스토리지에 추가되는 PEM 인코딩 X.509 인증서 번들입니다. 이 신뢰할 수 있는 번들은 프록시가 구성되었을 때에도 사용할 수 있습니다.	문자열
`capabilities`	선택적 핵심 클러스터 구성 요소의 설치를 제어합니다. 선택적 구성 요소를 비활성화하여 OpenShift Container Platform 클러스터의 설치 공간을 줄일 수 있습니다. 자세한 내용은 설치 의 "클러스터 기능" 페이지를 참조하십시오.	문자열 배열
`capabilities.baselineCapabilitySet`	활성화할 선택적 기능 세트를 선택합니다. 유효한 값은 `None`,`v4.11`,`v4.12` 및 `v Current` 입니다. 기본값은 `v current입니다`.	문자열
`capabilities.additionalEnabledCapabilities`	`baselineCapabilitySet` 에서 지정한 것 이상으로 선택적 기능 세트를 확장합니다. 이 매개변수에서 여러 기능을 지정할 수 있습니다.	문자열 배열
`compute`	컴퓨팅 노드를 구성하는 시스템의 구성입니다.	`MachinePool` 개체의 배열입니다.
`compute.architecture`	풀에 있는 시스템의 명령어 집합 아키텍처를 결정합니다. 현재 다양한 아키텍처가 있는 클러스터는 지원되지 않습니다. 모든 풀은 동일한 아키텍처를 지정해야 합니다. 유효한 값은 `amd64`(기본값)입니다.	문자열
`compute.hyperthreading`	컴퓨팅 시스템에서 동시 멀티스레딩 또는 `hyperthreading` 활성화 또는 비활성화 여부를 지정합니다. 시스템 코어의 성능을 높이기 위해 기본적으로 동시 멀티스레딩이 활성화됩니다. 중요 동시 멀티스레딩을 비활성화하는 경우 용량 계획에서 시스템 성능이 크게 저하될 수 있는 문제를 고려해야 합니다.	`Enabled` 또는 `Disabled`
`compute.name`	`compute`를 사용하는 경우 필수 항목입니다. 시스템 풀의 이름입니다.	`worker`
`compute.platform`	`compute`를 사용하는 경우 필수 항목입니다. 이 매개변수를 사용하여 작업자 시스템을 호스팅할 클라우드 공급자를 지정합니다. 이 매개변수 값은 `controlPlane.platform` 매개변수 값과 일치해야 합니다	`alibabacloud`,`aws`,`azure`,`gcp`,`ibmcloud`,`nutanix`,`openstack`,`ovirt`,`vsphere`, `{}`
`compute.replicas`	프로비저닝할 컴퓨팅 시스템(작업자 시스템이라고도 함) 수입니다.	`2` 이상의 양의 정수이며, 기본값은 `3`입니다.
`featureSet`	기능 세트를 위한 클러스터를 활성화합니다. 기능 세트는 기본적으로 활성화되어 있지 않은 OpenShift Container Platform 기능 컬렉션입니다. 설치 중에 기능 세트를 활성화하는 방법에 대한 자세한 내용은 "기능 게이트를 사용하여 기능 활성화"를 참조하십시오.	문자열. `TechPreviewNoUpgrade` 와 같이 활성화할 기능 세트의 이름입니다.
`controlPlane`	컨트롤 플레인을 구성하는 시스템들의 구성입니다.	`MachinePool` 개체의 배열입니다.
`controlPlane.architecture`	풀에 있는 시스템의 명령어 집합 아키텍처를 결정합니다. 현재 다양한 아키텍처가 있는 클러스터는 지원되지 않습니다. 모든 풀은 동일한 아키텍처를 지정해야 합니다. 유효한 값은 `amd64`(기본값)입니다.	문자열
`controlPlane.hyperthreading`	컨트롤 플레인 시스템에서 동시 멀티스레딩 또는 `hyperthreading` 활성화 또는 비활성화 여부를 지정합니다. 시스템 코어의 성능을 높이기 위해 기본적으로 동시 멀티스레딩이 활성화됩니다. 중요 동시 멀티스레딩을 비활성화하는 경우 용량 계획에서 시스템 성능이 크게 저하될 수 있는 문제를 고려해야 합니다.	`Enabled` 또는 `Disabled`
`controlPlane.name`	`controlPlane`을 사용하는 경우 필수 항목입니다. 시스템 풀의 이름입니다.	`master`
`controlPlane.platform`	`controlPlane`을 사용하는 경우 필수 항목입니다. 이 매개변수를 사용하여 컨트롤 플레인 시스템을 호스팅하는 클라우드 공급자를 지정합니다. 이 매개변수 값은 `compute.platform` 매개변수 값과 일치해야 합니다.	`alibabacloud`,`aws`,`azure`,`gcp`,`ibmcloud`,`nutanix`,`openstack`,`ovirt`,`vsphere`, `{}`
`controlPlane.replicas`	프로비저닝하는 컨트롤 플레인 시스템의 수입니다.	지원되는 유일한 값은 기본값인 `3`입니다.
`credentialsMode`	Cloud Credential Operator (CCO) 모드입니다. 모드가 지정되지 않은 경우 CCO는 여러 모드가 지원되는 플랫폼에서 Mint 모드가 우선으로 되어 지정된 인증 정보의 기능을 동적으로 확인하려고합니다. 참고 모든 클라우드 공급자에서 모든 CCO 모드가 지원되는 것은 아닙니다. CCO 모드에 대한 자세한 내용은 Cluster Operators 참조 콘텐츠의 Cloud Credential Operator 항목을 참조하십시오. 참고 AWS 계정에 서비스 제어 정책(SCP)이 활성화된 경우 `credentialsMode` 매개변수를 `Mint`,`Passthrough` 또는 `Manual` 로 구성해야 합니다.	`Mint`,`Passthrough`,`Manual` 또는 빈 문자열(`""`)
`fips`	FIPS 모드를 활성화 또는 비활성화합니다. 기본값은 `false`(비활성화)입니다. FIPS 모드가 활성화되면 OpenShift Container Platform이 실행되는 RHCOS(Red Hat Enterprise Linux CoreOS) 시스템에서 기본 Kubernetes 암호화 제품군은 우회하고 RHCOS와 함께 제공되는 암호화 모듈을 대신 사용합니다. 중요 클러스터의 FIPS 모드를 활성화하려면 FIPS 모드에서 작동하도록 구성된 RHEL(Red Hat Enterprise Linux) 컴퓨터에서 설치 프로그램을 실행해야 합니다. RHEL에서 FIPS 모드 구성에 대한 자세한 내용은 FIPS 모드에서 시스템 설치를 참조하십시오. FIPS 검증 또는 모듈 In Process 암호화 라이브러리 사용은 `x86_64`,`ppc64le` 및 `s390x` 아키텍처의 OpenShift Container Platform 배포에서만 지원됩니다. 참고 Azure File 스토리지를 사용하는 경우 FIPS 모드를 활성화할 수 없습니다.	`false` 또는 `true`
`imageContentSources`	릴리스 이미지 내용의 소스 및 리포지토리입니다.	개체의 배열입니다. 이 표의 다음 행에 설명된 대로 `source`와 `mirrors`(선택사항)가 포함됩니다.
`imageContentSources.source`	`imageContentSources`를 사용하는 경우 필수 항목입니다. 예를 들어 이미지 가져오기 사양에서 사용자가 가리키는 리포지토리를 지정합니다.	문자열
`imageContentSources.mirrors`	동일한 이미지를 포함할 수도 있는 하나 이상의 리포지토리를 지정합니다.	문자열 배열
`publish`	Kubernetes API, OpenShift 경로와 같이 클러스터의 사용자 끝점을 게시하거나 노출하는 방법입니다.	`Internal` 또는 `External`입니다. 기본값은 `External`입니다. 이 필드를 `Internal` 로 설정하는 것은 클라우드 이외의 플랫폼에서는 지원되지 않습니다. 중요 필드 값을 `Internal` 로 설정하면 클러스터가 작동하지 않습니다. 자세한 내용은 BZ#1953035를 참조하십시오.
`sshKey`	클러스터 시스템에 대한 액세스를 인증하는 SSH 키입니다. 참고 설치 디버깅 또는 재해 복구를 수행하려는 프로덕션 OpenShift Container Platform 클러스터의 경우 `ssh-agent` 프로세스가 사용하는 SSH 키를 지정합니다.	예를 들어 `sshKey: ssh-ed25519 AAAA`...

4.4.4.4. 추가 Alibaba Cloud 구성 매개변수

추가 Alibaba Cloud 구성 매개변수는 다음 표에 설명되어 있습니다. alibabacloud 매개변수는 Alibaba Cloud에 설치할 때 사용되는 구성입니다. defaultMachinePlatform 매개변수는 자체 플랫폼 구성을 정의하지 않는 머신 풀에 대해 Alibaba Cloud에 설치할 때 사용되는 기본 구성입니다.

이러한 매개변수는 지정된 컴퓨팅 머신 및 컨트롤 플레인 시스템에 모두 적용됩니다.

참고

정의된 경우 compute.platform.alibabacloud 및 controlPlane.platform.alibabacloud 매개변수는 각각 컴퓨팅 머신 및 컨트롤 플레인 시스템의 platform.alibacloud.defaultMachinePlatform 설정을 덮어씁니다.

표 4.4. 선택 사항 Alibaba Cloud 매개변수
매개변수	설명	값
`compute.platform.alibabacloud.imageID`	ECS 인스턴스를 생성하는 데 사용되는 imageID입니다. ImageId는 클러스터와 동일한 리전에 속해야 합니다.	문자열.
`compute.platform.alibabacloud.instanceType`	instanceType은 ECS 인스턴스 유형을 정의합니다. 예: `ecs.g6.large`	문자열.
`compute.platform.alibabacloud.systemDiskCategory`	시스템 디스크의 범주를 정의합니다. 예: `cloud_efficiency`,`cloud_essd`	문자열.
`compute.platform.alibabacloud.systemDisksize`	시스템 디스크의 크기를 기가바이트(GiB)로 정의합니다.	정수.
`compute.platform.alibabacloud.zones`	사용할 수 있는 가용성 영역 목록입니다. 예: `cn-hangzhou-h` `cn-hangzhou-j`	문자열 목록.
`controlPlane.platform.alibabacloud.imageID`	ECS 인스턴스를 생성하는 데 사용되는 imageID입니다. ImageId는 클러스터와 동일한 리전에 속해야 합니다.	문자열.
`controlPlane.platform.alibabacloud.instanceType`	instanceType은 ECS 인스턴스 유형을 정의합니다. 예: `ecs.g6.xlarge`	문자열.
`controlPlane.platform.alibabacloud.systemDiskCategory`	시스템 디스크의 범주를 정의합니다. 예: `cloud_efficiency`,`cloud_essd`	문자열.
`controlPlane.platform.alibabacloud.systemDisksize`	시스템 디스크의 크기를 기가바이트(GiB)로 정의합니다.	정수.
`controlPlane.platform.alibabacloud.zones`	사용할 수 있는 가용성 영역 목록입니다. 예: `cn-hangzhou-h` `cn-hangzhou-j`	문자열 목록.
`platform.alibabacloud.region`	필수 항목입니다. 클러스터가 생성될 Alibaba Cloud 리전입니다.	문자열.
`platform.alibabacloud.resourceGroupID`	클러스터가 설치될 이미 존재하는 리소스 그룹의 ID입니다. 비어 있는 경우 설치 프로그램에서 클러스터에 대한 새 리소스 그룹을 생성합니다.	문자열.
`platform.alibabacloud.tags`	클러스터에 대해 생성된 모든 Alibaba Cloud 리소스에 적용되는 추가 키와 값입니다.	개체.
`platform.alibabacloud.vpcID`	클러스터를 설치해야 하는 기존 VPC의 ID입니다. 비어 있는 경우 설치 프로그램은 클러스터에 대한 새 VPC를 생성합니다.	문자열.
`platform.alibabacloud.vswitchIDs`	클러스터 리소스가 생성될 기존 VSwitch의 ID 목록입니다. 기존 VSwitch는 기존 VPC를 사용하는 경우에만 사용할 수 있습니다. 비어 있는 경우 설치 프로그램에서 클러스터에 대한 새 VSwitch를 만듭니다.	문자열 목록.
`platform.alibabacloud.defaultMachinePlatform.imageID`	컴퓨팅 시스템 및 컨트롤 플레인 시스템 모두에서 ECS 인스턴스를 생성하는 데 사용해야 하는 이미지 ID입니다. 설정된 경우 이미지 ID는 클러스터와 동일한 리전에 속해야 합니다.	문자열.
`platform.alibabacloud.defaultMachinePlatform.instanceType`	컴퓨팅 시스템 및 컨트롤 플레인 시스템 모두에서 ECS 인스턴스를 생성하는 데 사용되는 ECS 인스턴스 유형입니다. 예: `ecs.g6.xlarge`	문자열.
`platform.alibabacloud.defaultMachinePlatform.systemDiskCategory`	컴퓨팅 시스템 및 컨트롤 플레인 시스템의 경우 시스템 디스크의 범주입니다. 예: `cloud_efficiency`,`cloud_essd`.	문자열(예: "", `cloud_efficiency`,`cloud_essd` ).
`platform.alibabacloud.defaultMachinePlatform.systemDiskSize`	컴퓨팅 시스템 및 컨트롤 플레인 시스템의 경우 시스템 디스크 크기(GiB)입니다. 최소는 `120` 입니다.	정수.
`platform.alibabacloud.defaultMachinePlatform.zones`	컴퓨팅 시스템 및 컨트롤 플레인 시스템 모두 사용할 수 있는 가용성 영역 목록입니다. 예: `cn-hangzhou-h` `cn-hangzhou-j`	문자열 목록.
`platform.alibabacloud.privateZoneID`	클러스터의 내부 API에 대한 DNS 레코드를 추가할 기존 프라이빗 영역의 ID입니다. 기존 프라이빗 영역은 기존 VPC를 사용하는 경우에만 사용할 수 있습니다. 프라이빗 영역은 서브넷이 포함된 VPC와 연결되어 있어야 합니다. 설치 프로그램이 사용자를 대신하여 프라이빗 영역을 생성하도록 프라이빗 영역을 설정되지 않은 상태로 둡니다.	문자열.

4.4.5. Alibaba Cloud에 대한 샘플 사용자 지정 install-config.yaml 파일

설치 구성 파일(install-config.yaml)을 사용자 지정하여 클러스터 플랫폼에 대한 자세한 정보를 지정하거나 필수 매개변수 값을 수정할 수 있습니다.

apiVersion: v1
baseDomain: alicloud-dev.devcluster.openshift.com
credentialsMode: Manual
compute:
- architecture: amd64
  hyperthreading: Enabled
  name: worker
  platform: {}
  replicas: 3
controlPlane:
  architecture: amd64
  hyperthreading: Enabled
  name: master
  platform: {}
  replicas: 3
metadata:
  creationTimestamp: null
  name: test-cluster 1
 networking:
  clusterNetwork:
  - cidr: 10.128.0.0/14
    hostPrefix: 23
  machineNetwork:
  - cidr: 10.0.0.0/16
  networkType: OVNKubernetes 2
  serviceNetwork:
  - 172.30.0.0/16
platform:
  alibabacloud:
    defaultMachinePlatform: 3
      instanceType: ecs.g6.xlarge
      systemDiskCategory: cloud_efficiency
      systemDiskSize: 200
    region: ap-southeast-1 4
    resourceGroupID: rg-acfnw6j3hyai 5
    vpcID: vpc-0xifdjerdibmaqvtjob2b 6
    vswitchIDs: 7
    - vsw-0xi8ycgwc8wv5rhviwdq5
    - vsw-0xiy6v3z2tedv009b4pz2
publish: External
pullSecret: '{"auths": {"cloud.openshift.com": {"auth": ... }' 8
sshKey: |
  ssh-rsa AAAA... 9

1: 필수 항목입니다. 설치 프로그램에서 클러스터 이름을 입력하라는 메시지를 표시합니다.
2: 설치할 클러스터 네트워크 플러그인입니다. 지원되는 값은 OVNKubernetes 및 OpenShiftSDN 입니다. 기본값은 OVNKubernetes 입니다.
3: 선택 사항: 자체 플랫폼 구성을 정의하지 않는 머신 풀에 대한 매개변수를 지정합니다.
4: 필수 항목입니다. 설치 프로그램에서 클러스터를 배포할 리전을 묻는 메시지를 표시합니다.
5: 선택 사항: 클러스터를 설치해야 하는 기존 리소스 그룹을 지정합니다.
8: 필수 항목입니다. 설치 프로그램에서 가져오기 시크릿을 묻는 메시지를 표시합니다.
9: 선택 사항: 설치 프로그램에서 클러스터의 시스템에 액세스하는 데 사용하는 SSH 키 값을 입력하라는 메시지를 표시합니다.
6 7: 선택 사항: 다음은 예제 vswitchID 값입니다.

4.4.6. 설치 중 클러스터 단위 프록시 구성

프로덕션 환경에서는 인터넷에 대한 직접 액세스를 거부하고 대신 HTTP 또는 HTTPS 프록시를 사용할 수 있습니다. install-config.yaml 파일에서 프록시 설정을 구성하여 프록시가 사용되도록 새 OpenShift Container Platform 클러스터를 구성할 수 있습니다.

사전 요구 사항

기존 install-config.yaml 파일이 있습니다.
클러스터에서 액세스해야 하는 사이트를 검토하고 프록시를 바이패스해야 하는지 확인했습니다. 기본적으로 호스팅 클라우드 공급자 API에 대한 호출을 포함하여 모든 클러스터 발신(Egress) 트래픽이 프록시됩니다. 필요한 경우 프록시를 바이패스하기 위해 Proxy 오브젝트의 spec.noProxy 필드에 사이트를 추가했습니다.
참고
Proxy 오브젝트의 status.noProxy 필드는 설치 구성에 있는 networking.machineNetwork[].cidr, networking.clusterNetwork[].cidr, networking.serviceNetwork[] 필드의 값으로 채워집니다.
Amazon Web Services (AWS), Google Cloud Platform (GCP), Microsoft Azure 및 Red Hat OpenStack Platform (RHOSP)에 설치하는 경우 Proxy 오브젝트 status.noProxy 필드도 인스턴스 메타데이터 끝점(169.254.169.254)로 채워집니다.

프로세스

install-config.yaml 파일을 편집하고 프록시 설정을 추가합니다. 예를 들면 다음과 같습니다.
```
apiVersion: v1
baseDomain: my.domain.com
proxy:
  httpProxy: http://<username>:<pswd>@<ip>:<port> 1
  httpsProxy: https://<username>:<pswd>@<ip>:<port> 2
  noProxy: example.com 3
additionalTrustBundle: | 4
    -----BEGIN CERTIFICATE-----
    <MY_TRUSTED_CA_CERT>
    -----END CERTIFICATE-----
additionalTrustBundlePolicy: <policy_to_add_additionalTrustBundle> 5
```
1
클러스터 외부에서 HTTP 연결을 구축하는 데 사용할 프록시 URL입니다. URL 스키마는 http여야 합니다.
2
클러스터 외부에서 HTTPS 연결을 구축하는 데 사용할 프록시 URL입니다.
3
대상 도메인 이름, IP 주소 또는 프록시에서 제외할 기타 네트워크 CIDR로 이루어진 쉼표로 구분된 목록입니다. 하위 도메인과 일치하려면 도메인 앞에 .을 입력합니다. 예를 들어, .y.com은 x.y.com과 일치하지만 y.com은 일치하지 않습니다. *를 사용하여 모든 대상에 대해 프록시를 바이패스합니다.
4
이 값을 제공하면 설치 프로그램에서 HTTPS 연결을 프록시하는 데 필요한 추가 CA 인증서가 하나 이상 포함된 openshift-config 네임스페이스에 user-ca-bundle이라는 이름으로 구성 맵을 생성합니다. 그러면 CNO(Cluster Network Operator)에서 이러한 콘텐츠를 RHCOS(Red Hat Enterprise Linux CoreOS) 신뢰 번들과 병합하는 trusted-ca-bundle 구성 맵을 생성합니다. 이 구성 맵은 Proxy 오브젝트의 trustedCA 필드에서 참조됩니다. 프록시의 ID 인증서를 RHCOS 트러스트 번들에 있는 기관에서 서명하지 않은 경우 additionalTrustBundle 필드가 있어야 합니다.
5
선택 사항: trustedCA 필드에서 user-ca-bundle 구성 맵을 참조할 프록시 오브젝트의 구성을 결정하는 정책입니다. 허용되는 값은 Proxyonly 및 Always 입니다. http/https 프록시가 구성된 경우에만 user-ca-bundle 구성 맵을 참조하려면 Proxyonly 를 사용합니다. Always 를 사용하여 user-ca-bundle 구성 맵을 항상 참조합니다. 기본값은 Proxyonly 입니다.
참고
설치 프로그램에서 프록시 adinessEndpoints 필드를 지원하지 않습니다.
참고
설치 프로그램이 시간 초과되면 설치 프로그램의 wait-for 명령을 사용하여 배포를 다시 시작한 다음 완료합니다. 예를 들면 다음과 같습니다.
```
$ ./openshift-install wait-for install-complete --log-level debug
```
파일을 저장해 놓고 OpenShift Container Platform을 설치할 때 참조하십시오.

제공되는 install-config.yaml 파일의 프록시 설정을 사용하는 cluster라는 이름의 클러스터 전체 프록시가 설치 프로그램에 의해 생성됩니다. 프록시 설정을 제공하지 않아도 cluster Proxy 오브젝트는 계속 생성되지만 spec은 nil이 됩니다.

참고

cluster라는 Proxy 오브젝트만 지원되며 추가 프록시는 생성할 수 없습니다.

4.5. 클러스터 배포

호환되는 클라우드 플랫폼에 OpenShift Container Platform을 설치할 수 있습니다.

중요

최초 설치 과정에서 설치 프로그램의 create cluster 명령을 한 번만 실행할 수 있습니다.

사전 요구 사항

클러스터를 호스팅하는 클라우드 플랫폼으로 계정을 구성합니다.
OpenShift Container Platform 설치 프로그램과 클러스터의 풀 시크릿을 받습니다.
호스트의 클라우드 공급자 계정에 클러스터를 배포할 수 있는 올바른 권한이 있는지 확인합니다. 잘못된 권한이 있는 계정으로 인해 누락된 권한이 표시되는 오류 메시지와 함께 설치 프로세스가 실패합니다.

프로세스

설치 프로그램이 포함된 디렉터리로 변경하고 클러스터 배포를 초기화합니다.
```
$ ./openshift-install create cluster --dir <installation_directory> \ 1
    --log-level=info 2
```
1
<installation_directory> 값으로 사용자 지정한 ./install-config.yaml 파일의 위치를 지정합니다.
2
다른 설치 세부 사항을 보려면 info 대신 warn, debug 또는 error를 지정합니다.
참고
호스트에 구성된 클라우드 공급자 계정에 클러스터를 배포하기에 충분한 권한이 없는 경우, 설치 프로세스가 중단되고 누락된 권한을 알리는 메시지가 표시됩니다.

검증

클러스터 배포가 성공적으로 완료되면 다음을 수행합니다.

터미널에는 웹 콘솔에 대한 링크 및 kubeadmin 사용자의 인증 정보를 포함하여 클러스터에 액세스하는 지침이 표시됩니다.
인증 정보도 < installation_directory>/.openshift_install.log 로 출력합니다.

중요

설치 프로그램 또는 설치 프로그램이 생성하는 파일을 삭제하지 마십시오. 클러스터를 삭제하려면 두 가지가 모두 필요합니다.

출력 예

...
INFO Install complete!
INFO To access the cluster as the system:admin user when using 'oc', run 'export KUBECONFIG=/home/myuser/install_dir/auth/kubeconfig'
INFO Access the OpenShift web-console here: https://console-openshift-console.apps.mycluster.example.com
INFO Login to the console with user: "kubeadmin", and password: "password"
INFO Time elapsed: 36m22s

중요

설치 프로그램에서 생성하는 Ignition 구성 파일에 24시간 후에 만료되는 인증서가 포함되어 있습니다. 이 인증서는 그 후에 갱신됩니다. 인증서를 갱신하기 전에 클러스터가 종료되고 24시간이 지난 후에 클러스터가 다시 시작되면 클러스터는 만료된 인증서를 자동으로 복구합니다. 예외적으로 kubelet 인증서를 복구하려면 대기 중인 node-bootstrapper 인증서 서명 요청(CSR)을 수동으로 승인해야 합니다. 자세한 내용은 만료된 컨트롤 플레인 인증서에서 복구 문서를 참조하십시오.
24 시간 인증서는 클러스터를 설치한 후 16시간에서 22시간으로 인증서가 교체되기 때문에 생성된 후 12시간 이내에 Ignition 구성 파일을 사용하는 것이 좋습니다. 12시간 이내에 Ignition 구성 파일을 사용하면 설치 중에 인증서 업데이트가 실행되는 경우 설치 실패를 방지할 수 있습니다.

4.6. 바이너리를 다운로드하여 OpenShift CLI 설치

중요

Linux에서 OpenShift CLI 설치

다음 절차를 사용하여 Linux에서 OpenShift CLI(oc) 바이너리를 설치할 수 있습니다.

프로세스

Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
제품 변형 드롭다운 목록에서 아키텍처를 선택합니다.
버전 드롭다운 목록에서 적절한 버전을 선택합니다.
OpenShift v4.12 Linux Client 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.
아카이브의 압축을 풉니다.
```
$ tar xvf <file>
```
oc 바이너리를 PATH에 있는 디렉터리에 배치합니다.
PATH를 확인하려면 다음 명령을 실행합니다.
```
$ echo $PATH
```

검증

OpenShift CLI를 설치한 후 oc 명령을 사용할 수 있습니다.
```
$ oc <command>
```

Windows에서 OpenSfhit CLI 설치

다음 절차에 따라 Windows에 OpenShift CLI(oc) 바이너리를 설치할 수 있습니다.

프로세스

Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
버전 드롭다운 목록에서 적절한 버전을 선택합니다.
OpenShift v4.12 Windows Client 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.
ZIP 프로그램으로 아카이브의 압축을 풉니다.
oc 바이너리를 PATH에 있는 디렉터리로 이동합니다.
PATH를 확인하려면 명령 프롬프트를 열고 다음 명령을 실행합니다.
```
C:\> path
```

검증

OpenShift CLI를 설치한 후 oc 명령을 사용할 수 있습니다.
```
C:\> oc <command>
```

macOS에 OpenShift CLI 설치

다음 절차에 따라 macOS에서 OpenShift CLI(oc) 바이너리를 설치할 수 있습니다.

프로세스

Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
버전 드롭다운 목록에서 적절한 버전을 선택합니다.
OpenShift v4.12 macOS Client 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.
참고
macOS ARM64의 경우 OpenShift v4.12 macOS ARM64 Client 항목을 선택합니다.
아카이브의 압축을 해제하고 압축을 풉니다.
oc 바이너리 PATH의 디렉터리로 이동합니다.
PATH를 확인하려면 터미널을 열고 다음 명령을 실행합니다.
```
$ echo $PATH
```

검증

OpenShift CLI를 설치한 후 oc 명령을 사용할 수 있습니다.
```
$ oc <command>
```

4.7. CLI를 사용하여 클러스터에 로그인

사전 요구 사항

OpenShift Container Platform 클러스터를 배포했습니다.
oc CLI를 설치했습니다.

프로세스

kubeadmin 인증 정보를 내보냅니다.
```
$ export KUBECONFIG=<installation_directory>/auth/kubeconfig 1
```
1
<installation_directory>는 설치 파일을 저장한 디렉터리의 경로를 지정합니다.
내보낸 구성을 사용하여 oc 명령을 성공적으로 실행할 수 있는지 확인합니다.
```
$ oc whoami
```
출력 예
```
system:admin
```

4.8. 웹 콘솔을 사용하여 클러스터에 로그인

사전 요구 사항

설치 호스트에 대한 액세스 권한이 있어야 합니다.
클러스터 설치를 완료했으며 모든 클러스터 Operator를 사용할 수 있습니다.

프로세스

설치 호스트의 kubeadmin-password 파일에서 kubeadmin 사용자의 암호를 가져옵니다.
```
$ cat <installation_directory>/auth/kubeadmin-password
```
참고
대안으로 설치 호스트의 <installation_directory>/.openshift_install.log 로그 파일에서 kubeadmin 암호를 가져올 수 있습니다.
OpenShift Container Platform 웹 콘솔 경로를 나열합니다.
```
$ oc get routes -n openshift-console | grep 'console-openshift'
```
참고
대안으로 설치 호스트의 <installation_directory>/.openshift_install.log 로그 파일에서 OpenShift Container Platform 경로를 가져올 수 있습니다.
출력 예
```
console     console-openshift-console.apps.<cluster_name>.<base_domain>            console     https   reencrypt/Redirect   None
```
웹 브라우저의 이전 명령 출력에 자세히 설명된 경로로 이동하고 kubeadmin 사용자로 로그인합니다.

4.9. OpenShift Container Platform의 Telemetry 액세스

추가 리소스

Telemetry 서비스에 대한 자세한 내용은 원격 상태 모니터링 정보를 참조하십시오.
OpenShift Container Platform 웹 콘솔에 액세스 및 이해에 대한 자세한 내용은 웹 콘솔 액세스를 참조하십시오.
OpenShift Container Platform 웹 콘솔 액세스 및 이해에 대한 자세한 내용은 웹 콘솔 액세스를 참조하십시오.

4.10. 다음 단계

5장. 네트워크 사용자 지정이 포함된 Alibaba Cloud에 클러스터 설치

OpenShift Container Platform 4.12에서는 사용자 지정 네트워크 구성 옵션을 사용하여 Alibaba Cloud에 클러스터를 설치할 수 있습니다. 네트워크 구성을 사용자 지정할 경우, 클러스터가 사용자 환경의 기존 IP 주소 할당과 공존하고 기존 MTU 및 VXLAN 구성과 통합될 수 있습니다.

설치 과정에서 네트워크 구성 매개변수를 대부분 설정해야 하며, 실행 중인 클러스터에서는 kubeProxy 구성 매개변수만 수정할 수 있습니다.

중요

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

5.1. 사전 요구 사항

OpenShift Container Platform 설치 및 업데이트 프로세스에 대한 세부 사항을 검토했습니다.
클러스터 설치 방법 선택 및 사용자를 위한 준비에 대한 문서를 읽습니다.
도메인을 등록했습니다.
방화벽을 사용하는 경우 클러스터가 액세스해야 하는 사이트를 허용하도록 방화벽을 구성했습니다.
사용자의 환경에서 Cloud Resource Access Management(RAM) API에 액세스할 수 없거나 kube-system 네임스페이스에 관리자 수준의 인증 정보 시크릿을 저장하지 않으려면 수동으로 리소스 액세스 관리(RAM) 인증 정보를 생성 및 유지 관리할 수 있습니다.

5.2. OpenShift Container Platform 용 인터넷 액세스

OpenShift Container Platform 4.12에서 클러스터를 설치하려면 인터넷 액세스가 필요합니다.

다음의 경우 인터넷 액세스가 필요합니다.

OpenShift Cluster Manager Hybrid Cloud Console 에 액세스하여 설치 프로그램을 다운로드하고 서브스크립션 관리를 수행합니다. 클러스터가 인터넷에 액세스할 수 있고 Telemetry 서비스를 비활성화하지 않은 경우, 클러스터에 자동으로 권한이 부여됩니다.
Quay.io에 액세스. 클러스터를 설치하는 데 필요한 패키지를 받을 수 있습니다.
클러스터 업데이트를 수행하는 데 필요한 패키지를 받을 수 있습니다.

중요

5.3. 클러스터 노드 SSH 액세스를 위한 키 쌍 생성

중요

재해 복구 및 디버깅이 필요한 프로덕션 환경에서는이 단계를 생략하지 마십시오.

참고

AWS 키 쌍과 같이 플랫폼 고유의 방식으로 구성된 키가 아닌 로컬 키를 사용해야 합니다.

프로세스

로컬 시스템에 클러스터 노드의 인증에 사용할 기존 SSH 키 쌍이 없는 경우 새로 생성합니다. 예를 들어 Linux 운영 체제를 사용하는 컴퓨터에서 다음 명령을 실행합니다.
```
$ ssh-keygen -t ed25519 -N '' -f <path>/<file_name> 1
```
1
새 SSH 키의 경로 및 파일 이름(예: ~/.ssh/id_ed25519 )을 지정합니다. 기존 키 쌍이 있는 경우 공개 키가 '~/.ssh 디렉터리에 있는지 확인하십시오.
참고
x86_64,ppc64le, s390x 아키텍처에서 FIPS 검증 또는 진행중인 모듈 In Process 암호화 라이브러리를 사용하는 OpenShift Container Platform 클러스터를 설치하려면 ed25519 알고리즘을 사용하는 키를 생성하지 마십시오. 대신 rsa 또는 ecdsa 알고리즘을 사용하는 키를 생성합니다.
공개 SSH 키를 확인합니다.
```
$ cat <path>/<file_name>.pub
```
예를 들어 다음을 실행하여 ~/.ssh/id_ed25519.pub 공개 키를 확인합니다.
```
$ cat ~/.ssh/id_ed25519.pub
```
아직 추가되지 않은 경우 로컬 사용자의 SSH 에이전트에 SSH 개인 키 ID를 추가합니다. 키의 SSH 에이전트 관리는 클러스터 노드에 암호 없는 SSH 인증을 수행하거나 ./openshift-install gather 명령을 사용하려는 경우 필요합니다.
참고
일부 배포에서는 ~/.ssh/id_rsa 및 ~/.ssh/id_dsa와 같은 기본 SSH 개인 키 ID가 자동으로 관리됩니다.
1. ssh-agent 프로세스가 로컬 사용자에 대해 실행되지 않은 경우 백그라운드 작업으로 시작합니다.
```
$ eval "$(ssh-agent -s)"
```
  출력 예
```
Agent pid 31874
```
  참고
  클러스터가 FIPS 모드인 경우 FIPS 호환 알고리즘만 사용하여 SSH 키를 생성합니다. 키는 RSA 또는 ECDSA여야 합니다.
ssh-agent에 SSH 개인 키를 추가합니다.
```
$ ssh-add <path>/<file_name> 1
```
1
SSH 개인 키의 경로와 파일 이름을 지정합니다(예: ~/.ssh/id_ed25519).
출력 예
```
Identity added: /home/<you>/<path>/<file_name> (<computer_name>)
```

다음 단계

OpenShift Container Platform을 설치할 때 SSH 공개 키를 설치 프로그램에 지정합니다.

5.4. 설치 프로그램 받기

OpenShift Container Platform을 설치하기 전에 설치에 사용하는 호스트에 설치 파일을 다운로드합니다.

사전 요구 사항

500MB의 로컬 디스크 공간이 있는 Linux 또는 macOS를 실행하는 컴퓨터가 있습니다.

프로세스

OpenShift Cluster Manager 사이트의 인프라 공급자 페이지에 액세스합니다. Red Hat 계정이 있으면 사용자 자격 증명으로 로그인합니다. 계정이 없으면 계정을 만드십시오.
인프라 공급자를 선택합니다.
설치 유형 페이지로 이동하여 호스트 운영 체제 및 아키텍처에 해당하는 설치 프로그램을 다운로드하여 설치 구성 파일을 저장할 디렉터리에 파일을 배치합니다.
중요
설치 프로그램은 클러스터를 설치하는 데 사용하는 컴퓨터에 여러 파일을 만듭니다. 클러스터 설치를 마친 후 설치 프로그램과 설치 프로그램으로 생성되는 파일을 보관해야 합니다. 클러스터를 삭제하려면 두 파일이 모두 필요합니다.
중요
클러스터 설치에 실패하거나 설치 프로그램으로 만든 파일을 삭제해도 클러스터는 제거되지 않습니다. 클러스터를 제거하려면 해당 클라우드 공급자에 적용되는 OpenShift Container Platform 설치 제거 절차를 완료해야 합니다.
설치 프로그램 파일의 압축을 풉니다. 예를 들어 Linux 운영 체제를 사용하는 컴퓨터에서 다음 명령을 실행합니다.
```
$ tar -xvf openshift-install-linux.tar.gz
```
Red Hat OpenShift Cluster Manager에서 설치 풀 시크릿을 다운로드합니다. 이 풀 시크릿을 사용하면 OpenShift Container Platform 구성 요소에 대한 컨테이너 이미지를 제공하는 Quay.io를 포함하여 인증 기관에서 제공하는 서비스로 인증할 수 있습니다.

5.5. 네트워크 구성 단계

OpenShift Container Platform을 설치하기 전에 네트워크 구성을 사용자 지정할 수 있습니다.

1 단계

매니페스트 파일을 생성하기 전에 install-config.yaml 파일에서 다음 네트워크 관련 필드를 사용자 지정할 수 있습니다.

networking.networkType
networking.clusterNetwork
networking.serviceNetwork
networking.machineNetwork
이러한 필드에 대한 자세한 내용은 설치 구성 매개 변수에서 참조하십시오.
참고
기본 NIC가 상주하는 CIDR과 일치하도록 networking.machineNetwork를 설정합니다.
중요
CIDR 범위 172.17.0.0/16 은 libVirt에 의해 예약되어 있습니다. 클러스터의 모든 네트워크에 이 범위와 겹치는 범위 또는 모든 범위를 사용할 수 없습니다.

2 단계

openshift-install create manifests 를 실행하여 매니페스트 파일을 생성한 후 수정할 필드로 사용자 지정된 Cluster Network Operator 매니페스트를 정의할 수 있습니다. 매니페스트를 사용하여 고급 네트워크 구성을 지정할 수 있습니다.

install-config.yaml 파일에서 1 단계에 지정된 값을 2 단계에서 재정의할 수 없습니다. 그러나 2 단계에서 네트워크 플러그인을 추가로 사용자 지정할 수 있습니다.

5.5.1. 설치 구성 파일 만들기

설치하는 OpenShift Container Platform 클러스터를 사용자 지정할 수 있습니다.

사전 요구 사항

OpenShift Container Platform 설치 프로그램과 클러스터의 풀 시크릿을 받습니다.
서브스크립션 수준에서 서비스 권한을 확보합니다.

프로세스

install-config.yaml 파일을 생성합니다.
1. 설치 프로그램이 포함된 디렉터리로 변경하고 다음 명령을 실행합니다.
```
$ ./openshift-install create install-config --dir <installation_directory> 1
```
  1
  <installation_directory>는 설치 프로그램이 생성하는 파일을 저장할 디렉터리 이름을 지정합니다.
  디렉터리를 지정할 때 다음을 수행합니다.
  - 디렉터리에 실행 권한이 있는지 확인합니다. 설치 디렉토리에서 Terraform 바이너리를 실행하려면 이 권한이 필요합니다.
  - 빈 디렉터리를 사용합니다. 부트스트랩 X.509 인증서와 같은 일부 설치 자산은 단기간에 만료되므로 설치 디렉터리를 재사용해서는 안 됩니다. 다른 클러스터 설치의 개별 파일을 재사용하려면 해당 파일을 사용자 디렉터리에 복사하면 됩니다. 그러나 설치 자산의 파일 이름은 릴리스간에 변경될 수 있습니다. 따라서 이전 OpenShift Container Platform 버전에서 설치 파일을 복사할 때는 주의하십시오.
2. 화면에 나타나는 지시에 따라 클라우드에 대한 구성 세부 사항을 입력합니다.
  1. 선택사항: 클러스터 시스템에 액세스하는 데 사용할 SSH 키를 선택합니다.
    참고
    설치 디버깅 또는 재해 복구 수행을 원하는 프로덕션 환경 OpenShift Container Platform 클러스터의 경우 ssh-agent 프로세스에 사용할 SSH 키를 지정하십시오.
  2. 클러스터를 설명할 수 있는 이름을 입력합니다.
  3. Red Hat OpenShift Cluster Manager에서 풀 시크릿 을 붙여넣습니다.
install-config.yaml 파일을 수정합니다. 사용 가능한 매개변수에 대한 자세한 정보는 “설치 구성 매개변수” 섹션에서 확인할 수 있습니다.
여러 클러스터를 설치하는 데 사용할 수 있도록 install-config.yaml 파일을 백업합니다.
중요
install-config.yaml 파일은 설치 과정에서 사용됩니다. 이 파일을 재사용하려면 지금 백업해야 합니다.

5.5.2. 필요한 설치 매니페스트 생성

클러스터가 머신을 구성하는 데 필요한 Kubernetes 매니페스트 및 Ignition 구성 파일을 생성해야 합니다.

프로세스

설치 프로그램이 포함된 디렉터리에서 다음 명령을 실행하여 매니페스트를 생성합니다.
```
$ openshift-install create manifests --dir <installation_directory>
```
다음과 같습니다.
<installation_directory>
설치 프로그램이 파일을 생성하는 디렉터리를 지정합니다.

참고

사전 요구 사항

다음이 있어야 합니다.

ccoctl 바이너리를 추출하여 준비합니다.

프로세스

다음 명령을 실행하여 OpenShift Container Platform 릴리스 이미지에서 CredentialsRequest 오브젝트 목록을 추출합니다.
```
<1> `credrequests` is the directory where the list of `CredentialsRequest` objects is stored. This command creates the directory if it does not exist.
```
참고
이 명령을 실행하는 데 시간이 다소 걸릴 수 있습니다.

5.5.3. 설치 구성 매개변수

참고

설치한 후에는 install-config.yaml 파일에서 이러한 매개변수를 수정할 수 없습니다.

5.5.3.1. 필수 구성 매개변수

필수 설치 구성 매개변수는 다음 표에 설명되어 있습니다.

표 5.1. 필수 매개 변수
매개변수	설명	값
`apiVersion`	`install-config.yaml` 콘텐츠의 API 버전입니다. 현재 버전은 `v1`입니다. 설치 프로그램에서 이전 API 버전도 지원할 수 있습니다.	문자열
`baseDomain`	클라우드 공급자의 기본 도메인입니다. 기본 도메인은 OpenShift Container Platform 클러스터 구성 요소에 대한 경로를 생성하는 데 사용됩니다. 클러스터의 전체 DNS 이름은 `baseDomain`과 `metadata.name` 매개변수 값의 조합으로, `<metadata.name>.<baseDomain>` 형식입니다.	정규화된 도메인 또는 하위 도메인 이름(예: `example.com`).
`metadata`	Kubernetes 리소스 `ObjectMeta`로 `name` 매개변수만 사용합니다.	개체
`metadata.name`	클러스터의 이름입니다. 클러스터의 DNS 레코드는 `{{.metadata.name}}.{{. baseDomain}}` 형식의 모든 하위 도메인입니다.	소문자, 하이픈(`-`), 마침표(`.`)로 구성되는 문자열(예: `dev`)입니다.
`platform`	설치를 수행할 특정 플랫폼에 대한 구성: `alibabacloud`,aws ,`baremetal`,`azure`,`gcp`,`ibmcloud`,`nutanix`,`openstack`,`ovirt`,`vsphere`, `{}`. `platform.<platform>` 매개변수에 대한 자세한 내용은 다음 표에서 사용자 플랫폼에 해당하는 정보를 참조하십시오.	개체
`pullSecret`	Red Hat OpenShift Cluster Manager에서 풀 시크릿을 가져와서 Quay.io와 같은 서비스에서 OpenShift Container Platform 구성 요소의 컨테이너 이미지 다운로드를 인증합니다.	{ "auths":{ "cloud.openshift.com":{ "auth":"b3Blb=", "email":"you@example.com" }, "quay.io":{ "auth":"b3Blb=", "email":"you@example.com" } } }

5.5.3.2. 네트워크 구성 매개변수

IPv4 주소만 지원됩니다.

참고

표 5.2. 네트워크 매개변수
매개변수	설명	값
`networking`	클러스터의 네트워크의 구성입니다.	개체 참고 설치한 후에는 `networking` 오브젝트에서 지정된 매개변수를 수정할 수 없습니다.
`networking.networkType`	설치할 Red Hat OpenShift Networking 네트워크 플러그인입니다.	`OpenShiftSDN` 또는 `OVNKubernetes` 중 하나이며, `OpenShiftSDN` 은 모든 Linux 네트워크를 위한 CNI 플러그인입니다. `OVNKubernetes` 는 Linux 네트워크 및 하이브리드 네트워크용 CNI 플러그인으로, Linux 및 Windows 서버가 모두 포함됩니다. 기본값은 `OVNKubernetes` 입니다.
`networking.clusterNetwork`	Pod의 IP 주소 블록입니다. 기본값은 `10.128.0.0/14`이며, 호스트 접두사는 `/23`입니다. 여러 IP 주소 블록을 지정하는 경우 블록이 겹치지 않아야 합니다.	개체의 배열입니다. 예를 들면 다음과 같습니다. networking: clusterNetwork: - cidr: 10.128.0.0/14 hostPrefix: 23
`networking.clusterNetwork.cidr`	`networking.clusterNetwork`를 사용하는 경우 필수 항목입니다. IP 주소 블록입니다. IPv4 네트워크입니다.	CIDR(Classless Inter-Domain Routing) 표기법의 IP 주소 블록입니다. IPv4 블록의 접두사 길이는 `0` 에서 `32` 사이입니다.
`networking.clusterNetwork.hostPrefix`	개별 노드 각각에 할당할 서브넷 접두사 길이입니다. 예를 들어 `hostPrefix`를 `23`으로 설정하는 경우, 지정된 `cidr` 이외 `/23` 서브넷이 각 노드에 할당됩니다. `23`의 `hostPrefix` 값은 510(2^(32 - 23) - 2) Pod IP 주소를 제공합니다.	서브넷 접두사입니다. 기본값은 `23`입니다.
`networking.serviceNetwork`	서비스의 IP 주소 블록입니다. 기본값은 `172.30.0.0/16`입니다. OpenShift SDN 및 OVN-Kubernetes 네트워크 플러그인은 서비스 네트워크에 대한 단일 IP 주소 블록만 지원합니다.	CIDR 형식의 IP 주소 블록이 있는 어레이입니다. 예를 들면 다음과 같습니다. networking: serviceNetwork: - 172.30.0.0/16
`networking.machineNetwork`	시스템의 IP 주소 블록입니다. 여러 IP 주소 블록을 지정하는 경우 블록이 겹치지 않아야 합니다.	개체의 배열입니다. 예를 들면 다음과 같습니다. networking: machineNetwork: - cidr: 10.0.0.0/16
`networking.machineNetwork.cidr`	`networking.machineNetwork`를 사용하는 경우 필수 항목입니다. IP 주소 블록입니다. libvirt를 제외한 모든 플랫폼의 기본값은 `10.0.0.0/16`입니다. libvirt의 기본값은 `192.168.126.0/24`입니다.	CIDR 표기법의 IP 네트워크 블록입니다. 예: `10.0.0.0/16` 참고 기본 NIC가 상주하는 CIDR과 일치하도록 `networking.machineNetwork`를 설정합니다.

5.5.3.3. 선택적 구성 매개변수

선택적 설치 구성 매개변수는 다음 표에 설명되어 있습니다.

표 5.3. 선택적 매개변수
매개변수	설명	값
`additionalTrustBundle`	노드의 신뢰할 수 있는 인증서 스토리지에 추가되는 PEM 인코딩 X.509 인증서 번들입니다. 이 신뢰할 수 있는 번들은 프록시가 구성되었을 때에도 사용할 수 있습니다.	문자열
`capabilities`	선택적 핵심 클러스터 구성 요소의 설치를 제어합니다. 선택적 구성 요소를 비활성화하여 OpenShift Container Platform 클러스터의 설치 공간을 줄일 수 있습니다. 자세한 내용은 설치 의 "클러스터 기능" 페이지를 참조하십시오.	문자열 배열
`capabilities.baselineCapabilitySet`	활성화할 선택적 기능 세트를 선택합니다. 유효한 값은 `None`,`v4.11`,`v4.12` 및 `v Current` 입니다. 기본값은 `v current입니다`.	문자열
`capabilities.additionalEnabledCapabilities`	`baselineCapabilitySet` 에서 지정한 것 이상으로 선택적 기능 세트를 확장합니다. 이 매개변수에서 여러 기능을 지정할 수 있습니다.	문자열 배열
`compute`	컴퓨팅 노드를 구성하는 시스템의 구성입니다.	`MachinePool` 개체의 배열입니다.
`compute.architecture`	풀에 있는 시스템의 명령어 집합 아키텍처를 결정합니다. 현재 다양한 아키텍처가 있는 클러스터는 지원되지 않습니다. 모든 풀은 동일한 아키텍처를 지정해야 합니다. 유효한 값은 `amd64`(기본값)입니다.	문자열
`compute.hyperthreading`	컴퓨팅 시스템에서 동시 멀티스레딩 또는 `hyperthreading` 활성화 또는 비활성화 여부를 지정합니다. 시스템 코어의 성능을 높이기 위해 기본적으로 동시 멀티스레딩이 활성화됩니다. 중요 동시 멀티스레딩을 비활성화하는 경우 용량 계획에서 시스템 성능이 크게 저하될 수 있는 문제를 고려해야 합니다.	`Enabled` 또는 `Disabled`
`compute.name`	`compute`를 사용하는 경우 필수 항목입니다. 시스템 풀의 이름입니다.	`worker`
`compute.platform`	`compute`를 사용하는 경우 필수 항목입니다. 이 매개변수를 사용하여 작업자 시스템을 호스팅할 클라우드 공급자를 지정합니다. 이 매개변수 값은 `controlPlane.platform` 매개변수 값과 일치해야 합니다	`alibabacloud`,`aws`,`azure`,`gcp`,`ibmcloud`,`nutanix`,`openstack`,`ovirt`,`vsphere`, `{}`
`compute.replicas`	프로비저닝할 컴퓨팅 시스템(작업자 시스템이라고도 함) 수입니다.	`2` 이상의 양의 정수이며, 기본값은 `3`입니다.
`featureSet`	기능 세트를 위한 클러스터를 활성화합니다. 기능 세트는 기본적으로 활성화되어 있지 않은 OpenShift Container Platform 기능 컬렉션입니다. 설치 중에 기능 세트를 활성화하는 방법에 대한 자세한 내용은 "기능 게이트를 사용하여 기능 활성화"를 참조하십시오.	문자열. `TechPreviewNoUpgrade` 와 같이 활성화할 기능 세트의 이름입니다.
`controlPlane`	컨트롤 플레인을 구성하는 시스템들의 구성입니다.	`MachinePool` 개체의 배열입니다.
`controlPlane.architecture`	풀에 있는 시스템의 명령어 집합 아키텍처를 결정합니다. 현재 다양한 아키텍처가 있는 클러스터는 지원되지 않습니다. 모든 풀은 동일한 아키텍처를 지정해야 합니다. 유효한 값은 `amd64`(기본값)입니다.	문자열
`controlPlane.hyperthreading`	컨트롤 플레인 시스템에서 동시 멀티스레딩 또는 `hyperthreading` 활성화 또는 비활성화 여부를 지정합니다. 시스템 코어의 성능을 높이기 위해 기본적으로 동시 멀티스레딩이 활성화됩니다. 중요 동시 멀티스레딩을 비활성화하는 경우 용량 계획에서 시스템 성능이 크게 저하될 수 있는 문제를 고려해야 합니다.	`Enabled` 또는 `Disabled`
`controlPlane.name`	`controlPlane`을 사용하는 경우 필수 항목입니다. 시스템 풀의 이름입니다.	`master`
`controlPlane.platform`	`controlPlane`을 사용하는 경우 필수 항목입니다. 이 매개변수를 사용하여 컨트롤 플레인 시스템을 호스팅하는 클라우드 공급자를 지정합니다. 이 매개변수 값은 `compute.platform` 매개변수 값과 일치해야 합니다.	`alibabacloud`,`aws`,`azure`,`gcp`,`ibmcloud`,`nutanix`,`openstack`,`ovirt`,`vsphere`, `{}`
`controlPlane.replicas`	프로비저닝하는 컨트롤 플레인 시스템의 수입니다.	지원되는 유일한 값은 기본값인 `3`입니다.
`credentialsMode`	Cloud Credential Operator (CCO) 모드입니다. 모드가 지정되지 않은 경우 CCO는 여러 모드가 지원되는 플랫폼에서 Mint 모드가 우선으로 되어 지정된 인증 정보의 기능을 동적으로 확인하려고합니다. 참고 모든 클라우드 공급자에서 모든 CCO 모드가 지원되는 것은 아닙니다. CCO 모드에 대한 자세한 내용은 Cluster Operators 참조 콘텐츠의 Cloud Credential Operator 항목을 참조하십시오. 참고 AWS 계정에 서비스 제어 정책(SCP)이 활성화된 경우 `credentialsMode` 매개변수를 `Mint`,`Passthrough` 또는 `Manual` 로 구성해야 합니다.	`Mint`,`Passthrough`,`Manual` 또는 빈 문자열(`""`)
`fips`	FIPS 모드를 활성화 또는 비활성화합니다. 기본값은 `false`(비활성화)입니다. FIPS 모드가 활성화되면 OpenShift Container Platform이 실행되는 RHCOS(Red Hat Enterprise Linux CoreOS) 시스템에서 기본 Kubernetes 암호화 제품군은 우회하고 RHCOS와 함께 제공되는 암호화 모듈을 대신 사용합니다. 중요 클러스터의 FIPS 모드를 활성화하려면 FIPS 모드에서 작동하도록 구성된 RHEL(Red Hat Enterprise Linux) 컴퓨터에서 설치 프로그램을 실행해야 합니다. RHEL에서 FIPS 모드 구성에 대한 자세한 내용은 FIPS 모드에서 시스템 설치를 참조하십시오. FIPS 검증 또는 모듈 In Process 암호화 라이브러리 사용은 `x86_64`,`ppc64le` 및 `s390x` 아키텍처의 OpenShift Container Platform 배포에서만 지원됩니다. 참고 Azure File 스토리지를 사용하는 경우 FIPS 모드를 활성화할 수 없습니다.	`false` 또는 `true`
`imageContentSources`	릴리스 이미지 내용의 소스 및 리포지토리입니다.	개체의 배열입니다. 이 표의 다음 행에 설명된 대로 `source`와 `mirrors`(선택사항)가 포함됩니다.
`imageContentSources.source`	`imageContentSources`를 사용하는 경우 필수 항목입니다. 예를 들어 이미지 가져오기 사양에서 사용자가 가리키는 리포지토리를 지정합니다.	문자열
`imageContentSources.mirrors`	동일한 이미지를 포함할 수도 있는 하나 이상의 리포지토리를 지정합니다.	문자열 배열
`publish`	Kubernetes API, OpenShift 경로와 같이 클러스터의 사용자 끝점을 게시하거나 노출하는 방법입니다.	`Internal` 또는 `External`입니다. 기본값은 `External`입니다. 이 필드를 `Internal` 로 설정하는 것은 클라우드 이외의 플랫폼에서는 지원되지 않습니다. 중요 필드 값을 `Internal` 로 설정하면 클러스터가 작동하지 않습니다. 자세한 내용은 BZ#1953035를 참조하십시오.
`sshKey`	클러스터 시스템에 대한 액세스를 인증하는 SSH 키입니다. 참고 설치 디버깅 또는 재해 복구를 수행하려는 프로덕션 OpenShift Container Platform 클러스터의 경우 `ssh-agent` 프로세스가 사용하는 SSH 키를 지정합니다.	예를 들어 `sshKey: ssh-ed25519 AAAA`...

5.5.4. Alibaba Cloud에 대한 샘플 사용자 지정 install-config.yaml 파일

설치 구성 파일(install-config.yaml)을 사용자 지정하여 클러스터 플랫폼에 대한 자세한 정보를 지정하거나 필수 매개변수 값을 수정할 수 있습니다.

apiVersion: v1
baseDomain: alicloud-dev.devcluster.openshift.com
credentialsMode: Manual
compute:
- architecture: amd64
  hyperthreading: Enabled
  name: worker
  platform: {}
  replicas: 3
controlPlane:
  architecture: amd64
  hyperthreading: Enabled
  name: master
  platform: {}
  replicas: 3
metadata:
  creationTimestamp: null
  name: test-cluster 1
 networking:
  clusterNetwork:
  - cidr: 10.128.0.0/14
    hostPrefix: 23
  machineNetwork:
  - cidr: 10.0.0.0/16
  networkType: OVNKubernetes 2
  serviceNetwork:
  - 172.30.0.0/16
platform:
  alibabacloud:
    defaultMachinePlatform: 3
      instanceType: ecs.g6.xlarge
      systemDiskCategory: cloud_efficiency
      systemDiskSize: 200
    region: ap-southeast-1 4
    resourceGroupID: rg-acfnw6j3hyai 5
    vpcID: vpc-0xifdjerdibmaqvtjob2b 6
    vswitchIDs: 7
    - vsw-0xi8ycgwc8wv5rhviwdq5
    - vsw-0xiy6v3z2tedv009b4pz2
publish: External
pullSecret: '{"auths": {"cloud.openshift.com": {"auth": ... }' 8
sshKey: |
  ssh-rsa AAAA... 9

1: 필수 항목입니다. 설치 프로그램에서 클러스터 이름을 입력하라는 메시지를 표시합니다.
2: 설치할 클러스터 네트워크 플러그인입니다. 지원되는 값은 OVNKubernetes 및 OpenShiftSDN 입니다. 기본값은 OVNKubernetes 입니다.
3: 선택 사항: 자체 플랫폼 구성을 정의하지 않는 머신 풀에 대한 매개변수를 지정합니다.
4: 필수 항목입니다. 설치 프로그램에서 클러스터를 배포할 리전을 묻는 메시지를 표시합니다.
5: 선택 사항: 클러스터를 설치해야 하는 기존 리소스 그룹을 지정합니다.
8: 필수 항목입니다. 설치 프로그램에서 가져오기 시크릿을 묻는 메시지를 표시합니다.
9: 선택 사항: 설치 프로그램에서 클러스터의 시스템에 액세스하는 데 사용하는 SSH 키 값을 입력하라는 메시지를 표시합니다.
6 7: 선택 사항: 다음은 예제 vswitchID 값입니다.

5.5.5. 설치 중 클러스터 단위 프록시 구성

사전 요구 사항

기존 install-config.yaml 파일이 있습니다.
클러스터에서 액세스해야 하는 사이트를 검토하고 프록시를 바이패스해야 하는지 확인했습니다. 기본적으로 호스팅 클라우드 공급자 API에 대한 호출을 포함하여 모든 클러스터 발신(Egress) 트래픽이 프록시됩니다. 필요한 경우 프록시를 바이패스하기 위해 Proxy 오브젝트의 spec.noProxy 필드에 사이트를 추가했습니다.
참고
Proxy 오브젝트의 status.noProxy 필드는 설치 구성에 있는 networking.machineNetwork[].cidr, networking.clusterNetwork[].cidr, networking.serviceNetwork[] 필드의 값으로 채워집니다.
Amazon Web Services (AWS), Google Cloud Platform (GCP), Microsoft Azure 및 Red Hat OpenStack Platform (RHOSP)에 설치하는 경우 Proxy 오브젝트 status.noProxy 필드도 인스턴스 메타데이터 끝점(169.254.169.254)로 채워집니다.

프로세스

install-config.yaml 파일을 편집하고 프록시 설정을 추가합니다. 예를 들면 다음과 같습니다.
```
apiVersion: v1
baseDomain: my.domain.com
proxy:
  httpProxy: http://<username>:<pswd>@<ip>:<port> 1
  httpsProxy: https://<username>:<pswd>@<ip>:<port> 2
  noProxy: example.com 3
additionalTrustBundle: | 4
    -----BEGIN CERTIFICATE-----
    <MY_TRUSTED_CA_CERT>
    -----END CERTIFICATE-----
additionalTrustBundlePolicy: <policy_to_add_additionalTrustBundle> 5
```
1
클러스터 외부에서 HTTP 연결을 구축하는 데 사용할 프록시 URL입니다. URL 스키마는 http여야 합니다.
2
클러스터 외부에서 HTTPS 연결을 구축하는 데 사용할 프록시 URL입니다.
3
대상 도메인 이름, IP 주소 또는 프록시에서 제외할 기타 네트워크 CIDR로 이루어진 쉼표로 구분된 목록입니다. 하위 도메인과 일치하려면 도메인 앞에 .을 입력합니다. 예를 들어, .y.com은 x.y.com과 일치하지만 y.com은 일치하지 않습니다. *를 사용하여 모든 대상에 대해 프록시를 바이패스합니다.
4
이 값을 제공하면 설치 프로그램에서 HTTPS 연결을 프록시하는 데 필요한 추가 CA 인증서가 하나 이상 포함된 openshift-config 네임스페이스에 user-ca-bundle이라는 이름으로 구성 맵을 생성합니다. 그러면 CNO(Cluster Network Operator)에서 이러한 콘텐츠를 RHCOS(Red Hat Enterprise Linux CoreOS) 신뢰 번들과 병합하는 trusted-ca-bundle 구성 맵을 생성합니다. 이 구성 맵은 Proxy 오브젝트의 trustedCA 필드에서 참조됩니다. 프록시의 ID 인증서를 RHCOS 트러스트 번들에 있는 기관에서 서명하지 않은 경우 additionalTrustBundle 필드가 있어야 합니다.
5
선택 사항: trustedCA 필드에서 user-ca-bundle 구성 맵을 참조할 프록시 오브젝트의 구성을 결정하는 정책입니다. 허용되는 값은 Proxyonly 및 Always 입니다. http/https 프록시가 구성된 경우에만 user-ca-bundle 구성 맵을 참조하려면 Proxyonly 를 사용합니다. Always 를 사용하여 user-ca-bundle 구성 맵을 항상 참조합니다. 기본값은 Proxyonly 입니다.
참고
설치 프로그램에서 프록시 adinessEndpoints 필드를 지원하지 않습니다.
참고
설치 프로그램이 시간 초과되면 설치 프로그램의 wait-for 명령을 사용하여 배포를 다시 시작한 다음 완료합니다. 예를 들면 다음과 같습니다.
```
$ ./openshift-install wait-for install-complete --log-level debug
```
파일을 저장해 놓고 OpenShift Container Platform을 설치할 때 참조하십시오.

참고

cluster라는 Proxy 오브젝트만 지원되며 추가 프록시는 생성할 수 없습니다.

5.6. CNO(Cluster Network Operator) 구성

클러스터 네트워크의 구성은 CNO(Cluster Network Operator) 구성의 일부로 지정되며 cluster라는 이름의 CR(사용자 정의 리소스) 오브젝트에 저장됩니다. CR은 operator.openshift.io API 그룹에서 Network API의 필드를 지정합니다.

CNO 구성은 Network.config.openshift.io API 그룹의 Network API에서 클러스터 설치 중에 다음 필드를 상속하며 이러한 필드는 변경할 수 없습니다.

clusterNetwork: Pod IP 주소가 할당되는 IP 주소 풀입니다.
serviceNetwork: 서비스를 위한 IP 주소 풀입니다.
defaultNetwork.type: OpenShift SDN 또는 OVN-Kubernetes와 같은 클러스터 네트워크 플러그인

cluster라는 CNO 오브젝트에서 defaultNetwork 오브젝트의 필드를 설정하여 클러스터의 클러스터 네트워크 플러그인 구성을 지정할 수 있습니다.

5.6.1. CNO(Cluster Network Operator) 구성 오브젝트

CNO(Cluster Network Operator)의 필드는 다음 표에 설명되어 있습니다.

표 5.4. CNO(Cluster Network Operator) 구성 오브젝트
필드	유형	설명
`metadata.name`	`string`	CNO 개체 이름입니다. 이 이름은 항상 `cluster`입니다.
`spec.clusterNetwork`	`array`	Pod IP 주소가 할당되는 IP 주소 블록과 클러스터의 각 개별 노드에 할당된 서브넷 접두사 길이를 지정하는 목록입니다. 예를 들면 다음과 같습니다. spec: clusterNetwork: - cidr: 10.128.0.0/19 hostPrefix: 23 - cidr: 10.128.32.0/19 hostPrefix: 23 매니페스트를 생성하기 전에 `install-config.yaml` 파일에서만 이 필드를 사용자 지정할 수 있습니다. 값은 매니페스트 파일에서 읽기 전용입니다.
`spec.serviceNetwork`	`array`	서비스의 IP 주소 블록입니다. OpenShift SDN 및 OVN-Kubernetes 네트워크 플러그인은 서비스 네트워크에 대한 단일 IP 주소 블록만 지원합니다. 예를 들면 다음과 같습니다. spec: serviceNetwork: - 172.30.0.0/14 매니페스트를 생성하기 전에 `install-config.yaml` 파일에서만 이 필드를 사용자 지정할 수 있습니다. 값은 매니페스트 파일에서 읽기 전용입니다.
`spec.defaultNetwork`	`object`	클러스터 네트워크의 네트워크 플러그인을 구성합니다.
`spec.kubeProxyConfig`	`object`	이 개체의 필드는 kube-proxy 구성을 지정합니다. OVN-Kubernetes 클러스터 네트워크 플러그인을 사용하는 경우 kube-proxy 구성이 적용되지 않습니다.

defaultNetwork 오브젝트 구성

defaultNetwork 오브젝트의 값은 다음 표에 정의되어 있습니다.

표 5.5. defaultNetwork 오브젝트
필드	유형	설명
`type`	`string`	`OpenShiftSDN` 또는 `OVNKubernetes` 중 하나이며, Red Hat OpenShift Networking 네트워크 플러그인은 설치 중에 선택됩니다. 클러스터를 설치한 후에는 이 값을 변경할 수 없습니다. 참고 OpenShift Container Platform은 기본적으로 OVN-Kubernetes 네트워크 플러그인을 사용합니다.
`openshiftSDNConfig`	`object`	이 오브젝트는 OpenShift SDN 네트워크 플러그인에만 유효합니다.
`ovnKubernetesConfig`	`object`	이 오브젝트는 OVN-Kubernetes 네트워크 플러그인에만 유효합니다.

OpenShift SDN 네트워크 플러그인 구성

다음 표에서는 OpenShift SDN 네트워크 플러그인의 구성 필드를 설명합니다.

표 5.6. openshiftSDNConfig 오브젝트
필드	유형	설명
`mode`	`string`	OpenShift SDN의 네트워크 격리 모드를 구성합니다. 기본값은 `NetworkPolicy`입니다. `Multitenant` 및 `Subnet` 값은 OpenShift Container Platform 3.x 버전과의 역호환할 수 있지만 권장되지는 않습니다. 클러스터를 설치한 후에는 이 값을 변경할 수 없습니다.
`mtu`	`integer`	VXLAN 오버레이 네트워크의 최대 전송 단위(MTU)입니다. 이는 기본 네트워크 인터페이스의 MTU를 기준으로 자동 탐지됩니다. 일반적으로 감지된 MTU를 재정의할 필요는 없습니다. 자동 감지 값이 예상 밖인 경우 노드의 기본 네트워크 인터페이스의 MTU가 올바른지 확인합니다. 이 옵션을 사용하여 노드의 기본 네트워크 인터페이스의 MTU 값을 변경할 수 없습니다. 클러스터에 다른 노드에 대한 다른 MTU 값이 필요한 경우 이 값을 클러스터의 가장 낮은 MTU 값보다 `50` 미만으로 설정해야 합니다. 예를 들어 클러스터의 일부 노드에는 `9001`의 MTU가 있고 일부에는 `1500`의 MTU가 있는 경우 이 값을 `1450`으로 설정해야 합니다. 클러스터를 설치한 후에는 이 값을 변경할 수 없습니다.
`vxlanPort`	`integer`	모든 VXLAN 패킷에 사용할 포트입니다. 기본값은 `4789`입니다. 클러스터를 설치한 후에는 이 값을 변경할 수 없습니다. 기존 노드가 다른 VXLAN 네트워크에 속하는 가상 환경에서 실행 중인 경우에는 기본값을 변경해야 할 수도 있습니다. 예를 들어 VMware NSX-T 위에서 OpenShift SDN 오버레이를 실행할 때 두 SDN이 동일한 기본 VXLAN 포트 번호를 사용하므로 VXLAN의 대체 포트를 선택해야 합니다. AWS(Amazon Web Services)에서는 포트 `9000`과 포트 `9999` 사이에서 VXLAN의 대체 포트를 선택할 수 있습니다.

OpenShift SDN 구성 예

defaultNetwork:
  type: OpenShiftSDN
  openshiftSDNConfig:
    mode: NetworkPolicy
    mtu: 1450
    vxlanPort: 4789

OVN-Kubernetes 네트워크 플러그인 구성

다음 표에서는 OVN-Kubernetes 네트워크 플러그인의 구성 필드를 설명합니다.

표 5.7. ovnKubernetesConfig object
필드	유형	설명
`mtu`	`integer`	Geneve(Generic Network Virtualization Encapsulation) 오버레이 네트워크의 MTU(최대 전송 단위)입니다. 이는 기본 네트워크 인터페이스의 MTU를 기준으로 자동 탐지됩니다. 일반적으로 감지된 MTU를 재정의할 필요는 없습니다. 자동 감지 값이 예상 밖인 경우 노드의 기본 네트워크 인터페이스의 MTU가 올바른지 확인합니다. 이 옵션을 사용하여 노드의 기본 네트워크 인터페이스의 MTU 값을 변경할 수 없습니다. 클러스터에 다른 노드에 대한 다른 MTU 값이 필요한 경우, 이 값을 클러스터의 가장 낮은 MTU 값보다 `100` 미만으로 설정해야 합니다. 예를 들어, 클러스터의 일부 노드에 `9001`의 MTU가 있고 일부에는 `1500`의 MTU가 있는 경우 이 값을 `1400`으로 설정해야 합니다.
`genevePort`	`integer`	모든 Geneve 패킷에 사용할 포트입니다. 기본값은 `6081`입니다. 클러스터를 설치한 후에는 이 값을 변경할 수 없습니다.
`ipsecConfig`	`object`	IPsec 암호화를 활성화하려면 빈 오브젝트를 지정합니다.
`policyAuditConfig`	`object`	네트워크 정책 감사 로깅을 사용자 정의할 구성 오브젝트를 지정합니다. 설정되지 않으면 기본값 감사 로그 설정이 사용됩니다.
`gatewayConfig`	`object`	선택 사항: 송신 트래픽이 노드 게이트웨이로 전송되는 방법을 사용자 정의할 구성 오브젝트를 지정합니다. 참고 송신 트래픽을 마이그레이션하는 동안 CNO(Cluster Network Operator)에서 변경 사항을 성공적으로 롤아웃할 때까지 워크로드 및 서비스 트래픽에 대한 일부 중단을 기대할 수 있습니다.
`v4InternalSubnet`	기존 네트워크 인프라가 `100.64.0.0/16` IPv4 서브넷과 겹치는 경우 OVN-Kubernetes에서 내부 사용을 위해 다른 IP 주소 범위를 지정할 수 있습니다. IP 주소 범위가 OpenShift Container Platform 설치에서 사용하는 다른 서브넷과 겹치지 않도록 해야 합니다. IP 주소 범위는 클러스터에 추가할 수 있는 최대 노드 수보다 커야 합니다. 예를 들어 `clusterNetwork.cidr` 값이 `10.128.0.0/14` 이고 `clusterNetwork.hostPrefix` 값이 `/23` 인 경우 최대 노드 수는 `2^(23-14)=512` 입니다. 설치 후에는 이 필드를 변경할 수 없습니다.	기본값은 `100.64.0.0/16` 입니다.
`v6InternalSubnet`	기존 네트워크 인프라가 `fd98::/48` IPv6 서브넷과 겹치는 경우 OVN-Kubernetes에서 내부 사용을 위해 다른 IP 주소 범위를 지정할 수 있습니다. IP 주소 범위가 OpenShift Container Platform 설치에서 사용하는 다른 서브넷과 겹치지 않도록 해야 합니다. IP 주소 범위는 클러스터에 추가할 수 있는 최대 노드 수보다 커야 합니다. 설치 후에는 이 필드를 변경할 수 없습니다.	기본값은 `fd98::/48` 입니다.

표 5.8. policyAuditConfig 오브젝트
필드	유형	설명
`rateLimit`	integer	노드당 1초마다 생성할 최대 메시지 수입니다. 기본값은 초당 `20` 개의 메시지입니다.
`maxFileSize`	integer	감사 로그의 최대 크기(바이트)입니다. 기본값은 `50000000` 또는 50MB입니다.
`대상`	string	다음 추가 감사 로그 대상 중 하나입니다. `libc` 호스트에서 journald 프로세스의 libc `syslog()` 함수입니다. `udp:<host>:<port>` syslog 서버입니다. `<host>:<port>`를 syslog 서버의 호스트 및 포트로 바꿉니다. `unix:<file>` `<file>`로 지정된 Unix Domain Socket 파일입니다. `null` 감사 로그를 추가 대상으로 보내지 마십시오.
`syslogFacility`	string	RFC5424에 정의된 `kern`과 같은 syslog 기능입니다. 기본값은 `local0`입니다.

표 5.9. gatewayConfig 오브젝트
필드	유형	설명
`routingViaHost`	`boolean`	Pod에서 호스트 네트워킹 스택으로 송신 트래픽을 보내려면 이 필드를 `true`로 설정합니다. 커널 라우팅 테이블에 수동으로 구성된 경로를 사용하는 고도의 전문 설치 및 애플리케이션의 경우 송신 트래픽을 호스트 네트워킹 스택으로 라우팅해야 할 수 있습니다. 기본적으로 송신 트래픽은 클러스터를 종료하기 위해 OVN에서 처리되며 커널 라우팅 테이블의 특수 경로의 영향을 받지 않습니다. 기본값은 `false`입니다. 이 필드는 Open vSwitch 하드웨어 오프로드 기능과 상호 작용합니다. 이 필드를 `true` 로 설정하면 송신 트래픽이 호스트 네트워킹 스택에서 처리되므로 오프로드의 성능 이점이 제공되지 않습니다.

IPSec가 활성화된 OVN-Kubernetes 구성의 예

defaultNetwork:
  type: OVNKubernetes
  ovnKubernetesConfig:
    mtu: 1400
    genevePort: 6081
    ipsecConfig: {}

kubeProxyConfig 오브젝트 구성

kubeProxyConfig 오브젝트의 값은 다음 표에 정의되어 있습니다.

표 5.10. kubeProxyConfig object
필드	유형	설명
`iptablesSyncPeriod`	`string`	`iptables` 규칙의 새로 고침 간격입니다. 기본값은 `30s`입니다. 유효 접미사로 `s`, `m`, `h`가 있으며, 자세한 설명은 Go `time` 패키지 문서를 참조하십시오. 참고 OpenShift Container Platform 4.3 이상에서는 성능이 개선되어 더 이상 `iptablesSyncPeriod` 매개변수를 조정할 필요가 없습니다.
`proxyArguments.iptables-min-sync-period`	`array`	`iptables` 규칙을 새로 고치기 전 최소 기간입니다. 이 필드를 통해 새로 고침 간격이 너무 짧지 않도록 조정할 수 있습니다. 유효 접미사로 `s`, `m`, `h`가 있으며, 자세한 설명은 Go `time` 패키지를 참조하십시오. 기본값은 다음과 같습니다. kubeProxyConfig: proxyArguments: iptables-min-sync-period: - 0s

5.7. 고급 네트워크 구성 지정

네트워크 플러그인의 고급 네트워크 구성을 사용하여 클러스터를 기존 네트워크 환경에 통합할 수 있습니다. 클러스터를 설치하기 전에만 고급 네트워크 구성을 지정할 수 있습니다.

중요

설치 프로그램에서 생성한 OpenShift Container Platform 매니페스트 파일을 수정하여 네트워크 구성을 사용자 정의하는 것은 지원되지 않습니다. 다음 절차에서와 같이 생성한 매니페스트 파일을 적용할 수 있습니다.

사전 요구 사항

install-config.yaml 파일을 생성하고 수정 작업을 완료했습니다.

프로세스

설치 프로그램이 포함된 디렉터리로 변경하고 매니페스트를 생성합니다.
```
$ ./openshift-install create manifests --dir <installation_directory> 1
```
1
<installation_directory>는 클러스터의 install-config.yaml 파일이 포함된 디렉터리의 이름을 지정합니다.
<installation_directory>/ manifests/ 디렉토리에 cluster-network-03-config.yml이라는 stub 매니페스트 파일을 만듭니다.
```
apiVersion: operator.openshift.io/v1
kind: Network
metadata:
  name: cluster
spec:
```

다음과 같이 cluster-network-03-config.yml 파일에서 클러스터의 고급 네트워크 구성을 지정합니다.

OpenShift SDN 네트워크 공급자에 대한 다른 VXLAN 포트 지정

apiVersion: operator.openshift.io/v1
kind: Network
metadata:
  name: cluster
spec:
  defaultNetwork:
    openshiftSDNConfig:
      vxlanPort: 4800

OVN-Kubernetes 네트워크 공급자의 IPsec 활성화

apiVersion: operator.openshift.io/v1
kind: Network
metadata:
  name: cluster
spec:
  defaultNetwork:
    ovnKubernetesConfig:
      ipsecConfig: {}

선택사항: manifests/cluster-network-03-config.yml 파일을 백업합니다. 설치 프로그램은 Ignition 구성 파일을 생성할 때 manifests/ 디렉터리를 사용합니다.

5.8. OVN-Kubernetes로 하이브리드 네트워킹 구성

OVN-Kubernetes에서 하이브리드 네트워킹을 사용하도록 클러스터를 구성할 수 있습니다. 이를 통해 다양한 노드 네트워킹 구성을 지원하는 하이브리드 클러스터를 사용할 수 있습니다. 예를 들어 클러스터에서 Linux 및 Windows 노드를 모두 실행하려면 이 작업이 필요합니다.

중요

클러스터를 설치하는 동안 OVN-Kubernetes를 사용하여 하이브리드 네트워킹을 구성해야 합니다. 설치 프로세스 후에는 하이브리드 네트워킹으로 전환할 수 없습니다.

사전 요구 사항

install-config.yaml 파일에 networking.networkType매개변수의 OVNKubernetes가 정의되어 있어야 합니다. 자세한 내용은 선택한 클라우드 공급자에서 OpenShift Container Platform 네트워크 사용자 정의 설정에 필요한 설치 문서를 참조하십시오.

프로세스

설치 프로그램이 포함된 디렉터리로 변경하고 매니페스트를 생성합니다.
```
$ ./openshift-install create manifests --dir <installation_directory>
```
다음과 같습니다.
<installation_directory>
클러스터의 install-config.yaml 파일이 포함된 디렉토리의 이름을 지정합니다.
<installation_directory>/ manifests/ 디렉토리에 cluster-network-03-config.yml이라는 stub 매니페스트 파일을 만듭니다.
```
$ cat <<EOF > <installation_directory>/manifests/cluster-network-03-config.yml
apiVersion: operator.openshift.io/v1
kind: Network
metadata:
  name: cluster
spec:
EOF
```
다음과 같습니다.
<installation_directory>
클러스터의 manifests/ 디렉터리가 포함된 디렉터리 이름을 지정합니다.
편집기에서 cluster-network-03-config.yml 파일을 열고 다음 예와 같이 하이브리드 네트워킹을 사용하여 OVN-Kubernetes를 구성합니다.
하이브리드 네트워킹 구성 지정
```
apiVersion: operator.openshift.io/v1
kind: Network
metadata:
  name: cluster
spec:
  defaultNetwork:
    ovnKubernetesConfig:
      hybridOverlayConfig:
        hybridClusterNetwork: 1
        - cidr: 10.132.0.0/14
          hostPrefix: 23
        hybridOverlayVXLANPort: 9898 2
```
1
추가 오버레이 네트워크의 노드에 사용되는 CIDR 구성을 지정합니다. hybridClusterNetwork CIDR은 clusterNetwork CIDR과 겹치지 않아야 합니다.
2
추가 오버레이 네트워크에 대한 사용자 정의 VXLAN 포트를 지정합니다. 이는 vSphere에 설치된 클러스터에서 Windows 노드를 실행해야 하며 다른 클라우드 공급자에 대해 구성해서는 안 됩니다. 사용자 정의 포트는 기본 4789 포트를 제외한 모든 오픈 포트일 수 있습니다. 이 요구 사항에 대한 자세한 내용은 호스트 간의 포드 투 포트 연결 중단에 대한 Microsoft 문서를 참조하십시오.
참고
Windows Server LTSC(Long-Term Servicing Channel): Windows Server 2019는 사용자 지정 hybridOverlayVXLANPort 값이 있는 클러스터에서 지원되지 않습니다. 이 Windows 서버 버전은 사용자 지정 VXLAN 포트를 선택하는 것을 지원하지 않기 때문입니다.
cluster-network-03-config.yml 파일을 저장하고 텍스트 편집기를 종료합니다.오.
선택사항: manifests/cluster-network-03-config.yml 파일을 백업합니다. 설치 프로그램은 클러스터를 생성할 때 manifests/ 디렉터리를 삭제합니다.

5.9. 클러스터 배포

호환되는 클라우드 플랫폼에 OpenShift Container Platform을 설치할 수 있습니다.

중요

최초 설치 과정에서 설치 프로그램의 create cluster 명령을 한 번만 실행할 수 있습니다.

사전 요구 사항

클러스터를 호스팅하는 클라우드 플랫폼으로 계정을 구성합니다.
OpenShift Container Platform 설치 프로그램과 클러스터의 풀 시크릿을 받습니다.
호스트의 클라우드 공급자 계정에 클러스터를 배포할 수 있는 올바른 권한이 있는지 확인합니다. 잘못된 권한이 있는 계정으로 인해 누락된 권한이 표시되는 오류 메시지와 함께 설치 프로세스가 실패합니다.

프로세스

설치 프로그램이 포함된 디렉터리로 변경하고 클러스터 배포를 초기화합니다.
```
$ ./openshift-install create cluster --dir <installation_directory> \ 1
    --log-level=info 2
```
1
<installation_directory> 값으로 사용자 지정한 ./install-config.yaml 파일의 위치를 지정합니다.
2
다른 설치 세부 사항을 보려면 info 대신 warn, debug 또는 error를 지정합니다.
참고
호스트에 구성된 클라우드 공급자 계정에 클러스터를 배포하기에 충분한 권한이 없는 경우, 설치 프로세스가 중단되고 누락된 권한을 알리는 메시지가 표시됩니다.

검증

클러스터 배포가 성공적으로 완료되면 다음을 수행합니다.

터미널에는 웹 콘솔에 대한 링크 및 kubeadmin 사용자의 인증 정보를 포함하여 클러스터에 액세스하는 지침이 표시됩니다.
인증 정보도 < installation_directory>/.openshift_install.log 로 출력합니다.

중요

설치 프로그램 또는 설치 프로그램이 생성하는 파일을 삭제하지 마십시오. 클러스터를 삭제하려면 두 가지가 모두 필요합니다.

출력 예

...
INFO Install complete!
INFO To access the cluster as the system:admin user when using 'oc', run 'export KUBECONFIG=/home/myuser/install_dir/auth/kubeconfig'
INFO Access the OpenShift web-console here: https://console-openshift-console.apps.mycluster.example.com
INFO Login to the console with user: "kubeadmin", and password: "password"
INFO Time elapsed: 36m22s

중요

설치 프로그램에서 생성하는 Ignition 구성 파일에 24시간 후에 만료되는 인증서가 포함되어 있습니다. 이 인증서는 그 후에 갱신됩니다. 인증서를 갱신하기 전에 클러스터가 종료되고 24시간이 지난 후에 클러스터가 다시 시작되면 클러스터는 만료된 인증서를 자동으로 복구합니다. 예외적으로 kubelet 인증서를 복구하려면 대기 중인 node-bootstrapper 인증서 서명 요청(CSR)을 수동으로 승인해야 합니다. 자세한 내용은 만료된 컨트롤 플레인 인증서에서 복구 문서를 참조하십시오.
24 시간 인증서는 클러스터를 설치한 후 16시간에서 22시간으로 인증서가 교체되기 때문에 생성된 후 12시간 이내에 Ignition 구성 파일을 사용하는 것이 좋습니다. 12시간 이내에 Ignition 구성 파일을 사용하면 설치 중에 인증서 업데이트가 실행되는 경우 설치 실패를 방지할 수 있습니다.

5.10. 바이너리를 다운로드하여 OpenShift CLI 설치

중요

Linux에서 OpenShift CLI 설치

다음 절차를 사용하여 Linux에서 OpenShift CLI(oc) 바이너리를 설치할 수 있습니다.

프로세스

Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
제품 변형 드롭다운 목록에서 아키텍처를 선택합니다.
버전 드롭다운 목록에서 적절한 버전을 선택합니다.
OpenShift v4.12 Linux Client 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.
아카이브의 압축을 풉니다.
```
$ tar xvf <file>
```
oc 바이너리를 PATH에 있는 디렉터리에 배치합니다.
PATH를 확인하려면 다음 명령을 실행합니다.
```
$ echo $PATH
```

검증

OpenShift CLI를 설치한 후 oc 명령을 사용할 수 있습니다.
```
$ oc <command>
```

Windows에서 OpenSfhit CLI 설치

다음 절차에 따라 Windows에 OpenShift CLI(oc) 바이너리를 설치할 수 있습니다.

프로세스

Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
버전 드롭다운 목록에서 적절한 버전을 선택합니다.
OpenShift v4.12 Windows Client 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.
ZIP 프로그램으로 아카이브의 압축을 풉니다.
oc 바이너리를 PATH에 있는 디렉터리로 이동합니다.
PATH를 확인하려면 명령 프롬프트를 열고 다음 명령을 실행합니다.
```
C:\> path
```

검증

OpenShift CLI를 설치한 후 oc 명령을 사용할 수 있습니다.
```
C:\> oc <command>
```

macOS에 OpenShift CLI 설치

다음 절차에 따라 macOS에서 OpenShift CLI(oc) 바이너리를 설치할 수 있습니다.

프로세스

Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
버전 드롭다운 목록에서 적절한 버전을 선택합니다.
OpenShift v4.12 macOS Client 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.
참고
macOS ARM64의 경우 OpenShift v4.12 macOS ARM64 Client 항목을 선택합니다.
아카이브의 압축을 해제하고 압축을 풉니다.
oc 바이너리 PATH의 디렉터리로 이동합니다.
PATH를 확인하려면 터미널을 열고 다음 명령을 실행합니다.
```
$ echo $PATH
```

검증

OpenShift CLI를 설치한 후 oc 명령을 사용할 수 있습니다.
```
$ oc <command>
```

5.11. CLI를 사용하여 클러스터에 로그인

사전 요구 사항

OpenShift Container Platform 클러스터를 배포했습니다.
oc CLI를 설치했습니다.

프로세스

kubeadmin 인증 정보를 내보냅니다.
```
$ export KUBECONFIG=<installation_directory>/auth/kubeconfig 1
```
1
<installation_directory>는 설치 파일을 저장한 디렉터리의 경로를 지정합니다.
내보낸 구성을 사용하여 oc 명령을 성공적으로 실행할 수 있는지 확인합니다.
```
$ oc whoami
```
출력 예
```
system:admin
```

5.12. 웹 콘솔을 사용하여 클러스터에 로그인

사전 요구 사항

설치 호스트에 대한 액세스 권한이 있어야 합니다.
클러스터 설치를 완료했으며 모든 클러스터 Operator를 사용할 수 있습니다.

프로세스

설치 호스트의 kubeadmin-password 파일에서 kubeadmin 사용자의 암호를 가져옵니다.
```
$ cat <installation_directory>/auth/kubeadmin-password
```
참고
대안으로 설치 호스트의 <installation_directory>/.openshift_install.log 로그 파일에서 kubeadmin 암호를 가져올 수 있습니다.
OpenShift Container Platform 웹 콘솔 경로를 나열합니다.
```
$ oc get routes -n openshift-console | grep 'console-openshift'
```
참고
대안으로 설치 호스트의 <installation_directory>/.openshift_install.log 로그 파일에서 OpenShift Container Platform 경로를 가져올 수 있습니다.
출력 예
```
console     console-openshift-console.apps.<cluster_name>.<base_domain>            console     https   reencrypt/Redirect   None
```
웹 브라우저의 이전 명령 출력에 자세히 설명된 경로로 이동하고 kubeadmin 사용자로 로그인합니다.

5.13. OpenShift Container Platform의 Telemetry 액세스

추가 리소스

Telemetry 서비스에 대한 자세한 내용은 원격 상태 모니터링 정보를 참조하십시오.
OpenShift Container Platform 웹 콘솔에 액세스 및 이해에 대한 자세한 내용은 웹 콘솔 액세스를 참조하십시오.
OpenShift Container Platform 웹 콘솔 액세스 및 이해에 대한 자세한 내용은 웹 콘솔 액세스를 참조하십시오.

5.14. 다음 단계

6장. Alibaba Cloud의 클러스터를 기존 VPC에 설치

OpenShift Container Platform 버전 4.12에서는 Alibaba Cloud Services의 기존 Alibaba VPC(Virtual Private Cloud)에 클러스터를 설치할 수 있습니다. 설치 프로그램은 필요한 인프라를 프로비저닝한 다음 사용자 지정할 수 있습니다. VPC 설치를 사용자 지정하려면 클러스터를 설치하기 전에 'install-config.yaml' 파일에서 매개변수를 수정합니다.

참고

중요

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

6.1. 사전 요구 사항

OpenShift Container Platform 설치 및 업데이트 프로세스에 대한 세부 사항을 검토했습니다.
클러스터 설치 방법 선택 및 사용자를 위한 준비에 대한 문서를 읽습니다.
도메인을 등록했습니다.
방화벽을 사용하는 경우 클러스터가 액세스해야 하는 사이트를 허용하도록 방화벽을 구성했습니다.
사용자의 환경에서 Cloud Resource Access Management(RAM) API에 액세스할 수 없거나 kube-system 네임스페이스에 관리자 수준의 인증 정보 시크릿을 저장하지 않으려면 수동으로 리소스 액세스 관리(RAM) 인증 정보를 생성 및 유지 관리할 수 있습니다.

6.2. 사용자 정의 VPC 사용

OpenShift Container Platform 4.12에서는 Alibaba Cloud Platform의 기존 VPC(Virtual Private Cloud)에 있는 기존 서브넷에 클러스터를 배포할 수 있습니다. 기존 Alibaba VPC에 OpenShift Container Platform을 배포하면 새 계정의 제한 조건을 방지하고 조직의 운영 제약 조건을 보다 쉽게 준수할 수 있습니다. VPC를 직접 생성하는 데 필요한 인프라 생성 권한을 받을 수 없는 경우 이 설치 옵션을 사용합니다. vSwitch를 사용하여 네트워킹을 구성해야 합니다.

6.2.1. VPC 사용 요구사항

VPC CIDR 블록과 시스템 네트워크 CIDR의 결합은 비어 있지 않아야 합니다. vSwitch는 시스템 네트워크 내에 있어야 합니다.

설치 프로그램에서 다음 구성 요소를 생성하지 않습니다.

VPC
vSwitches
라우팅 테이블
NAT 게이트웨이

참고

설치 프로그램을 사용하려면 클라우드 제공 DNS 서버를 사용해야 합니다. 사용자 지정 DNS 서버 사용은 지원되지 않으며 설치가 실패합니다.

6.2.2. VPC 검증

제공한 vSwitch가 적합한지 확인하기 위해 설치 프로그램에서 다음 데이터를 확인합니다.

지정한 모든 vSwitch가 있어야 합니다.
컨트롤 플레인 시스템 및 컴퓨팅 시스템에 대해 하나 이상의 vSwitch를 제공하고 있습니다.
vSwitch의 CIDR은 사용자가 지정한 시스템 CIDR에 속합니다.

6.2.3. 권한 분할

일부 사용자는 클라우드에 다른 리소스와 다른 리소스를 생성할 수 있습니다. 예를 들어 인스턴스, 버킷, 로드 밸런서와 같은 애플리케이션 관련 항목을 생성할 수 있지만 VPC 또는 vSwitch와 같은 네트워킹 관련 구성 요소는 생성할 수 없습니다.

6.2.4. 클러스터 간 격리

OpenShift Container Platform을 기존 네트워크에 배포하면 다음과 같은 방식으로 클러스터 서비스 격리가 줄어듭니다.

동일한 VPC에 여러 OpenShift Container Platform 클러스터를 설치할 수 있습니다.
ICMP 인그레스가 전체 네트워크에 허용됩니다.
TCP 22 인그레스(SSH)가 전체 네트워크에 허용됩니다.
컨트롤 플레인 TCP 6443 인그레스(Kubernetes API)가 전체 네트워크에 허용됩니다.
컨트롤 플레인 TCP 22623 인그레스(MCS)가 전체 네트워크에 허용됩니다.

6.3. OpenShift Container Platform 용 인터넷 액세스

OpenShift Container Platform 4.12에서 클러스터를 설치하려면 인터넷 액세스가 필요합니다.

다음의 경우 인터넷 액세스가 필요합니다.

OpenShift Cluster Manager Hybrid Cloud Console 에 액세스하여 설치 프로그램을 다운로드하고 서브스크립션 관리를 수행합니다. 클러스터가 인터넷에 액세스할 수 있고 Telemetry 서비스를 비활성화하지 않은 경우, 클러스터에 자동으로 권한이 부여됩니다.
Quay.io에 액세스. 클러스터를 설치하는 데 필요한 패키지를 받을 수 있습니다.
클러스터 업데이트를 수행하는 데 필요한 패키지를 받을 수 있습니다.

중요

6.4. 클러스터 노드 SSH 액세스를 위한 키 쌍 생성

중요

재해 복구 및 디버깅이 필요한 프로덕션 환경에서는이 단계를 생략하지 마십시오.

참고

AWS 키 쌍과 같이 플랫폼 고유의 방식으로 구성된 키가 아닌 로컬 키를 사용해야 합니다.

프로세스

로컬 시스템에 클러스터 노드의 인증에 사용할 기존 SSH 키 쌍이 없는 경우 새로 생성합니다. 예를 들어 Linux 운영 체제를 사용하는 컴퓨터에서 다음 명령을 실행합니다.
```
$ ssh-keygen -t ed25519 -N '' -f <path>/<file_name> 1
```
1
새 SSH 키의 경로 및 파일 이름(예: ~/.ssh/id_ed25519 )을 지정합니다. 기존 키 쌍이 있는 경우 공개 키가 '~/.ssh 디렉터리에 있는지 확인하십시오.
참고
x86_64,ppc64le, s390x 아키텍처에서 FIPS 검증 또는 진행중인 모듈 In Process 암호화 라이브러리를 사용하는 OpenShift Container Platform 클러스터를 설치하려면 ed25519 알고리즘을 사용하는 키를 생성하지 마십시오. 대신 rsa 또는 ecdsa 알고리즘을 사용하는 키를 생성합니다.
공개 SSH 키를 확인합니다.
```
$ cat <path>/<file_name>.pub
```
예를 들어 다음을 실행하여 ~/.ssh/id_ed25519.pub 공개 키를 확인합니다.
```
$ cat ~/.ssh/id_ed25519.pub
```
아직 추가되지 않은 경우 로컬 사용자의 SSH 에이전트에 SSH 개인 키 ID를 추가합니다. 키의 SSH 에이전트 관리는 클러스터 노드에 암호 없는 SSH 인증을 수행하거나 ./openshift-install gather 명령을 사용하려는 경우 필요합니다.
참고
일부 배포에서는 ~/.ssh/id_rsa 및 ~/.ssh/id_dsa와 같은 기본 SSH 개인 키 ID가 자동으로 관리됩니다.
1. ssh-agent 프로세스가 로컬 사용자에 대해 실행되지 않은 경우 백그라운드 작업으로 시작합니다.
```
$ eval "$(ssh-agent -s)"
```
  출력 예
```
Agent pid 31874
```
  참고
  클러스터가 FIPS 모드인 경우 FIPS 호환 알고리즘만 사용하여 SSH 키를 생성합니다. 키는 RSA 또는 ECDSA여야 합니다.
ssh-agent에 SSH 개인 키를 추가합니다.
```
$ ssh-add <path>/<file_name> 1
```
1
SSH 개인 키의 경로와 파일 이름을 지정합니다(예: ~/.ssh/id_ed25519).
출력 예
```
Identity added: /home/<you>/<path>/<file_name> (<computer_name>)
```

다음 단계

OpenShift Container Platform을 설치할 때 SSH 공개 키를 설치 프로그램에 지정합니다.

6.5. 설치 프로그램 받기

OpenShift Container Platform을 설치하기 전에 설치에 사용하는 호스트에 설치 파일을 다운로드합니다.

사전 요구 사항

500MB의 로컬 디스크 공간이 있는 Linux 또는 macOS를 실행하는 컴퓨터가 있습니다.

프로세스

OpenShift Cluster Manager 사이트의 인프라 공급자 페이지에 액세스합니다. Red Hat 계정이 있으면 사용자 자격 증명으로 로그인합니다. 계정이 없으면 계정을 만드십시오.
인프라 공급자를 선택합니다.
설치 유형 페이지로 이동하여 호스트 운영 체제 및 아키텍처에 해당하는 설치 프로그램을 다운로드하여 설치 구성 파일을 저장할 디렉터리에 파일을 배치합니다.
중요
설치 프로그램은 클러스터를 설치하는 데 사용하는 컴퓨터에 여러 파일을 만듭니다. 클러스터 설치를 마친 후 설치 프로그램과 설치 프로그램으로 생성되는 파일을 보관해야 합니다. 클러스터를 삭제하려면 두 파일이 모두 필요합니다.
중요
클러스터 설치에 실패하거나 설치 프로그램으로 만든 파일을 삭제해도 클러스터는 제거되지 않습니다. 클러스터를 제거하려면 해당 클라우드 공급자에 적용되는 OpenShift Container Platform 설치 제거 절차를 완료해야 합니다.
설치 프로그램 파일의 압축을 풉니다. 예를 들어 Linux 운영 체제를 사용하는 컴퓨터에서 다음 명령을 실행합니다.
```
$ tar -xvf openshift-install-linux.tar.gz
```
Red Hat OpenShift Cluster Manager에서 설치 풀 시크릿을 다운로드합니다. 이 풀 시크릿을 사용하면 OpenShift Container Platform 구성 요소에 대한 컨테이너 이미지를 제공하는 Quay.io를 포함하여 인증 기관에서 제공하는 서비스로 인증할 수 있습니다.

6.5.1. 설치 구성 파일 만들기

vGPU Cloud에 설치하는 OpenShift Container Platform 클러스터를 사용자 지정할 수 있습니다.

사전 요구 사항

OpenShift Container Platform 설치 프로그램과 클러스터의 풀 시크릿을 받습니다.
서브스크립션 수준에서 서비스 권한을 확보합니다.

프로세스

install-config.yaml 파일을 생성합니다.
1. 설치 프로그램이 포함된 디렉터리로 변경하고 다음 명령을 실행합니다.
```
$ ./openshift-install create install-config --dir <installation_directory> 1
```
  1
  <installation_directory>는 설치 프로그램이 생성하는 파일을 저장할 디렉터리 이름을 지정합니다.
  디렉터리를 지정할 때 다음을 수행합니다.
  - 디렉터리에 실행 권한이 있는지 확인합니다. 설치 디렉토리에서 Terraform 바이너리를 실행하려면 이 권한이 필요합니다.
  - 빈 디렉터리를 사용합니다. 부트스트랩 X.509 인증서와 같은 일부 설치 자산은 단기간에 만료되므로 설치 디렉터리를 재사용해서는 안 됩니다. 다른 클러스터 설치의 개별 파일을 재사용하려면 해당 파일을 사용자 디렉터리에 복사하면 됩니다. 그러나 설치 자산의 파일 이름은 릴리스간에 변경될 수 있습니다. 따라서 이전 OpenShift Container Platform 버전에서 설치 파일을 복사할 때는 주의하십시오.
2. 화면에 나타나는 지시에 따라 클라우드에 대한 구성 세부 사항을 입력합니다.
  1. 선택사항: 클러스터 시스템에 액세스하는 데 사용할 SSH 키를 선택합니다.
    참고
    설치 디버깅 또는 재해 복구를 수행하려는 프로덕션 OpenShift Container Platform 클러스터의 경우 ssh-agent 프로세스가 사용하는 SSH 키를 지정합니다.
  2. 대상 플랫폼으로 alibabacloud 를 선택합니다.
  3. 클러스터를 배포할 리전을 선택합니다.
  4. 클러스터를 배포할 기본 도메인을 선택합니다. 기본 도메인은 클러스터용으로 생성한 퍼블릭 DNS 영역에 해당합니다.
  5. 클러스터에 대한 설명이 포함된 이름을 입력합니다.
  6. Red Hat OpenShift Cluster Manager에서 풀 시크릿 을 붙여넣습니다.
RuntimeClass 클라우드에 클러스터를 설치하려면 CCO(Cloud Credential Operator)가 수동 모드에서 작동해야 합니다. install-config.yaml 파일을 수정하여 credentialsMode 매개변수를 Manual 로 설정합니다.
credentialsMode 가 Manual로 설정된 install-config.yaml 구성 파일의 예
```
apiVersion: v1
baseDomain: cluster1.example.com
credentialsMode: Manual 1
compute:
- architecture: amd64
  hyperthreading: Enabled
 ...
```
1
이 행을 추가하여 credentialsMode를 Manual로 설정합니다.
install-config.yaml 파일을 수정합니다. 사용 가능한 매개변수에 대한 자세한 정보는 “설치 구성 매개변수” 섹션에서 확인할 수 있습니다.
여러 클러스터를 설치하는 데 사용할 수 있도록 install-config.yaml 파일을 백업합니다.
중요
install-config.yaml 파일은 설치 과정에서 사용됩니다. 이 파일을 재사용하려면 지금 백업해야 합니다.

6.5.2. 설치 구성 매개변수

참고

설치한 후에는 install-config.yaml 파일에서 이러한 매개변수를 수정할 수 없습니다.

6.5.2.1. 필수 구성 매개변수

필수 설치 구성 매개변수는 다음 표에 설명되어 있습니다.

표 6.1. 필수 매개 변수
매개변수	설명	값
`apiVersion`	`install-config.yaml` 콘텐츠의 API 버전입니다. 현재 버전은 `v1`입니다. 설치 프로그램에서 이전 API 버전도 지원할 수 있습니다.	문자열
`baseDomain`	클라우드 공급자의 기본 도메인입니다. 기본 도메인은 OpenShift Container Platform 클러스터 구성 요소에 대한 경로를 생성하는 데 사용됩니다. 클러스터의 전체 DNS 이름은 `baseDomain`과 `metadata.name` 매개변수 값의 조합으로, `<metadata.name>.<baseDomain>` 형식입니다.	정규화된 도메인 또는 하위 도메인 이름(예: `example.com`).
`metadata`	Kubernetes 리소스 `ObjectMeta`로 `name` 매개변수만 사용합니다.	개체
`metadata.name`	클러스터의 이름입니다. 클러스터의 DNS 레코드는 `{{.metadata.name}}.{{. baseDomain}}` 형식의 모든 하위 도메인입니다.	소문자, 하이픈(`-`), 마침표(`.`)로 구성되는 문자열(예: `dev`)입니다.
`platform`	설치를 수행할 특정 플랫폼에 대한 구성: `alibabacloud`,aws ,`baremetal`,`azure`,`gcp`,`ibmcloud`,`nutanix`,`openstack`,`ovirt`,`vsphere`, `{}`. `platform.<platform>` 매개변수에 대한 자세한 내용은 다음 표에서 사용자 플랫폼에 해당하는 정보를 참조하십시오.	개체
`pullSecret`	Red Hat OpenShift Cluster Manager에서 풀 시크릿을 가져와서 Quay.io와 같은 서비스에서 OpenShift Container Platform 구성 요소의 컨테이너 이미지 다운로드를 인증합니다.	{ "auths":{ "cloud.openshift.com":{ "auth":"b3Blb=", "email":"you@example.com" }, "quay.io":{ "auth":"b3Blb=", "email":"you@example.com" } } }

6.5.2.2. 네트워크 구성 매개변수

IPv4 주소만 지원됩니다.

참고

표 6.2. 네트워크 매개변수
매개변수	설명	값
`networking`	클러스터의 네트워크의 구성입니다.	개체 참고 설치한 후에는 `networking` 오브젝트에서 지정된 매개변수를 수정할 수 없습니다.
`networking.networkType`	설치할 Red Hat OpenShift Networking 네트워크 플러그인입니다.	`OpenShiftSDN` 또는 `OVNKubernetes` 중 하나이며, `OpenShiftSDN` 은 모든 Linux 네트워크를 위한 CNI 플러그인입니다. `OVNKubernetes` 는 Linux 네트워크 및 하이브리드 네트워크용 CNI 플러그인으로, Linux 및 Windows 서버가 모두 포함됩니다. 기본값은 `OVNKubernetes` 입니다.
`networking.clusterNetwork`	Pod의 IP 주소 블록입니다. 기본값은 `10.128.0.0/14`이며, 호스트 접두사는 `/23`입니다. 여러 IP 주소 블록을 지정하는 경우 블록이 겹치지 않아야 합니다.	개체의 배열입니다. 예를 들면 다음과 같습니다. networking: clusterNetwork: - cidr: 10.128.0.0/14 hostPrefix: 23
`networking.clusterNetwork.cidr`	`networking.clusterNetwork`를 사용하는 경우 필수 항목입니다. IP 주소 블록입니다. IPv4 네트워크입니다.	CIDR(Classless Inter-Domain Routing) 표기법의 IP 주소 블록입니다. IPv4 블록의 접두사 길이는 `0` 에서 `32` 사이입니다.
`networking.clusterNetwork.hostPrefix`	개별 노드 각각에 할당할 서브넷 접두사 길이입니다. 예를 들어 `hostPrefix`를 `23`으로 설정하는 경우, 지정된 `cidr` 이외 `/23` 서브넷이 각 노드에 할당됩니다. `23`의 `hostPrefix` 값은 510(2^(32 - 23) - 2) Pod IP 주소를 제공합니다.	서브넷 접두사입니다. 기본값은 `23`입니다.
`networking.serviceNetwork`	서비스의 IP 주소 블록입니다. 기본값은 `172.30.0.0/16`입니다. OpenShift SDN 및 OVN-Kubernetes 네트워크 플러그인은 서비스 네트워크에 대한 단일 IP 주소 블록만 지원합니다.	CIDR 형식의 IP 주소 블록이 있는 어레이입니다. 예를 들면 다음과 같습니다. networking: serviceNetwork: - 172.30.0.0/16
`networking.machineNetwork`	시스템의 IP 주소 블록입니다. 여러 IP 주소 블록을 지정하는 경우 블록이 겹치지 않아야 합니다.	개체의 배열입니다. 예를 들면 다음과 같습니다. networking: machineNetwork: - cidr: 10.0.0.0/16
`networking.machineNetwork.cidr`	`networking.machineNetwork`를 사용하는 경우 필수 항목입니다. IP 주소 블록입니다. libvirt를 제외한 모든 플랫폼의 기본값은 `10.0.0.0/16`입니다. libvirt의 기본값은 `192.168.126.0/24`입니다.	CIDR 표기법의 IP 네트워크 블록입니다. 예: `10.0.0.0/16` 참고 기본 NIC가 상주하는 CIDR과 일치하도록 `networking.machineNetwork`를 설정합니다.

6.5.2.3. 선택적 구성 매개변수

선택적 설치 구성 매개변수는 다음 표에 설명되어 있습니다.

표 6.3. 선택적 매개변수
매개변수	설명	값
`additionalTrustBundle`	노드의 신뢰할 수 있는 인증서 스토리지에 추가되는 PEM 인코딩 X.509 인증서 번들입니다. 이 신뢰할 수 있는 번들은 프록시가 구성되었을 때에도 사용할 수 있습니다.	문자열
`capabilities`	선택적 핵심 클러스터 구성 요소의 설치를 제어합니다. 선택적 구성 요소를 비활성화하여 OpenShift Container Platform 클러스터의 설치 공간을 줄일 수 있습니다. 자세한 내용은 설치 의 "클러스터 기능" 페이지를 참조하십시오.	문자열 배열
`capabilities.baselineCapabilitySet`	활성화할 선택적 기능 세트를 선택합니다. 유효한 값은 `None`,`v4.11`,`v4.12` 및 `v Current` 입니다. 기본값은 `v current입니다`.	문자열
`capabilities.additionalEnabledCapabilities`	`baselineCapabilitySet` 에서 지정한 것 이상으로 선택적 기능 세트를 확장합니다. 이 매개변수에서 여러 기능을 지정할 수 있습니다.	문자열 배열
`compute`	컴퓨팅 노드를 구성하는 시스템의 구성입니다.	`MachinePool` 개체의 배열입니다.
`compute.architecture`	풀에 있는 시스템의 명령어 집합 아키텍처를 결정합니다. 현재 다양한 아키텍처가 있는 클러스터는 지원되지 않습니다. 모든 풀은 동일한 아키텍처를 지정해야 합니다. 유효한 값은 `amd64`(기본값)입니다.	문자열
`compute.hyperthreading`	컴퓨팅 시스템에서 동시 멀티스레딩 또는 `hyperthreading` 활성화 또는 비활성화 여부를 지정합니다. 시스템 코어의 성능을 높이기 위해 기본적으로 동시 멀티스레딩이 활성화됩니다. 중요 동시 멀티스레딩을 비활성화하는 경우 용량 계획에서 시스템 성능이 크게 저하될 수 있는 문제를 고려해야 합니다.	`Enabled` 또는 `Disabled`
`compute.name`	`compute`를 사용하는 경우 필수 항목입니다. 시스템 풀의 이름입니다.	`worker`
`compute.platform`	`compute`를 사용하는 경우 필수 항목입니다. 이 매개변수를 사용하여 작업자 시스템을 호스팅할 클라우드 공급자를 지정합니다. 이 매개변수 값은 `controlPlane.platform` 매개변수 값과 일치해야 합니다	`alibabacloud`,`aws`,`azure`,`gcp`,`ibmcloud`,`nutanix`,`openstack`,`ovirt`,`vsphere`, `{}`
`compute.replicas`	프로비저닝할 컴퓨팅 시스템(작업자 시스템이라고도 함) 수입니다.	`2` 이상의 양의 정수이며, 기본값은 `3`입니다.
`featureSet`	기능 세트를 위한 클러스터를 활성화합니다. 기능 세트는 기본적으로 활성화되어 있지 않은 OpenShift Container Platform 기능 컬렉션입니다. 설치 중에 기능 세트를 활성화하는 방법에 대한 자세한 내용은 "기능 게이트를 사용하여 기능 활성화"를 참조하십시오.	문자열. `TechPreviewNoUpgrade` 와 같이 활성화할 기능 세트의 이름입니다.
`controlPlane`	컨트롤 플레인을 구성하는 시스템들의 구성입니다.	`MachinePool` 개체의 배열입니다.
`controlPlane.architecture`	풀에 있는 시스템의 명령어 집합 아키텍처를 결정합니다. 현재 다양한 아키텍처가 있는 클러스터는 지원되지 않습니다. 모든 풀은 동일한 아키텍처를 지정해야 합니다. 유효한 값은 `amd64`(기본값)입니다.	문자열
`controlPlane.hyperthreading`	컨트롤 플레인 시스템에서 동시 멀티스레딩 또는 `hyperthreading` 활성화 또는 비활성화 여부를 지정합니다. 시스템 코어의 성능을 높이기 위해 기본적으로 동시 멀티스레딩이 활성화됩니다. 중요 동시 멀티스레딩을 비활성화하는 경우 용량 계획에서 시스템 성능이 크게 저하될 수 있는 문제를 고려해야 합니다.	`Enabled` 또는 `Disabled`
`controlPlane.name`	`controlPlane`을 사용하는 경우 필수 항목입니다. 시스템 풀의 이름입니다.	`master`
`controlPlane.platform`	`controlPlane`을 사용하는 경우 필수 항목입니다. 이 매개변수를 사용하여 컨트롤 플레인 시스템을 호스팅하는 클라우드 공급자를 지정합니다. 이 매개변수 값은 `compute.platform` 매개변수 값과 일치해야 합니다.	`alibabacloud`,`aws`,`azure`,`gcp`,`ibmcloud`,`nutanix`,`openstack`,`ovirt`,`vsphere`, `{}`
`controlPlane.replicas`	프로비저닝하는 컨트롤 플레인 시스템의 수입니다.	지원되는 유일한 값은 기본값인 `3`입니다.
`credentialsMode`	Cloud Credential Operator (CCO) 모드입니다. 모드가 지정되지 않은 경우 CCO는 여러 모드가 지원되는 플랫폼에서 Mint 모드가 우선으로 되어 지정된 인증 정보의 기능을 동적으로 확인하려고합니다. 참고 모든 클라우드 공급자에서 모든 CCO 모드가 지원되는 것은 아닙니다. CCO 모드에 대한 자세한 내용은 Cluster Operators 참조 콘텐츠의 Cloud Credential Operator 항목을 참조하십시오. 참고 AWS 계정에 서비스 제어 정책(SCP)이 활성화된 경우 `credentialsMode` 매개변수를 `Mint`,`Passthrough` 또는 `Manual` 로 구성해야 합니다.	`Mint`,`Passthrough`,`Manual` 또는 빈 문자열(`""`)
`fips`	FIPS 모드를 활성화 또는 비활성화합니다. 기본값은 `false`(비활성화)입니다. FIPS 모드가 활성화되면 OpenShift Container Platform이 실행되는 RHCOS(Red Hat Enterprise Linux CoreOS) 시스템에서 기본 Kubernetes 암호화 제품군은 우회하고 RHCOS와 함께 제공되는 암호화 모듈을 대신 사용합니다. 중요 클러스터의 FIPS 모드를 활성화하려면 FIPS 모드에서 작동하도록 구성된 RHEL(Red Hat Enterprise Linux) 컴퓨터에서 설치 프로그램을 실행해야 합니다. RHEL에서 FIPS 모드 구성에 대한 자세한 내용은 FIPS 모드에서 시스템 설치를 참조하십시오. FIPS 검증 또는 모듈 In Process 암호화 라이브러리 사용은 `x86_64`,`ppc64le` 및 `s390x` 아키텍처의 OpenShift Container Platform 배포에서만 지원됩니다. 참고 Azure File 스토리지를 사용하는 경우 FIPS 모드를 활성화할 수 없습니다.	`false` 또는 `true`
`imageContentSources`	릴리스 이미지 내용의 소스 및 리포지토리입니다.	개체의 배열입니다. 이 표의 다음 행에 설명된 대로 `source`와 `mirrors`(선택사항)가 포함됩니다.
`imageContentSources.source`	`imageContentSources`를 사용하는 경우 필수 항목입니다. 예를 들어 이미지 가져오기 사양에서 사용자가 가리키는 리포지토리를 지정합니다.	문자열
`imageContentSources.mirrors`	동일한 이미지를 포함할 수도 있는 하나 이상의 리포지토리를 지정합니다.	문자열 배열
`publish`	Kubernetes API, OpenShift 경로와 같이 클러스터의 사용자 끝점을 게시하거나 노출하는 방법입니다.	`Internal` 또는 `External`입니다. 기본값은 `External`입니다. 이 필드를 `Internal` 로 설정하는 것은 클라우드 이외의 플랫폼에서는 지원되지 않습니다. 중요 필드 값을 `Internal` 로 설정하면 클러스터가 작동하지 않습니다. 자세한 내용은 BZ#1953035를 참조하십시오.
`sshKey`	클러스터 시스템에 대한 액세스를 인증하는 SSH 키입니다. 참고 설치 디버깅 또는 재해 복구를 수행하려는 프로덕션 OpenShift Container Platform 클러스터의 경우 `ssh-agent` 프로세스가 사용하는 SSH 키를 지정합니다.	예를 들어 `sshKey: ssh-ed25519 AAAA`...

6.5.2.4. 추가 Alibaba Cloud 구성 매개변수

이러한 매개변수는 지정된 컴퓨팅 머신 및 컨트롤 플레인 시스템에 모두 적용됩니다.

참고

표 6.4. 선택 사항 Alibaba Cloud 매개변수
매개변수	설명	값
`compute.platform.alibabacloud.imageID`	ECS 인스턴스를 생성하는 데 사용되는 imageID입니다. ImageId는 클러스터와 동일한 리전에 속해야 합니다.	문자열.
`compute.platform.alibabacloud.instanceType`	instanceType은 ECS 인스턴스 유형을 정의합니다. 예: `ecs.g6.large`	문자열.
`compute.platform.alibabacloud.systemDiskCategory`	시스템 디스크의 범주를 정의합니다. 예: `cloud_efficiency`,`cloud_essd`	문자열.
`compute.platform.alibabacloud.systemDisksize`	시스템 디스크의 크기를 기가바이트(GiB)로 정의합니다.	정수.
`compute.platform.alibabacloud.zones`	사용할 수 있는 가용성 영역 목록입니다. 예: `cn-hangzhou-h` `cn-hangzhou-j`	문자열 목록.
`controlPlane.platform.alibabacloud.imageID`	ECS 인스턴스를 생성하는 데 사용되는 imageID입니다. ImageId는 클러스터와 동일한 리전에 속해야 합니다.	문자열.
`controlPlane.platform.alibabacloud.instanceType`	instanceType은 ECS 인스턴스 유형을 정의합니다. 예: `ecs.g6.xlarge`	문자열.
`controlPlane.platform.alibabacloud.systemDiskCategory`	시스템 디스크의 범주를 정의합니다. 예: `cloud_efficiency`,`cloud_essd`	문자열.
`controlPlane.platform.alibabacloud.systemDisksize`	시스템 디스크의 크기를 기가바이트(GiB)로 정의합니다.	정수.
`controlPlane.platform.alibabacloud.zones`	사용할 수 있는 가용성 영역 목록입니다. 예: `cn-hangzhou-h` `cn-hangzhou-j`	문자열 목록.
`platform.alibabacloud.region`	필수 항목입니다. 클러스터가 생성될 Alibaba Cloud 리전입니다.	문자열.
`platform.alibabacloud.resourceGroupID`	클러스터가 설치될 이미 존재하는 리소스 그룹의 ID입니다. 비어 있는 경우 설치 프로그램에서 클러스터에 대한 새 리소스 그룹을 생성합니다.	문자열.
`platform.alibabacloud.tags`	클러스터에 대해 생성된 모든 Alibaba Cloud 리소스에 적용되는 추가 키와 값입니다.	개체.
`platform.alibabacloud.vpcID`	클러스터를 설치해야 하는 기존 VPC의 ID입니다. 비어 있는 경우 설치 프로그램은 클러스터에 대한 새 VPC를 생성합니다.	문자열.
`platform.alibabacloud.vswitchIDs`	클러스터 리소스가 생성될 기존 VSwitch의 ID 목록입니다. 기존 VSwitch는 기존 VPC를 사용하는 경우에만 사용할 수 있습니다. 비어 있는 경우 설치 프로그램에서 클러스터에 대한 새 VSwitch를 만듭니다.	문자열 목록.
`platform.alibabacloud.defaultMachinePlatform.imageID`	컴퓨팅 시스템 및 컨트롤 플레인 시스템 모두에서 ECS 인스턴스를 생성하는 데 사용해야 하는 이미지 ID입니다. 설정된 경우 이미지 ID는 클러스터와 동일한 리전에 속해야 합니다.	문자열.
`platform.alibabacloud.defaultMachinePlatform.instanceType`	컴퓨팅 시스템 및 컨트롤 플레인 시스템 모두에서 ECS 인스턴스를 생성하는 데 사용되는 ECS 인스턴스 유형입니다. 예: `ecs.g6.xlarge`	문자열.
`platform.alibabacloud.defaultMachinePlatform.systemDiskCategory`	컴퓨팅 시스템 및 컨트롤 플레인 시스템의 경우 시스템 디스크의 범주입니다. 예: `cloud_efficiency`,`cloud_essd`.	문자열(예: "", `cloud_efficiency`,`cloud_essd` ).
`platform.alibabacloud.defaultMachinePlatform.systemDiskSize`	컴퓨팅 시스템 및 컨트롤 플레인 시스템의 경우 시스템 디스크 크기(GiB)입니다. 최소는 `120` 입니다.	정수.
`platform.alibabacloud.defaultMachinePlatform.zones`	컴퓨팅 시스템 및 컨트롤 플레인 시스템 모두 사용할 수 있는 가용성 영역 목록입니다. 예: `cn-hangzhou-h` `cn-hangzhou-j`	문자열 목록.
`platform.alibabacloud.privateZoneID`	클러스터의 내부 API에 대한 DNS 레코드를 추가할 기존 프라이빗 영역의 ID입니다. 기존 프라이빗 영역은 기존 VPC를 사용하는 경우에만 사용할 수 있습니다. 프라이빗 영역은 서브넷이 포함된 VPC와 연결되어 있어야 합니다. 설치 프로그램이 사용자를 대신하여 프라이빗 영역을 생성하도록 프라이빗 영역을 설정되지 않은 상태로 둡니다.	문자열.

6.5.3. Alibaba Cloud에 대한 샘플 사용자 지정 install-config.yaml 파일

설치 구성 파일(install-config.yaml)을 사용자 지정하여 클러스터 플랫폼에 대한 자세한 정보를 지정하거나 필수 매개변수 값을 수정할 수 있습니다.

apiVersion: v1
baseDomain: alicloud-dev.devcluster.openshift.com
credentialsMode: Manual
compute:
- architecture: amd64
  hyperthreading: Enabled
  name: worker
  platform: {}
  replicas: 3
controlPlane:
  architecture: amd64
  hyperthreading: Enabled
  name: master
  platform: {}
  replicas: 3
metadata:
  creationTimestamp: null
  name: test-cluster 1
 networking:
  clusterNetwork:
  - cidr: 10.128.0.0/14
    hostPrefix: 23
  machineNetwork:
  - cidr: 10.0.0.0/16
  networkType: OVNKubernetes 2
  serviceNetwork:
  - 172.30.0.0/16
platform:
  alibabacloud:
    defaultMachinePlatform: 3
      instanceType: ecs.g6.xlarge
      systemDiskCategory: cloud_efficiency
      systemDiskSize: 200
    region: ap-southeast-1 4
    resourceGroupID: rg-acfnw6j3hyai 5
    vpcID: vpc-0xifdjerdibmaqvtjob2b 6
    vswitchIDs: 7
    - vsw-0xi8ycgwc8wv5rhviwdq5
    - vsw-0xiy6v3z2tedv009b4pz2
publish: External
pullSecret: '{"auths": {"cloud.openshift.com": {"auth": ... }' 8
sshKey: |
  ssh-rsa AAAA... 9

1: 필수 항목입니다. 설치 프로그램에서 클러스터 이름을 입력하라는 메시지를 표시합니다.
2: 설치할 클러스터 네트워크 플러그인입니다. 지원되는 값은 OVNKubernetes 및 OpenShiftSDN 입니다. 기본값은 OVNKubernetes 입니다.
3: 선택 사항: 자체 플랫폼 구성을 정의하지 않는 머신 풀에 대한 매개변수를 지정합니다.
4: 필수 항목입니다. 설치 프로그램에서 클러스터를 배포할 리전을 묻는 메시지를 표시합니다.
5: 선택 사항: 클러스터를 설치해야 하는 기존 리소스 그룹을 지정합니다.
8: 필수 항목입니다. 설치 프로그램에서 가져오기 시크릿을 묻는 메시지를 표시합니다.
9: 선택 사항: 설치 프로그램에서 클러스터의 시스템에 액세스하는 데 사용하는 SSH 키 값을 입력하라는 메시지를 표시합니다.
6 7: 선택 사항: 다음은 예제 vswitchID 값입니다.

6.5.4. 필요한 설치 매니페스트 생성

클러스터가 머신을 구성하는 데 필요한 Kubernetes 매니페스트 및 Ignition 구성 파일을 생성해야 합니다.

프로세스

설치 프로그램이 포함된 디렉터리에서 다음 명령을 실행하여 매니페스트를 생성합니다.
```
$ openshift-install create manifests --dir <installation_directory>
```
다음과 같습니다.
<installation_directory>
설치 프로그램이 파일을 생성하는 디렉터리를 지정합니다.

6.5.5. Cloud Credential Operator 유틸리티 구성

CCO(Cloud Credential Operator)가 수동 모드에서 작동할 때 클러스터 외부에서 클라우드 인증 정보를 생성하고 관리하려면 CCO 유틸리티(ccoctl) 바이너리를 추출 및 준비합니다.

참고

ccoctl 유틸리티는 Linux 환경에서 실행해야 하는 Linux 바이너리입니다.

사전 요구 사항

클러스터 관리자 액세스 권한이 있는 OpenShift Container Platform 계정에 액세스할 수 있습니다.
OpenShift CLI(oc)가 설치되어 있습니다.

프로세스

다음 명령을 실행하여 OpenShift Container Platform 릴리스 이미지를 가져옵니다.
```
$ RELEASE_IMAGE=$(./openshift-install version | awk '/release image/ {print $3}')
```
다음 명령을 실행하여 OpenShift Container Platform 릴리스 이미지에서 CCO 컨테이너 이미지를 가져옵니다.
```
$ CCO_IMAGE=$(oc adm release info --image-for='cloud-credential-operator' $RELEASE_IMAGE -a ~/.pull-secret)
```
참고
$RELEASE_IMAGE 의 아키텍처가 ccoctl 툴을 사용할 환경의 아키텍처와 일치하는지 확인합니다.
다음 명령을 실행하여 OpenShift Container Platform 릴리스 이미지 내에서 ccoctl 바이너리를 추출합니다.
```
$ oc image extract $CCO_IMAGE --file="/usr/bin/ccoctl" -a ~/.pull-secret
```
다음 명령을 실행하여 ccoctl 을 실행할 수 있도록 권한을 변경합니다.
```
$ chmod 775 ccoctl
```

검증

ccoctl 을 사용할 준비가 되었는지 확인하려면 다음 명령을 실행하여 도움말 파일을 표시합니다.

$ ccoctl --help

ccoctl --help의 출력

OpenShift credentials provisioning tool

Usage:
  ccoctl [command]

Available Commands:
  alibabacloud Manage credentials objects for alibaba cloud
  aws          Manage credentials objects for AWS cloud
  gcp          Manage credentials objects for Google cloud
  help         Help about any command
  ibmcloud     Manage credentials objects for IBM Cloud
  nutanix      Manage credentials objects for Nutanix

Flags:
  -h, --help   help for ccoctl

Use "ccoctl [command] --help" for more information about a command.

6.5.6. ccoctl 툴을 사용하여 OpenShift Container Platform 구성 요소의 인증 정보 생성

참고

사전 요구 사항

다음이 있어야 합니다.

ccoctl 바이너리를 추출하여 준비합니다.
OpenShift Container Platform 클러스터를 생성할 수 있는 충분한 권한이 있는 RAM 사용자가 생성되어 있어야 합니다.
해당 RAM 사용자의 AccessKeyID (access_key_id) 및 AccessKeySecret (access_key_secret)을 로컬 컴퓨터의 ~/.alibabacloud/credentials 파일에 추가했습니다.

프로세스

다음 명령을 실행하여 $RELEASE_IMAGE 변수를 설정합니다.

$ RELEASE_IMAGE=$(./openshift-install version | awk '/release image/ {print $3}')

다음 명령을 실행하여 OpenShift Container Platform 릴리스 이미지에서 CredentialsRequest 오브젝트 목록을 추출합니다.
```
$ oc adm release extract \
--credentials-requests \
--cloud=alibabacloud \
--to=<path_to_directory_with_list_of_credentials_requests>/credrequests \ 1
$RELEASE_IMAGE
```
1
credrequests 는 CredentialsRequest 오브젝트 목록이 저장되는 디렉터리입니다. 이 명령은 디렉터리가 없는 경우 해당 디렉터리를 생성합니다.
참고
이 명령을 실행하는 데 시간이 다소 걸릴 수 있습니다.
클러스터에서 클러스터 기능을 사용하여 하나 이상의 선택적 구성 요소를 비활성화하는 경우 비활성화된 구성 요소에 대한 CredentialsRequest 사용자 정의 리소스를 삭제합니다.
Alibaba Cloud에서 OpenShift Container Platform 4.12의 credrequests 디렉터리 콘텐츠 예
```
0000_30_machine-api-operator_00_credentials-request.yaml 1
0000_50_cluster-image-registry-operator_01-registry-credentials-request-alibaba.yaml 2
0000_50_cluster-ingress-operator_00-ingress-credentials-request.yaml 3
0000_50_cluster-storage-operator_03_credentials_request_alibaba.yaml 4
```
1
Machine API Operator CR이 필요합니다.
2
Image Registry Operator CR이 필요합니다.
3
Ingress Operator CR이 필요합니다.
4
Storage Operator CR은 선택적 구성 요소이며 클러스터에서 비활성화될 수 있습니다.
ccoctl 툴을 사용하여 redrequests 디렉터리의 모든 CredentialsRequest 오브젝트를 처리합니다.
1. 툴을 사용하려면 다음 명령을 실행합니다.
```
$ ccoctl alibabacloud create-ram-users \
--name <name> \
--region=<alibaba_region> \
--credentials-requests-dir=<path_to_directory_with_list_of_credentials_requests>/credrequests \
--output-dir=<path_to_ccoctl_output_dir>
```
  다음과 같습니다.
  - <name>은 추적을 위해 생성된 클라우드 리소스에 태그를 지정하는 데 사용되는 이름입니다.
  - <alibaba_region>은 클라우드 리소스가 생성될 Alibaba Cloud 지역입니다.
  - <path_to_directory_with_list_of_credentials_requests>/credrequests는 CredentialsRequest 개체의 파일이 포함된 디렉터리입니다.
  - <path_to_ccoctl_output_dir>은 생성된 구성 요소 인증 정보 시크릿을 배치할 디렉터리입니다.
  참고
  클러스터에서 TechPreviewNoUpgrade 기능 세트에서 활성화한 기술 프리뷰 기능을 사용하는 경우 --enable-tech-preview 매개변수를 포함해야 합니다.
  출력 예
```
2022/02/11 16:18:26 Created RAM User: user1-alicloud-openshift-machine-api-alibabacloud-credentials
2022/02/11 16:18:27 Ready for creating new ram policy user1-alicloud-openshift-machine-api-alibabacloud-credentials-policy-policy
2022/02/11 16:18:27 RAM policy user1-alicloud-openshift-machine-api-alibabacloud-credentials-policy-policy has created
2022/02/11 16:18:28 Policy user1-alicloud-openshift-machine-api-alibabacloud-credentials-policy-policy has attached on user user1-alicloud-openshift-machine-api-alibabacloud-credentials
2022/02/11 16:18:29 Created access keys for RAM User: user1-alicloud-openshift-machine-api-alibabacloud-credentials
2022/02/11 16:18:29 Saved credentials configuration to: user1-alicloud/manifests/openshift-machine-api-alibabacloud-credentials-credentials.yaml
...
```
  참고
  RAM 사용자는 두 개의 AccessKey를 동시에 가질 수 있습니다. ccoctl alibabacloud create-ram-users를 두 번 이상 실행하면 이전에 생성된 매니페스트 시크릿이 오래되어 새로 생성된 시크릿을 다시 적용해야 합니다.
2. OpenShift Container Platform 시크릿이 생성되었는지 확인합니다.
```
$ ls <path_to_ccoctl_output_dir>/manifests
```
  출력 예:
```
openshift-cluster-csi-drivers-alibaba-disk-credentials-credentials.yaml
openshift-image-registry-installer-cloud-credentials-credentials.yaml
openshift-ingress-operator-cloud-credentials-credentials.yaml
openshift-machine-api-alibabacloud-credentials-credentials.yaml
```
  Alibaba Cloud를 쿼리하여 RAM 사용자 및 정책의 생성 여부를 확인할 수 있습니다. 자세한 내용은 RAM 사용자 및 정책을 나열에 대한 Alibaba Cloud 문서를 참조하십시오.
생성된 자격 증명 파일을 대상 매니페스트 디렉터리에 복사합니다.
```
$ cp ./<path_to_ccoctl_output_dir>/manifests/*credentials.yaml ./<path_to_installation>dir>/manifests/
```
다음과 같습니다.
<path_to_ccoctl_output_dir>
ccoctl alibabacloud create-ram-users 명령으로 생성된 디렉터리를 지정합니다.
<path_to_installation_dir>
설치 프로그램이 파일을 생성하는 디렉터리를 지정합니다.

6.6. 클러스터 배포

호환되는 클라우드 플랫폼에 OpenShift Container Platform을 설치할 수 있습니다.

중요

최초 설치 과정에서 설치 프로그램의 create cluster 명령을 한 번만 실행할 수 있습니다.

사전 요구 사항

클러스터를 호스팅하는 클라우드 플랫폼으로 계정을 구성합니다.
OpenShift Container Platform 설치 프로그램과 클러스터의 풀 시크릿을 받습니다.
호스트의 클라우드 공급자 계정에 클러스터를 배포할 수 있는 올바른 권한이 있는지 확인합니다. 잘못된 권한이 있는 계정으로 인해 누락된 권한이 표시되는 오류 메시지와 함께 설치 프로세스가 실패합니다.

프로세스

설치 프로그램이 포함된 디렉터리로 변경하고 클러스터 배포를 초기화합니다.
```
$ ./openshift-install create cluster --dir <installation_directory> \ 1
    --log-level=info 2
```
1
<installation_directory> 값으로 사용자 지정한 ./install-config.yaml 파일의 위치를 지정합니다.
2
다른 설치 세부 사항을 보려면 info 대신 warn, debug 또는 error를 지정합니다.
참고
호스트에 구성된 클라우드 공급자 계정에 클러스터를 배포하기에 충분한 권한이 없는 경우, 설치 프로세스가 중단되고 누락된 권한을 알리는 메시지가 표시됩니다.

검증

클러스터 배포가 성공적으로 완료되면 다음을 수행합니다.

터미널에는 웹 콘솔에 대한 링크 및 kubeadmin 사용자의 인증 정보를 포함하여 클러스터에 액세스하는 지침이 표시됩니다.
인증 정보도 < installation_directory>/.openshift_install.log 로 출력합니다.

중요

설치 프로그램 또는 설치 프로그램이 생성하는 파일을 삭제하지 마십시오. 클러스터를 삭제하려면 두 가지가 모두 필요합니다.

출력 예

...
INFO Install complete!
INFO To access the cluster as the system:admin user when using 'oc', run 'export KUBECONFIG=/home/myuser/install_dir/auth/kubeconfig'
INFO Access the OpenShift web-console here: https://console-openshift-console.apps.mycluster.example.com
INFO Login to the console with user: "kubeadmin", and password: "password"
INFO Time elapsed: 36m22s

중요

설치 프로그램에서 생성하는 Ignition 구성 파일에 24시간 후에 만료되는 인증서가 포함되어 있습니다. 이 인증서는 그 후에 갱신됩니다. 인증서를 갱신하기 전에 클러스터가 종료되고 24시간이 지난 후에 클러스터가 다시 시작되면 클러스터는 만료된 인증서를 자동으로 복구합니다. 예외적으로 kubelet 인증서를 복구하려면 대기 중인 node-bootstrapper 인증서 서명 요청(CSR)을 수동으로 승인해야 합니다. 자세한 내용은 만료된 컨트롤 플레인 인증서에서 복구 문서를 참조하십시오.
24 시간 인증서는 클러스터를 설치한 후 16시간에서 22시간으로 인증서가 교체되기 때문에 생성된 후 12시간 이내에 Ignition 구성 파일을 사용하는 것이 좋습니다. 12시간 이내에 Ignition 구성 파일을 사용하면 설치 중에 인증서 업데이트가 실행되는 경우 설치 실패를 방지할 수 있습니다.

6.7. 바이너리를 다운로드하여 OpenShift CLI 설치

중요

Linux에서 OpenShift CLI 설치

다음 절차를 사용하여 Linux에서 OpenShift CLI(oc) 바이너리를 설치할 수 있습니다.

프로세스

Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
제품 변형 드롭다운 목록에서 아키텍처를 선택합니다.
버전 드롭다운 목록에서 적절한 버전을 선택합니다.
OpenShift v4.12 Linux Client 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.
아카이브의 압축을 풉니다.
```
$ tar xvf <file>
```
oc 바이너리를 PATH에 있는 디렉터리에 배치합니다.
PATH를 확인하려면 다음 명령을 실행합니다.
```
$ echo $PATH
```

검증

OpenShift CLI를 설치한 후 oc 명령을 사용할 수 있습니다.
```
$ oc <command>
```

Windows에서 OpenSfhit CLI 설치

다음 절차에 따라 Windows에 OpenShift CLI(oc) 바이너리를 설치할 수 있습니다.

프로세스

Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
버전 드롭다운 목록에서 적절한 버전을 선택합니다.
OpenShift v4.12 Windows Client 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.
ZIP 프로그램으로 아카이브의 압축을 풉니다.
oc 바이너리를 PATH에 있는 디렉터리로 이동합니다.
PATH를 확인하려면 명령 프롬프트를 열고 다음 명령을 실행합니다.
```
C:\> path
```

검증

OpenShift CLI를 설치한 후 oc 명령을 사용할 수 있습니다.
```
C:\> oc <command>
```

macOS에 OpenShift CLI 설치

다음 절차에 따라 macOS에서 OpenShift CLI(oc) 바이너리를 설치할 수 있습니다.

프로세스

Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
버전 드롭다운 목록에서 적절한 버전을 선택합니다.
OpenShift v4.12 macOS Client 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.
참고
macOS ARM64의 경우 OpenShift v4.12 macOS ARM64 Client 항목을 선택합니다.
아카이브의 압축을 해제하고 압축을 풉니다.
oc 바이너리 PATH의 디렉터리로 이동합니다.
PATH를 확인하려면 터미널을 열고 다음 명령을 실행합니다.
```
$ echo $PATH
```

검증

OpenShift CLI를 설치한 후 oc 명령을 사용할 수 있습니다.
```
$ oc <command>
```

6.8. CLI를 사용하여 클러스터에 로그인

사전 요구 사항

OpenShift Container Platform 클러스터를 배포했습니다.
oc CLI를 설치했습니다.

프로세스

kubeadmin 인증 정보를 내보냅니다.
```
$ export KUBECONFIG=<installation_directory>/auth/kubeconfig 1
```
1
<installation_directory>는 설치 파일을 저장한 디렉터리의 경로를 지정합니다.
내보낸 구성을 사용하여 oc 명령을 성공적으로 실행할 수 있는지 확인합니다.
```
$ oc whoami
```
출력 예
```
system:admin
```

6.9. 웹 콘솔을 사용하여 클러스터에 로그인

사전 요구 사항

설치 호스트에 대한 액세스 권한이 있어야 합니다.
클러스터 설치를 완료했으며 모든 클러스터 Operator를 사용할 수 있습니다.

프로세스

설치 호스트의 kubeadmin-password 파일에서 kubeadmin 사용자의 암호를 가져옵니다.
```
$ cat <installation_directory>/auth/kubeadmin-password
```
참고
대안으로 설치 호스트의 <installation_directory>/.openshift_install.log 로그 파일에서 kubeadmin 암호를 가져올 수 있습니다.
OpenShift Container Platform 웹 콘솔 경로를 나열합니다.
```
$ oc get routes -n openshift-console | grep 'console-openshift'
```
참고
대안으로 설치 호스트의 <installation_directory>/.openshift_install.log 로그 파일에서 OpenShift Container Platform 경로를 가져올 수 있습니다.
출력 예
```
console     console-openshift-console.apps.<cluster_name>.<base_domain>            console     https   reencrypt/Redirect   None
```
웹 브라우저의 이전 명령 출력에 자세히 설명된 경로로 이동하고 kubeadmin 사용자로 로그인합니다.

6.10. OpenShift Container Platform의 Telemetry 액세스

추가 리소스

Telemetry 서비스에 대한 자세한 내용은 원격 상태 모니터링 정보를 참조하십시오.
OpenShift Container Platform 웹 콘솔에 액세스 및 이해에 대한 자세한 내용은 웹 콘솔 액세스를 참조하십시오.

6.11. 다음 단계

7장. Alibaba Cloud에서 클러스터 설치 제거

Alibaba Cloud에 배포한 클러스터를 제거할 수 있습니다.

7.1. 설치 관리자가 프로비저닝한 인프라를 사용하는 클러스터 제거

클라우드에서 설치 관리자 프로비저닝 인프라를 사용하는 클러스터를 제거할 수 있습니다.

참고

설치 제거 후 특히 사용자 프로비저닝 인프라 클러스터에서 제거되지 않은 리소스에 대해 클라우드 공급자를 확인합니다. 설치 프로그램이 생성하지 않았거나 설치 프로그램이 액세스할 수 없는 리소스가 있을 수 있습니다.

사전 요구 사항

클러스터를 배포하는 데 사용한 설치 프로그램의 사본이 있습니다.
클러스터를 생성할 때 설치 프로그램에서 생성한 파일이 있습니다.

프로세스

클러스터를 설치하는 데 사용한 컴퓨터에서 설치 프로그램이 포함된 디렉터리로 이동하고 다음 명령을 실행합니다.
```
$ ./openshift-install destroy cluster \
--dir <installation_directory> --log-level info 1 2
```
1
<installation_directory>는 설치 파일을 저장한 디렉터리의 경로를 지정합니다.
2
다른 세부 사항을 보려면 info 대신 warn, debug 또는 error를 지정합니다.
참고
클러스터의 클러스터 정의 파일이 포함되어 있는 디렉터리를 지정해야 합니다. 설치 프로그램이 클러스터를 삭제하려면 이 디렉터리에 있는 metadata.json 파일이 필요합니다.
선택사항: <installation_directory> 디렉토리와 OpenShift Container Platform 설치 프로그램을 삭제합니다.

Legal Notice

OpenShift documentation is licensed under the Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0).

Modified versions must remove all Red Hat trademarks.

Portions adapted from https://github.com/kubernetes-incubator/service-catalog/ with modifications by Red Hat.

Red Hat, Red Hat Enterprise Linux, the Red Hat logo, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.

Linux® is the registered trademark of Linus Torvalds in the United States and other countries.

Java® is a registered trademark of Oracle and/or its affiliates.

XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.

MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.

Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.

The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation’s permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.

All other trademarks are the property of their respective owners.