4장. 사용자 지정으로 Google Cloud에 클러스터 설치
OpenShift Container Platform 버전 5.0에서는 설치 관리자 프로비저닝 인프라를 사용하여 사용자 지정으로 Google Cloud에 클러스터를 설치할 수 있습니다. 설치 전에 install-config.yaml 파일에서 매개변수를 수정하여 환경과 일치하도록 클러스터를 사용자 지정합니다.
네트워크 구성을 사용자 지정할 경우, 클러스터가 사용자 환경의 기존 IP 주소 할당과 공존하고 기존 MTU 및 VXLAN 구성과 통합될 수 있습니다.
설치 과정에서 네트워크 구성 매개변수를 대부분 설정해야 하며, 실행 중인 클러스터에서는 kubeProxy 구성 매개변수만 수정할 수 있습니다.
4.1. 사전 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
사용자 지정으로 Google Cloud에 OpenShift Container Platform 클러스터를 설치하기 전에 환경이 특정 인프라 및 액세스 요구 사항을 충족해야 합니다.
- OpenShift Container Platform 설치 및 업데이트 프로세스에 대한 세부 사항을 검토했습니다. 자세한 내용은 "설치 및 업데이트"를 참조하십시오.
- 클러스터 설치 방법을 선택하고 사용자를 위해 준비합니다. 자세한 내용은 "클러스터 설치 방법 선택 및 사용자를 위한 준비"를 참조하십시오.
- 클러스터를 호스팅할 Google Cloud 프로젝트를 구성했습니다. 자세한 내용은 "Google Cloud 프로젝트 구성"을 참조하십시오.
- 방화벽을 사용하는 경우 클러스터가 액세스해야 하는 사이트를 허용하도록 방화벽을 구성했습니다. 자세한 내용은 "OpenShift Container Platform용 방화벽 구성"을 참조하십시오.
4.2. OpenShift Container Platform 용 인터넷 액세스 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 5.0에서 클러스터를 설치하려면 인터넷 액세스가 필요합니다.
다음 작업을 수행하려면 인터넷 액세스가 있어야 합니다.
- Red Hat Hybrid Cloud Console 에 액세스하여 설치 프로그램을 다운로드하고 서브스크립션 관리를 수행합니다. 클러스터가 인터넷에 액세스할 수 있고 Telemetry 서비스를 비활성화하지 않은 경우, 클러스터에 자동으로 권한이 부여됩니다.
- Quay.io 에 액세스. 클러스터를 설치하는 데 필요한 패키지를 받을 수 있습니다.
- 클러스터 업데이트를 수행하는 데 필요한 패키지를 받을 수 있습니다.
클러스터가 직접 인터넷에 액세스할 수 없는 경우, 프로비저닝하는 일부 유형의 인프라에서 제한된 네트워크 설치를 수행할 수 있습니다. 이 프로세스 동안 필요한 콘텐츠를 다운로드하고 이를 사용하여 설치 패키지로 미러 레지스트리를 채웁니다. 설치 유형에 따라서는 클러스터를 설치하는 환경에 인터넷 액세스가 필요하지 않을 수도 있습니다. 클러스터를 업데이트하기 전에 미러 레지스트리의 내용을 업데이트합니다.
4.3. 클러스터 노드 SSH 액세스를 위한 키 쌍 생성 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform을 설치하는 동안 SSH 공개 키를 설치 프로그램에 지정할 수 있습니다. 키는 Ignition 구성 파일을 통해 RHCOS(Red Hat Enterprise Linux CoreOS) 노드에 전달되며 각 노드의 core 사용자의 ~/.ssh/authorized_keys 에 추가됩니다.
키는 각 노드에서 core 사용자의 ~/.ssh/authorized_keys 목록에 추가되어 암호 없는 인증을 활성화합니다. 키가 노드에 전달되면 키 쌍을 사용하여 사용자 core로 RHCOS 노드에 SSH로 SSH 연결을 수행할 수 있습니다 . SSH를 통해 노드에 액세스하려면 로컬 사용자의 SSH에서 개인 키 ID를 관리해야 합니다.
설치 디버깅 또는 재해 복구를 수행하기 위해 클러스터 노드에 SSH를 실행하려면 설치 프로세스 중에 SSH 공용 키를 지정해야 합니다. ./openshift-install gather 명령에도 SSH 공개 키가 클러스터 노드에 있어야 합니다.
재해 복구 및 디버깅이 필요한 프로덕션 환경에서는이 단계를 생략하지 마십시오.
플랫폼별 접근 방식으로 구성한 키가 아닌 로컬 키를 사용해야 합니다.
프로세스
로컬 시스템에 클러스터 노드의 인증에 사용할 기존 SSH 키 쌍이 없는 경우 새로 생성합니다. 예를 들어 Linux 운영 체제를 사용하는 컴퓨터에서 다음 명령을 실행합니다.
$ ssh-keygen -t ed25519 -N '' -f <path>/<file_name>새 SSH 키의 경로 및 파일 이름(예:
~/.ssh/id_ed25519)을 지정합니다. 기존 키 쌍이 있는 경우 공개 키가'~/.ssh디렉터리에 있는지 확인하십시오.참고x86_64,ppc64le,s390x아키텍처에서만 FIPS 140-2/140-3 Validation에 대해 NIST에 제출된 RHEL 암호화 라이브러리를 사용하는 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가 자동으로 관리됩니다.ssh-agent프로세스가 로컬 사용자에 대해 실행되지 않은 경우 백그라운드 작업으로 시작합니다.$ eval "$(ssh-agent -s)"출력 예
Agent pid 31874참고클러스터가 FIPS 모드인 경우 FIPS 호환 알고리즘만 사용하여 SSH 키를 생성합니다. 키는 RSA 또는 ECDSA여야 합니다.
ssh-agent에 SSH 개인 키를 추가합니다.$ ssh-add <path>/<file_name>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를 실행하는 컴퓨터가 있습니다.
프로세스
Red Hat Hybrid Cloud Console의 Cluster Type 페이지로 이동합니다. Red Hat 계정이 있는 경우 인증 정보를 사용하여 로그인합니다. 계정이 없으면 계정을 만드십시오.
작은 정보- 페이지의 자체 실행 섹션에서 인프라 공급자를 선택합니다.
- OpenShift 설치 관리자의 드롭다운 메뉴에서 호스트 운영 체제 및 아키텍처를 선택하고 설치 프로그램 다운로드를 클릭합니다.
다운로드한 파일을 설치 구성 파일을 저장할 디렉터리에 배치합니다.
중요- 설치 프로그램은 클러스터를 설치하는 데 사용하는 컴퓨터에 여러 파일을 만듭니다. 클러스터 설치를 마친 후 설치 프로그램과 설치 프로그램으로 생성되는 파일을 보관해야 합니다. 클러스터를 삭제하려면 두 파일이 모두 필요합니다.
- 클러스터 설치에 실패하거나 설치 프로그램으로 만든 파일을 삭제해도 클러스터는 제거되지 않습니다. 클러스터를 제거하려면 해당 클라우드 공급자에 적용되는 OpenShift Container Platform 설치 제거 절차를 완료해야 합니다.
설치 프로그램 파일의 압축을 풉니다. 예를 들어 Linux 운영 체제를 사용하는 컴퓨터에서 다음 명령을 실행합니다.
$ tar -xvf openshift-install-linux.tar.gzRed Hat OpenShift Cluster Manager에서 설치 풀 시크릿을 다운로드합니다. 이 풀 시크릿을 사용하면 OpenShift Container Platform 구성 요소에 대한 컨테이너 이미지를 제공하는 Quay.io를 포함하여 인증 기관에서 제공하는 서비스로 인증할 수 있습니다.
작은 정보또는 다운로드할 설치 프로그램 버전을 지정할 수 있는 Red Hat 고객 포털에서 설치 프로그램을 검색할 수 있습니다. 그러나 이 페이지에 액세스하려면 활성 서브스크립션이 있어야 합니다.
4.5. 설치 구성 파일 만들기 링크 복사링크가 클립보드에 복사되었습니다!
Google Cloud에 설치하는 OpenShift Container Platform 클러스터를 사용자 지정할 수 있습니다.
사전 요구 사항
- OpenShift Container Platform 설치 프로그램과 클러스터의 풀 시크릿이 있습니다.
- Google Cloud 계정을 구성합니다.
프로세스
install-config.yaml파일을 생성합니다.설치 프로그램이 포함된 디렉터리로 변경하고 다음 명령을 실행합니다.
$ ./openshift-install create install-config --dir <installation_directory><installation_directory>:<installation_directory>의 경우 설치 프로그램이 생성하는 파일을 저장할 디렉터리 이름을 지정합니다.디렉터리를 지정할 때 다음을 수행합니다.
-
디렉터리에
execute권한이 있는지 확인합니다. 설치 디렉토리에서 Terraform 바이너리를 실행하려면 이 권한이 필요합니다. - 빈 디렉터리를 사용합니다. 부트스트랩 X.509 인증서와 같은 일부 설치 자산은 단기간에 만료되므로 설치 디렉터리를 재사용해서는 안 됩니다. 다른 클러스터 설치의 개별 파일을 재사용하려면 해당 파일을 사용자 디렉터리에 복사하면 됩니다. 그러나 설치 자산의 파일 이름은 릴리스간에 변경될 수 있습니다. 따라서 이전 OpenShift Container Platform 버전에서 설치 파일을 복사할 때는 주의하십시오.
화면에 나타나는 지시에 따라 클라우드에 대한 구성 세부 사항을 입력합니다.
선택사항: 클러스터 시스템에 액세스하는 데 사용할 SSH 키를 선택합니다.
참고설치 디버깅 또는 재해 복구를 수행하려는 프로덕션 OpenShift Container Platform 클러스터의 경우
ssh-agent프로세스가 사용하는 SSH 키를 지정합니다.- 대상 플랫폼으로 gcp를 선택합니다.
- 컴퓨터에 있는 Google Cloud 계정에 대한 서비스 계정 키를 구성하지 않은 경우 Google Cloud에서 해당 키를 가져와 파일의 내용을 붙여넣거나 파일의 절대 경로를 입력해야 합니다.
- 클러스터를 프로비저닝할 프로젝트 ID를 선택합니다. 구성한 서비스 계정에 의해 기본값이 지정됩니다.
- 클러스터를 배포할 리전을 선택합니다.
- 클러스터를 배포할 기본 도메인을 선택합니다. 기본 도메인은 클러스터용으로 생성한 퍼블릭 DNS 영역에 해당합니다.
- 클러스터를 설명할 수 있는 이름을 입력합니다.
install-config.yaml파일을 수정합니다. 사용 가능한 매개변수에 대한 자세한 정보는 “설치 구성 매개변수” 섹션에서 확인할 수 있습니다.참고3-노드 클러스터를 설치하는 경우
compute.replicas매개변수를0으로 설정해야 합니다. 이렇게 하면 클러스터의 컨트롤 플레인을 예약할 수 있습니다. 자세한 내용은 "Google Cloud에 3-노드 클러스터 설치"를 참조하십시오.여러 클러스터를 설치하는 데 사용할 수 있도록
install-config.yaml파일을 백업합니다.중요install-config.yaml파일은 설치 과정에서 사용됩니다. 이 파일을 재사용하려면 지금 백업해야 합니다.
4.5.1. 클러스터 설치를 위한 최소 리소스 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 클러스터가 예상대로 실행되도록 각 클러스터 머신이 최소 CPU, 메모리 및 스토리지 요구 사항을 충족해야 합니다.
| 머신 | 운영 체제 | vCPU | 가상 RAM | 스토리지 | 초당 입력/출력(IOPS) |
|---|---|---|---|---|---|
| 부트스트랩 | RHCOS | 4 | 16GB | 100GB | 300 |
| 컨트롤 플레인 | RHCOS | 4 | 16GB | 100GB | 300 |
| Compute | RHCOS | 2 | 8GB | 100GB | 300 |
- SMT(동시 멀티 스레딩) 또는 Hyper-Threading이 활성화되지 않은 경우 하나의 vCPU가 하나의 물리적 코어와 동일합니다. 활성화하면 다음과 같은 공식을 사용하여 해당 비율을 계산합니다. (코어 당 스레드 수 × 코어 수) × 소켓 수 = vCPU 수
- OpenShift Container Platform 및 Kubernetes는 디스크 성능에 민감하며 Red Hat은 특히 10ms p99 fsync 기간이 필요한 컨트롤 플레인 노드의 etcd에서 더 빠른 스토리지를 권장합니다. 많은 클라우드 플랫폼에서 스토리지 크기와 IOPS가 함께 확장되므로 충분한 성능을 얻기 위해 더 많은 스토리지를 프로비저닝해야 할 수 있습니다.
- 사용자가 프로비저닝한 모든 설치와 마찬가지로 클러스터에서 RHEL 컴퓨팅 머신을 사용하기로 선택한 경우 시스템 업데이트 수행, 패치 적용 및 기타 필요한 모든 작업 실행을 포함한 모든 운영 체제의 라이프 사이클 관리 및 유지 관리에 대한 책임이 있습니다. OpenShift Container Platform 4.10 이상에서는 RHEL 7 컴퓨팅 머신을 지원하지 않습니다.
OpenShift Container Platform 버전 5.0에서 RHCOS는 RHEL 버전 10.2를 사용하여 마이크로 아키텍처 요구 사항을 업데이트합니다. 각 아키텍처에는 다음과 같은 최소 명령 집합 아키텍처(ISA)가 필요합니다.
- x86-64 아키텍처에는 x86-64-v2 ISA가 필요합니다.
- ARM64 아키텍처에는 ARMv8.0-A ISA가 필요합니다.
- ppc64le 아키텍처 및 RHCOS-10.2에는 IBM® Power10 ISA 이상이 필요합니다.
- ppc64le 아키텍처 및 RHCOS-9.8에는 IBM® Power9 ISA 이상이 필요합니다.
- s390x 아키텍처에는 IBM® z14 ISA가 필요합니다.
고객이 RHEL 9와 함께 OpenShift Container Platform을 설치한 경우 IBM® Power9 ISA와 함께 ppc64le 아키텍처를 사용할 수 있습니다.
자세한 내용은 RHEL 문서의 아키텍처를 참조하십시오.
플랫폼의 인스턴스 유형이 클러스터 머신의 최소 요구 사항을 충족하는 경우 OpenShift Container Platform에서 사용할 수 있습니다.
4.5.2. Google Cloud에서 테스트된 인스턴스 유형 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform은 클러스터 배포를 위해 검증된 특정 Google Cloud 인스턴스 유형을 지원합니다.
모든 지역 및 영역에서 모든 인스턴스 유형을 사용할 수 있는 것은 아닙니다. 사용할 수 있는 인스턴스 유형에 대한 자세한 내용은 지역 및 영역 (Google 문서)을 참조하십시오.
일부 인스턴스 유형에는 Hyperdisk 스토리지를 사용해야 합니다. Hyperdisk 스토리지가 필요한 인스턴스 유형을 사용하는 경우 클러스터의 모든 노드가 Hyperdisk 스토리지를 지원해야 하며 Hyperdisk 스토리지를 사용하도록 기본 스토리지 클래스를 변경해야 합니다. 자세한 내용은 Hyperdisk (Google 문서)에 대한 머신 시리즈 지원을 참조하십시오. 스토리지 클래스 수정에 대한 지침은 스토리지의 동적 프로비저닝 페이지의 "GCE PersistentDisk (gcePD) 오브젝트 정의" 섹션을 참조하십시오.
다음 머신 시리즈를 참조하십시오.
-
A2 -
A3 -
C2 -
C2D -
C3 -
C3D -
C4 -
E2 -
M1 -
N1 -
N2 -
N2D -
N4 -
Tau T2D
4.5.3. 64비트 ARM 인프라에서 Google Cloud에 대해 테스트된 인스턴스 유형 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform은 클러스터 배포를 위해 검증된 특정 Google Cloud 64비트 ARM 인스턴스 유형을 지원합니다.
64비트 ARM 머신의 다음 머신 시리즈를 참조하십시오.
-
C4A -
N4A -
Tau T2A
4.5.4. 사용자 지정 머신 유형 사용 링크 복사링크가 클립보드에 복사되었습니다!
사전 정의된 Google Cloud 머신 유형이 워크로드 요구 사항을 충족하지 않는 경우 OpenShift Container Platform 설치 중에 install-config.yaml 파일에서 사용자 지정 머신 유형을 구성할 수 있습니다.
사용자 지정 머신 유형을 사용할 때 다음을 고려하십시오.
- 사전 정의된 인스턴스 유형과 유사하게 사용자 정의 시스템 유형은 컨트롤 플레인 및 컴퓨팅 시스템의 최소 리소스 요구 사항을 충족해야 합니다. 자세한 내용은 "클러스터 설치를 위한 최소 리소스 요구 사항"을 참조하십시오.
사용자 지정 머신 유형의 이름은 다음 구문을 준수해야 합니다.
custom-<number_of_cpus>-<amount_of_memory_in_mb>예를 들면
custom-6-20480입니다.
설치 프로세스의 일부로 install-config.yaml 파일에 사용자 지정 머신 유형을 지정합니다.
사용자 지정 머신 유형이 있는 샘플 install-config.yaml 파일
compute:
- architecture: amd64
hyperthreading: Enabled
name: worker
platform:
gcp:
type: custom-6-20480
replicas: 2
controlPlane:
architecture: amd64
hyperthreading: Enabled
name: master
platform:
gcp:
type: custom-6-20480
replicas: 3
4.5.5. Shielded VM 활성화 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 클러스터를 설치할 때 Shielded VM을 사용할 수 있습니다. Shielded VM에는 보안 부팅, 펌웨어 및 무결성 모니터링 및 루트킷 탐지를 포함한 추가 보안 기능이 있습니다.
자세한 내용은 Shielded VMs 에 대한 Google 문서를 참조하십시오.
Shielded VM은 현재 64비트 ARM 인프라가 있는 클러스터에서 지원되지 않습니다.
절차
클러스터를 배포하기 전에 텍스트 편집기를 사용하여
install-config.yaml파일을 편집하고 다음 스탠자 중 하나를 추가합니다.컨트롤 플레인 시스템에만 보호된 VM을 사용하려면 다음을 수행합니다.
controlPlane: platform: gcp: secureBoot: Enabled컴퓨팅 머신에만 보호된 VM을 사용하려면 다음을 수행합니다.
compute: - platform: gcp: secureBoot: Enabled모든 시스템에 대해 보호된 VM을 사용하려면 다음을 수행합니다.
platform: gcp: defaultMachinePlatform: secureBoot: Enabled
4.5.6. 기밀성 VM 활성화 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 클러스터를 설치할 때 기밀성 VM을 사용할 수 있습니다. 기밀 VM은 처리 중에 데이터를 암호화합니다.
자세한 내용은 기밀 컴퓨팅 에 대한 Google 설명서를 참조하십시오. 상호 의존적이지는 않지만 Confidential VM과 Shielded VM을 동시에 활성화할 수 있습니다.
현재 기밀 VM은 64비트 ARM 아키텍처에서 지원되지 않습니다.
절차
클러스터를 배포하기 전에 텍스트 편집기를 사용하여
install-config.yaml파일을 편집하고 다음 스탠자 중 하나를 추가합니다.컨트롤 플레인 머신에만 Confidential VM을 사용하려면 다음을 수행합니다.
controlPlane: platform: gcp: confidentialCompute: AMDEncryptedVirtualizationNestedPaging type: n2d-standard-8 onHostMaintenance: Terminate다음과 같습니다.
confidentialCompute- AMD Secure Encrypted Virtualization Secure Nested Paging(AMD SEV-SNP)을 사용하여 기밀 VM을 활성화합니다. 사용 가능한 옵션에 대한 자세한 내용은 "추가 Google Cloud 구성 매개변수"를 참조하십시오.
type- 기밀성 VM을 지원하는 머신 유형을 지정합니다. 기밀 VM에는 N2D, C2D, C3D 또는 C3 일련의 머신 유형이 필요합니다. 지원되는 머신 유형에 대한 자세한 내용은 지원되는 운영 체제 및 머신 유형을 참조하십시오.
onHostMaintenance-
호스트 유지 관리 이벤트 중 하드웨어 또는 소프트웨어 업데이트와 같은 VM의 동작을 지정합니다. 기밀성 VM을 사용하는 시스템의 경우 이 값은 VM을 중지하도록
Terminate로 설정해야 합니다. 기밀 VM은 실시간 VM 마이그레이션을 지원하지 않습니다.
컴퓨팅 머신에만 기밀 VM을 사용하려면 다음을 수행합니다.
compute: - platform: gcp: confidentialCompute: AMDEncryptedVirtualizationNestedPaging type: n2d-standard-8 onHostMaintenance: Terminate모든 머신에 기밀 VM을 사용하려면 다음을 수행합니다.
platform: gcp: defaultMachinePlatform: confidentialCompute: AMDEncryptedVirtualizationNestedPaging type: n2d-standard-8 onHostMaintenance: Terminate
4.5.7. 사용자 관리 DNS 활성화 링크 복사링크가 클립보드에 복사되었습니다!
기본 클러스터 프로비저닝 DNS 솔루션 대신 DNS(Domain Name Server) 솔루션을 사용하여 클러스터를 설치할 수 있습니다. 결과적으로 클라우드 DNS에 레코드를 추가하는 대신 자체 시스템에서 API 및 Ingress DNS 레코드를 관리할 수 있습니다.
예를 들어 조직의 보안 정책은 Google Cloud DNS와 같은 퍼블릭 DNS 서비스 사용을 허용하지 않을 수 있습니다. 이러한 시나리오에서는 자체 DNS 서비스를 사용하여 퍼블릭 DNS 서비스를 무시하고 API 및 Ingress 서비스의 IP 주소에 대한 자체 DNS를 관리할 수 있습니다.
설치 중에 사용자 관리 DNS를 활성화하면 설치 프로그램은 클러스터 내에서만 API 및 Ingress 서비스에 대한 DNS 레코드를 프로비저닝합니다. 클러스터 외부에서 액세스하려면 설치 후 선택한 API 및 Ingress 서비스에 대해 선택한 외부 DNS 서비스에 DNS 레코드를 프로비저닝해야 합니다.
API 서버 및 Ingress 서비스에 대한 DNS 레코드를 프로비저닝하는 방법에 대한 자세한 내용은 "사용자의 DNS 레코드 프로비저닝"을 참조하십시오.
사전 요구 사항
-
jqCLI를 설치하셨습니다.
프로세스
클러스터를 배포하기 전에 텍스트 편집기를 사용하여
install-config.yaml파일을 열고 다음 스탠자를 추가합니다.사용자 관리 DNS를 활성화하려면 다음을 수행합니다.
platform: gcp: userProvisionedDNS: Enabled다음과 같습니다.
활성화됨- 사용자 프로비저닝 DNS 관리를 활성화합니다.
4.5.8. Google Cloud용 샘플 사용자 지정 install-config.yaml 파일 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 클러스터 플랫폼에 대한 자세한 정보를 지정하거나 필수 매개변수 값을 수정하려면 install-config.yaml 파일을 사용자 지정할 수 있습니다.
이 샘플 YAML 파일은 참조용으로만 제공됩니다. 설치 프로그램을 사용하여 install-config.yaml 파일을 받아서 수정해야 합니다.
apiVersion: v1
baseDomain: example.com
pullSecret: '{"auths": ...}'
controlPlane:
name: master
replicas: 3
platform:
gcp:
type: n2-standard-4
compute:
- name: worker
replicas: 3
platform:
gcp:
type: n2-standard-4
metadata:
name: test-cluster
networking:
clusterNetwork:
- cidr: 10.128.0.0/14
hostPrefix: 23
platform:
gcp:
projectID: sample-project
region: us-east1
다음과 같습니다.
controlPlane- 컨트롤 플레인 시스템에 적용되는 매개변수를 지정합니다.
compute- 컴퓨팅 시스템에 적용되는 매개변수를 지정합니다.
네트워킹- 클러스터 네트워킹 구성에 적용되는 매개변수를 지정합니다. 네트워킹 값을 제공하지 않으면 설치 프로그램에서 기본값을 제공합니다.
platform- 클러스터를 호스팅하는 인프라 플랫폼에 적용되는 매개변수를 지정합니다.
4.5.9. 설치 중 클러스터 단위 프록시 구성 링크 복사링크가 클립보드에 복사되었습니다!
프로덕션 환경에서는 인터넷에 대한 직접 액세스를 거부하고 대신 HTTP 또는 HTTPS 프록시를 사용할 수 있습니다. install-config.yaml 파일에서 프록시 설정을 구성하여 프록시가 사용되도록 새 OpenShift Container Platform 클러스터를 구성할 수 있습니다.
사전 요구 사항
-
기존
install-config.yaml파일이 있습니다. 클러스터에서 액세스해야 하는 사이트를 검토하고 프록시를 바이패스해야 하는지 확인했습니다. 기본적으로 프록시는 클러스터 발신(Egress) 트래픽을 포함하여 모든 클러스터 발신 트래픽을 처리합니다. 필요한 경우 프록시를 바이패스하기 위해
Proxy오브젝트의spec.noProxy필드에 사이트를 추가했습니다.참고Proxy오브젝트의status.noProxy필드는 설치 구성에 있는networking.machineNetwork[].cidr,networking.clusterNetwork[].cidr및networking.serviceNetwork[]필드의 값으로 채워집니다.Amazon Web Services (AWS), Google Cloud, 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> httpsProxy: https://<username>:<pswd>@<ip>:<port> noProxy: example.com additionalTrustBundle: | -----BEGIN CERTIFICATE----- <MY_TRUSTED_CA_CERT> -----END CERTIFICATE----- additionalTrustBundlePolicy: <policy_to_add_additionalTrustBundle> # ...다음과 같습니다.
proxy.httpProxy-
클러스터 외부에서 HTTP 연결을 구축하는 데 사용할 프록시 URL입니다. URL 스키마는
http여야 합니다. proxy.httpsProxy- 클러스터 외부에서 HTTPS 연결을 구축하는 데 사용할 프록시 URL입니다.
proxy.noProxy-
대상 도메인 이름, IP 주소 또는 프록시에서 제외할 기타 네트워크 CIDR로 이루어진 쉼표로 구분된 목록입니다. 하위 도메인과 일치하려면 도메인 앞에
.을 입력합니다. 예를 들어,.y.com은x.y.com과 일치하지만y.com은 일치하지 않습니다.*를 사용하여 모든 대상에 대해 프록시를 바이패스합니다. additionalTrustBundle-
이 값을 지정하면 설치 프로그램이
openshift-config이름 공간에서user-ca-bundle라는 구성 맵을 생성하여 추가 CA 인증서를 보유합니다.additionalTrustBundle및 최소 하나의 프록시 설정을 지정하면Proxy객체가trustedCA필드의user-ca-bundle구성 맵을 참조합니다. 그런 다음 클러스터 네트워크 운영자는trustedCA매개 변수에 지정된 컨텐츠를 RHCOS trust bundle와 합쳐trusted-ca-bundle구성 맵을 생성합니다. RHCOS 트러스트 번들에 있는 기관에서 서명하지 않은 경우AdditionalTrustBundle필드가 있어야 합니다. additionalTrustBundlePolicytrustedCA필드에서user-ca-bundle구성 매핑을 참조하도록Proxy객체의 구성을 결정하는 정책을 지정합니다. 허용되는 값은Proxyonly및Always입니다.http/https프록시를 구성할 때만Proxyonly를 사용하여user-ca-bundle구성 맵을 참조하십시오.Always를 사용하여user-ca-bundle구성 맵을 항상 참조합니다. 기본값은Proxyonly입니다. 선택적 매개변수입니다.참고설치 프로그램에서 프록시
adinessEndpoints필드를 지원하지 않습니다.참고설치 프로그램이 시간 초과되면 설치 프로그램의
wait-for명령을 사용하여 배포를 다시 시작한 다음 완료합니다. 예를 들면 다음과 같습니다.$ ./openshift-install wait-for install-complete --log-level debug
파일을 저장해 놓고 OpenShift Container Platform을 설치할 때 참조하십시오.
제공되는
install-config.yaml파일의 프록시 설정을 사용하는cluster라는 이름의 클러스터 전체 프록시가 설치 프로그램에 의해 생성됩니다. 프록시 설정을 제공하지 않으면 설치 프로그램은 여전히clusterProxy객체를 생성하지만, 해당 객체의spec은 실수입니다.참고cluster라는Proxy오브젝트만 지원되며 추가 프록시는 생성할 수 없습니다.
4.6. Google Cloud의 사용자 정의 레이블 및 태그 관리 링크 복사링크가 클립보드에 복사되었습니다!
Google Cloud 레이블 및 태그를 사용하여 특정 OpenShift Container Platform 클러스터에 대해 생성된 리소스를 식별하고 구성할 수 있습니다.
OpenShift Container Platform 클러스터 설치 중에만 각 Google Cloud 리소스에 대한 레이블 및 태그를 정의할 수 있습니다.
OpenShift Container Platform 5.0으로 업그레이드된 OpenShift Container Platform 클러스터에서는 사용자 정의 레이블 및 태그가 지원되지 않습니다.
이미 추가된 태그는 업데이트할 수 없습니다. 또한 구성된 태그 키 또는 태그 값이 삭제되면 새 태그 지원 리소스 생성이 실패합니다.
사용자 정의 레이블 및 OpenShift Container Platform 특정 레이블은 OpenShift Container Platform 설치 프로그램 및 해당 핵심 구성 요소에서 생성한 리소스에만 적용됩니다.
- Google Cloud FileStore CSI Driver Operator
- Google Cloud PD CSI Driver Operator
- 이미지 레지스트리 Operator
- Google Cloud용 머신 API 공급자
사용자 정의 레이블은 다른 Operator 또는 Kubernetes in-tree 구성 요소에서 생성한 리소스에 연결되지 않습니다.
사용자 정의 레이블 및 OpenShift Container Platform 레이블은 다음 Google Cloud 리소스에서 사용할 수 있습니다.
- 컴퓨팅 디스크
- 컴퓨팅 전달 규칙
- 컴퓨팅 이미지
- 컴퓨팅 인스턴스
- DNS 관리 영역
- filestore 백업
- 파일 저장소 인스턴스
- 스토리지 버킷
사용자 정의 라벨에는 다음과 같은 제한 사항이 있습니다.
-
ComputeAddress의 라벨은 Google Cloud 베타 버전에서 지원됩니다. OpenShift Container Platform은 리소스에 라벨을 추가하지 않습니다.
사용자 정의 태그는 OpenShift Container Platform 설치 프로그램 및 해당 핵심 구성 요소에서 생성한 리소스에만 적용됩니다.
- Google Cloud FileStore CSI Driver Operator
- Google Cloud PD CSI Driver Operator
- 이미지 레지스트리 Operator
- Google Cloud용 머신 API 공급자
사용자 정의 태그는 다른 Operator 또는 Kubernetes in-tree 구성 요소에서 생성한 리소스에 연결되지 않습니다.
사용자 정의 태그는 다음 Google Cloud 리소스에서 사용할 수 있습니다.
- 컴퓨팅 디스크
- 컴퓨팅 인스턴스
- filestore 백업
- 파일 저장소 인스턴스
- 스토리지 버킷
사용자 정의 태그에는 다음과 같은 제한 사항이 있습니다.
- Operator는 최소한의 역할로 서비스 계정을 생성하고 사용하므로 태그는 특정 서비스 계정으로 제한해서는 안 됩니다.
- OpenShift Container Platform은 태그의 키 및 값 리소스를 생성하지 않습니다.
- OpenShift Container Platform 특정 태그는 리소스에 추가되지 않습니다.
4.6.1. 사용자 정의 라벨 및 태그에 대한 기준 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform에서 Google Cloud에 대한 사용자 정의 레이블 및 태그는 적절한 리소스 거버넌스에 대한 특정 형식 지정 및 수량 요구 사항을 충족해야 합니다.
다음 목록에서는 사용자 정의 라벨에 대한 요구 사항을 자세히 설명합니다.
- 레이블 키와 값은 최소 1자 이상이어야 하며 최대 63자까지 사용할 수 있습니다.
-
레이블 키와 값은 소문자, 숫자 문자, 밑줄(
_) 및 대시(-)만 포함되어야 합니다. - 레이블 키는 소문자로 시작해야 합니다.
리소스당 최대 32개의 라벨을 구성할 수 있습니다.
- 각 리소스에는 최대 64개의 레이블이 있으며, 여기에서 OpenShift Container Platform은 내부 사용을 위해 32개의 라벨을 예약합니다.
다음 목록에서는 사용자 정의 태그의 요구 사항을 자세히 설명합니다.
- 태그 키와 태그 값이 이미 있어야 합니다. OpenShift Container Platform은 키와 값을 생성하지 않습니다.
태그
parentID는OrganizationID또는ProjectID일 수 있습니다.-
OrganizationID는 앞에 0이 없는 10진수로 구성되어야 합니다. -
projectID는 소문자, 숫자, 하이픈만 포함하는 6~30자여야 합니다. -
projectID는 문자로 시작해야 하며 하이픈으로 끝낼 수 없습니다.
-
-
태그 키에는 대문자 및 소문자 영숫자, 하이픈(
-), 밑줄(_) 및 마침표(.)만 포함되어야 합니다. 태그 값에는 대문자 및 소문자 영숫자 및 다음 문자만 포함되어야 합니다.
-
A colon (
:) -
쉼표(
,) -
중괄호(
{}) -
하이픈(
-) -
배열
() -
백분율 기호(
%) -
더하기 (
+) -
파운드 기호(
$) - 한 공간.
-
정사각 중괄호 (
[]) -
앰퍼샌드(
&) -
별표 (
*) -
서명 (
@) -
등호(
=) -
밑줄(
_) -
기간 (
.)
-
A colon (
- 태그 키와 값은 영숫자 문자로 시작하고 끝나야 합니다.
- 태그 값은 키에 대해 사전 정의된 값 중 하나여야 합니다.
- 최대 50개의 태그를 구성할 수 있습니다.
- 상위 리소스에서 상속되는 기존 태그 키와 동일한 값으로 태그 키를 정의하지 마십시오.
4.6.2. Google Cloud에 대한 사용자 정의 레이블 및 태그 구성 링크 복사링크가 클립보드에 복사되었습니다!
키-값 쌍을 Google Cloud 리소스에 레이블 및 태그로 적용하여 OpenShift Container Platform 인프라를 구성, 관리 및 자동화할 수 있습니다.
사전 요구 사항
-
설치 프로그램에서는 서비스 계정에
TagUser역할이 필요하므로 프로그램이 조직 및 프로젝트 수준에서 정의된 태그로 OpenShift Container Platform 클러스터를 생성할 수 있습니다.
프로세스
install-config.yaml파일을 업데이트하여 필수 레이블 및 태그 목록을 정의합니다.참고install-config.yaml구성 파일을 생성하는 동안 레이블 및 태그를 설정하는 경우 클러스터를 생성한 후에는 새 레이블과 태그를 생성하거나 업데이트할 수 없습니다.다음 샘플
install-config.yaml파일은 사용자 레이블 및 태그를 정의합니다.apiVersion: v1 credentialsMode: Passthrough platform: gcp: userLabels: - key: <label_key> value: <label_value> userTags: - parentID: <OrganizationID/ProjectID> key: <tag_key_short_name> value: <tag_value_short_name> # ...다음과 같습니다.
-
credentialsMode: passthrough 모드에서 CCO(Cloud Credential Operator)는 제공된 클라우드 인증 정보를 클라우드 인증 정보를 요청하는 구성 요소에 전달합니다. -
userLabels: Google Cloud에서 생성된 리소스에 키와 값을 라벨로 추가합니다. -
<label_key> : 레이블 이름을 지정합니다. -
<label_value> : 레이블 콘텐츠를 지정합니다. -
userTags: Google Cloud에서 생성된 리소스에 키와 값을 태그로 추가합니다. -
<OrganizationID/ProjectID>: 조직 또는 프로젝트 수준에서 태그를 정의한 계층 리소스의 ID를 지정합니다.
4.6.3. Google Cloud의 사용자 정의 레이블 및 태그 쿼리 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 클러스터를 생성한 후 infrastructure .config.openshift.io/cluster 오브젝트에서 Google Cloud 리소스에 대해 정의된 라벨과 태그를 쿼리하여 문제 해결 중에 라벨 설정 또는 참조 태그 값을 확인할 수 있습니다.
infrastructure.yaml 파일 샘플
apiVersion: config.openshift.io/v1
kind: Infrastructure
metadata:
name: cluster
spec:
platformSpec:
type: GCP
status:
infrastructureName: <cluster_id>
platform: GCP
platformStatus:
gcp:
resourceLabels:
- key: <label_key>
value: <label_value>
resourceTags:
- key: <tag_key_short_name>
parentID: <OrganizationID/ProjectID>
value: <tag_value_short_name>
type: GCP
여기서 <cluster_id >는 클러스터 설치 중에 생성된 클러스터 ID입니다.
사용자 정의 레이블과 함께 리소스에는 OpenShift Container Platform에서 정의한 레이블이 있습니다. OpenShift Container Platform 라벨 형식은 kubernetes-io-cluster-<cluster_id>:owned 입니다.
4.7. Linux에 OpenShift CLI 설치 링크 복사링크가 클립보드에 복사되었습니다!
클러스터를 관리하고 Linux의 명령줄에서 애플리케이션을 배포하려면 OpenShift CLI(oc) 바이너리를 설치합니다. Red Hat 고객 포털에서 OpenShift CLI(oc)를 다운로드할 수 있습니다.
이전 버전의 oc 를 설치한 경우 OpenShift Container Platform의 모든 명령을 완료하는 데 해당 버전을 사용할 수 없습니다.
새 버전의 oc를 다운로드하여 설치합니다.
절차
- Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
- Product Variant 목록에서 아키텍처를 선택합니다.
- 버전 목록에서 적절한 버전을 선택합니다.
- OpenShift v5.0 Linux Clients 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.
아카이브의 압축을 풉니다.
$ tar xvf <file>oc바이너리를PATH에 있는 디렉터리에 배치합니다.PATH를 확인하려면 다음 명령을 실행합니다.$ echo $PATH
검증
OpenShift CLI를 설치한 후
oc명령을 사용할 수 있습니다.$ oc <command>
4.8. Windows에 OpenShift CLI 설치 링크 복사링크가 클립보드에 복사되었습니다!
클러스터를 관리하고 Windows의 명령줄에서 애플리케이션을 배포하려면 OpenShift CLI(oc) 바이너리를 설치합니다. Red Hat 고객 포털에서 OpenShift CLI(oc)를 다운로드할 수 있습니다.
이전 버전의 oc 를 설치한 경우 OpenShift Container Platform의 모든 명령을 완료하는 데 해당 버전을 사용할 수 없습니다.
새 버전의 oc를 다운로드하여 설치합니다.
절차
- Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
- 버전 목록에서 적절한 버전을 선택합니다.
- OpenShift v5.0 Windows Client 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.
- ZIP 프로그램으로 아카이브의 압축을 풉니다.
oc바이너리를PATH변수에 있는 디렉터리로 이동합니다.PATH변수를 확인하려면 명령 프롬프트를 열고 다음 명령을 실행합니다.C:\> path
검증
OpenShift CLI를 설치한 후
oc명령을 사용할 수 있습니다.C:\> oc <command>
4.9. macOS에 OpenShift CLI 설치 링크 복사링크가 클립보드에 복사되었습니다!
클러스터를 관리하고 macOS의 명령줄에서 애플리케이션을 배포하려면 OpenShift CLI(oc) 바이너리를 설치합니다. Red Hat 고객 포털에서 OpenShift CLI(oc)를 다운로드할 수 있습니다.
이전 버전의 oc 를 설치한 경우 OpenShift Container Platform의 모든 명령을 완료하는 데 해당 버전을 사용할 수 없습니다.
새 버전의 oc를 다운로드하여 설치합니다.
절차
- Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
- Product Variant 목록에서 아키텍처를 선택합니다.
- 버전 목록에서 적절한 버전을 선택합니다.
OpenShift v5.0 macOS Clients 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.
참고macOS arm64의 경우 OpenShift v5.0 macOS arm64 Client 항목을 선택합니다.
- 아카이브를 추출합니다.
oc바이너리를PATH변수의 디렉터리로 이동합니다.PATH변수를 확인하려면 터미널을 열고 다음 명령을 실행합니다.$ echo $PATH
검증
oc명령을 사용하여 설치를 확인합니다.$ oc <command>
4.10. kube-system 프로젝트에 관리자 수준 시크릿을 저장하는 대안 링크 복사링크가 클립보드에 복사되었습니다!
기본적으로 OpenShift Container Platform은 kube-system 프로젝트에 관리자 시크릿을 저장합니다.
install-config.yaml 파일에서 credentialsMode 매개변수를 Manual 로 구성한 경우 장기 수동 인증 정보 또는 클러스터 외부에서 관리되는 단기 인증 정보를 사용하여 대체 인증 정보 관리 전략을 구성해야 합니다.
- 장기 클라우드 인증 정보를 수동으로 관리하려면 " 장기 자격 증명 생성" 절차를 따르십시오.
- 개별 구성 요소에 대해 클러스터 외부에서 관리되는 단기 자격 증명을 구현하려면 "Google Cloud 클러스터에 대한 장기 인증 정보 구성" 절차를 따르십시오.
4.10.1. 수동으로 장기 인증 정보 생성 링크 복사링크가 클립보드에 복사되었습니다!
클라우드 ID 및 액세스 관리(IAM) API에 연결할 수 없거나 클러스터 kube-system 네임스페이스에 관리자 수준 인증 정보 시크릿을 저장하지 않으려면 OpenShift Container Platform 설치 전에 CCO(Cloud Credential Operator)를 수동 모드로 설정할 수 있습니다.
절차
설치 프로그램에서 사용하는 Google Cloud 계정에 다음 세분화된 권한을 추가합니다.
- compute.machineTypes.list
- compute.regions.list
- compute.zones.list
- dns.changes.create
- dns.changes.get
- dns.managedZones.create
- dns.managedZones.delete
- dns.managedZones.get
- dns.managedZones.list
- dns.networks.bindPrivateDNSZone
- dns.resourceRecordSets.create
- dns.resourceRecordSets.delete
- dns.resourceRecordSets.list
install-config.yaml구성 파일의credentialsMode매개변수를Manual로 설정하지 않은 경우 다음과 같이 값을 수정합니다.구성 파일 스니펫 샘플
apiVersion: v1 baseDomain: example.com credentialsMode: Manual # ...이전에 설치 매니페스트 파일을 생성하지 않은 경우 다음 명령을 실행하여 수행합니다.
$ openshift-install create manifests --dir <installation_directory>여기서
<installation_directory>는 설치 프로그램이 파일을 생성하는 디렉터리입니다.다음 명령을 실행하여 설치 파일의 릴리스 이미지로
$RELEASE_IMAGE변수를 설정합니다.$ RELEASE_IMAGE=$(./openshift-install version | awk '/release image/ {print $3}')다음 명령을 실행하여 OpenShift Container Platform 릴리스 이미지에서
CredentialsRequestCR(사용자 정의 리소스) 목록을 추출합니다.$ oc adm release extract \ --from=$RELEASE_IMAGE \ --credentials-requests \ --included \ --install-config=<path_to_directory_with_installation_configuration>/install-config.yaml \ --to=<path_to_directory_for_credentials_requests>다음과 같습니다.
--included- 특정 클러스터 구성에 필요한 매니페스트만 지정합니다.
<path_to_directory_with_installation_configuration>-
install-config.yaml파일의 위치를 지정합니다. <path_to_directory_for_credentials_requests>CredentialsRequest오브젝트를 저장할 디렉터리의 경로를 지정합니다. 지정된 디렉터리가 없으면 이 명령이 이를 생성합니다.이 명령을 수행하면 각
CredentialsRequest오브젝트에 대해 YAML 파일이 생성됩니다.샘플
CredentialsRequest개체apiVersion: cloudcredential.openshift.io/v1 kind: CredentialsRequest metadata: name: <component_credentials_request> namespace: openshift-cloud-credential-operator ... spec: providerSpec: apiVersion: cloudcredential.openshift.io/v1 kind: GCPProviderSpec predefinedRoles: - roles/storage.admin - roles/iam.serviceAccountUser skipServiceCheck: true ...
이전에 생성한
openshift-install매니페스트 디렉터리에 시크릿 YAML 파일을 만듭니다. 시크릿은 각CredentialsRequest오브젝트의spec.secretRef에 정의된 네임 스페이스 및 시크릿 이름을 사용하여 저장해야 합니다.시크릿이 포함된 샘플
CredentialsRequest오브젝트apiVersion: cloudcredential.openshift.io/v1 kind: CredentialsRequest metadata: name: <component_credentials_request> namespace: openshift-cloud-credential-operator ... spec: providerSpec: apiVersion: cloudcredential.openshift.io/v1 ... secretRef: name: <component_secret> namespace: <component_namespace> ...샘플
Secret오브젝트apiVersion: v1 kind: Secret metadata: name: <component_secret> namespace: <component_namespace> data: service_account.json: <base64_encoded_gcp_service_account_file>중요수동으로 유지 관리되는 인증 정보를 사용하는 클러스터를 업그레이드하기 전에 CCO가 업그레이드 가능한 상태인지 확인해야 합니다.
4.10.2. Google Cloud 클러스터의 단기 인증 정보 구성 링크 복사링크가 클립보드에 복사되었습니다!
Google Cloud Workload Identity를 사용하도록 구성된 OpenShift Container Platform 클러스터를 설치하려면 CCO(Cloud Credential Operator) 유틸리티를 구성하고 클러스터에 필요한 Google Cloud 리소스를 생성해야 합니다.
클러스터 Operator는 CCO에서 생성한 인증 정보를 사용합니다. 설치 프로그램에서 이러한 인증 정보를 사용하지 않습니다.
4.10.2.1. Cloud Credential Operator 유틸리티 구성 링크 복사링크가 클립보드에 복사되었습니다!
CCO(Cloud Credential Operator)가 수동 모드에서 작동할 때 클러스터 외부에서 클라우드 인증 정보를 생성하고 관리하려면 CCO 유틸리티(ccoctl) 바이너리를 추출 및 준비합니다.
ccoctl 유틸리티는 Linux 환경에서 실행해야 하는 Linux 바이너리입니다.
사전 요구 사항
- 클러스터 관리자 액세스 권한이 있는 OpenShift Container Platform 계정에 액세스할 수 있습니다.
-
OpenShift CLI(
oc)가 설치되어 있습니다.
ccoctl유틸리티에서 사용하는 Google Cloud 계정에 다음 인증 옵션 중 하나를 추가했습니다.- IAM 워크로드 ID 풀 관리자 역할
다음과 같은 세분화된 권한:
-
compute.projects.get -
iam.googleapis.com/workloadIdentityPoolProviders.create -
iam.googleapis.com/workloadIdentityPoolProviders.get -
iam.googleapis.com/workloadIdentityPools.create -
iam.googleapis.com/workloadIdentityPools.delete -
iam.googleapis.com/workloadIdentityPools.get -
iam.googleapis.com/workloadIdentityPools.undelete -
iam.roles.create -
iam.roles.delete -
iam.roles.list -
iam.roles.undelete -
iam.roles.update -
iam.serviceAccounts.create -
iam.serviceAccounts.delete -
iam.serviceAccounts.getIamPolicy -
iam.serviceAccounts.list -
iam.serviceAccounts.setIamPolicy -
iam.workloadIdentityPoolProviders.get -
iam.workloadIdentityPools.delete -
resourcemanager.projects.get -
resourcemanager.projects.getIamPolicy -
resourcemanager.projects.setIamPolicy -
storage.buckets.create -
storage.buckets.delete -
storage.buckets.get -
storage.buckets.getIamPolicy -
storage.buckets.setIamPolicy -
storage.objects.create -
storage.objects.delete -
storage.objects.list
-
프로세스
다음 명령을 실행하여 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.<rhel_version>" \ -a ~/.pull-secret&
lt;rhel_version> 의 경우 호스트가 사용하는 RHEL(Red Hat Enterprise Linux) 버전에 해당하는 값을 지정합니다. 값을 지정하지 않으면 기본적으로ccoctl.rhel8이 사용됩니다. 다음 값이 유효합니다.-
rhel8: RHEL 8을 사용하는 호스트에 대해 이 값을 지정합니다. -
rhel9: RHEL 9를 사용하는 호스트에 대해 이 값을 지정합니다.
참고ccoctl바이너리는/usr/bin/에서는 명령을 실행한 디렉터리에 생성됩니다. 디렉터리 이름을 바꾸거나ccoctl.<rhel_version> 바이너리를ccoctl으로 이동해야 합니다.-
다음 명령을 실행하여
ccoctl을 실행할 수 있도록 권한을 변경합니다.$ chmod 775 ccoctl
검증
ccoctl을 사용할 준비가 되었는지 확인하려면 도움말 파일을 표시합니다. 명령을 실행할 때 상대 파일 이름을 사용합니다. 예를 들면 다음과 같습니다.$ ./ccoctl출력 예
OpenShift credentials provisioning tool Usage: ccoctl [command] Available Commands: aws Manage credentials objects for AWS cloud azure Manage credentials objects for Azure 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.
4.10.2.2. Cloud Credential Operator 유틸리티를 사용하여 Google Cloud 리소스 생성 링크 복사링크가 클립보드에 복사되었습니다!
ccoctl gcp create-all 명령을 사용하여 Google Cloud 리소스 생성을 자동화할 수 있습니다.
기본적으로 ccoctl은 명령이 실행되는 디렉터리에 오브젝트를 생성합니다. 다른 디렉터리에 오브젝트를 생성하려면 --output-dir 플래그를 사용합니다. 이 절차에서는 <path_to_ccoctl_output_dir>을 사용하여 이 디렉터리를 나타냅니다.
사전 요구 사항
다음이 있어야 합니다.
-
ccoctl바이너리를 추출하여 준비합니다.
프로세스
다음 명령을 실행하여 설치 파일의 릴리스 이미지로
$RELEASE_IMAGE변수를 설정합니다.$ RELEASE_IMAGE=$(./openshift-install version | awk '/release image/ {print $3}')다음 명령을 실행하여 OpenShift Container Platform 릴리스 이미지에서
CredentialsRequest오브젝트 목록을 추출합니다.$ oc adm release extract \ --from=$RELEASE_IMAGE \ --credentials-requests \ --included \ --install-config=<path_to_directory_with_installation_configuration>/install-config.yaml \ --to=<path_to_directory_for_credentials_requests>다음과 같습니다.
--included- 특정 클러스터 구성에 필요한 매니페스트만 포함하도록 지정합니다.
<path_to_directory_with_installation_configuration>-
install-config.yaml파일의 위치를 지정합니다. <path_to_directory_for_credentials_requests>CredentialsRequest오브젝트를 저장할 디렉터리의 경로를 지정합니다. 지정된 디렉터리가 없으면 이 명령이 이를 생성합니다.참고이 명령을 실행하는 데 시간이 다소 걸릴 수 있습니다.
ccoctl툴을 사용하여 다음 명령을 실행하여 모든CredentialsRequest오브젝트를 처리합니다.$ ccoctl gcp create-all \ --name=<name> \ --region=<gcp_region> \ --project=<gcp_project_id> \ --credentials-requests-dir=<path_to_credentials_requests_directory> \ --key-storage-method=<key_storage_method>다음과 같습니다.
<name>- 추적에 사용되는 모든 생성된 Google Cloud 리소스의 사용자 정의 이름을 지정합니다. Google Cloud Filestore CSI(Container Storage Interface) Driver Operator를 설치하려는 경우 이 값을 유지합니다.
<gcp_region>- 클라우드 리소스를 생성할 Google Cloud 리전을 지정합니다.
<gcp_project_id>- 클라우드 리소스를 생성할 Google Cloud 프로젝트 ID를 지정합니다.
<path_to_credentials_requests_directory>-
Google Cloud 서비스 계정을 생성하기 위해
CredentialsRequest매니페스트 파일이 포함된 디렉터리를 지정합니다. <key_storage_method>OIDC JWK 파일을 저장하는 방법을 지정합니다. 허용되는 값은
public-bucket및pool-jwk-file입니다. 기본 값public-bucket은 OIDC 구성 및 JWK 파일을 호스팅할 공용 GCS 버킷을 생성합니다.pool-jwk-file값은 공용 버킷을 생성하지 않고 JWK를 워크로드 ID 풀 공급자에 직접 연결합니다. 이 매개변수는 선택 사항입니다.참고클러스터에서
TechPreviewNoUpgrade기능 세트에서 활성화한 기술 프리뷰 기능을 사용하는 경우--enable-tech-preview매개변수를 포함해야 합니다.
검증
OpenShift Container Platform 보안이 생성되었는지 확인하려면
<path_to_ccoctl_output_dir>/manifests디렉터리에 파일을 나열합니다.$ ls <path_to_ccoctl_output_dir>/manifests출력 예
cluster-authentication-02-config.yaml openshift-cloud-controller-manager-gcp-ccm-cloud-credentials-credentials.yaml openshift-cloud-credential-operator-cloud-credential-operator-gcp-ro-creds-credentials.yaml openshift-cloud-network-config-controller-cloud-credentials-credentials.yaml openshift-cluster-api-capg-manager-bootstrap-credentials-credentials.yaml openshift-cluster-csi-drivers-gcp-pd-cloud-credentials-credentials.yaml openshift-image-registry-installer-cloud-credentials-credentials.yaml openshift-ingress-operator-cloud-credentials-credentials.yaml openshift-machine-api-gcp-cloud-credentials-credentials.yamlGoogle Cloud를 쿼리하여 IAM 서비스 계정이 생성되었는지 확인할 수 있습니다. 자세한 내용은 IAM 서비스 계정 나열에 대한 Google Cloud 설명서를 참조하십시오.
4.10.2.3. 컴퓨팅 노드 서비스 계정으로 서비스 계정 가장 제한 링크 복사링크가 클립보드에 복사되었습니다!
Cloud Credential Operator 유틸리티(ccoctl)가 클러스터에 대한 리소스를 생성한 후 ccoctl 유틸리티가 컴퓨팅 노드 서비스 계정에 머신 API 컨트롤러 서비스 계정에 부여된 Google Cloud iam.serviceAccounts.actAs 권한을 제한할 수 있습니다.
서비스 계정 가장을 컴퓨팅 노드 서비스 계정으로 제한하는 것은 선택 사항입니다. 조직에 이러한 변경이 필요하지 않은 경우 "Cloud Credential Operator 유틸리티 매니페스트 통합"을 계속할 수 있습니다.
ccoctl 유틸리티는 OpenShift Container Platform 구성 요소 서비스 계정에 사용자 지정 및 Google Cloud 사전 정의된 역할을 할당하는 경우 Google Cloud 프로젝트 수준에서 Machine API 컨트롤러 서비스 계정에 iam.serviceAccounts.actAs 권한을 부여합니다. iam.serviceAccounts.actAs 권한의 범위를 줄이기 위해 Machine API 컨트롤러 서비스 계정의 사용자 지정 역할을 식별하고 더 제한된 권한 세트가 있는 역할로 교체합니다. 이 구성 요소가 작동하도록 허용하려면 대신 Machine API 컨트롤러 서비스 계정에 컴퓨팅 노드의 서비스 계정에 대한 서비스 계정 사용자 역할을 부여합니다.
사전 요구 사항
- 클러스터를 호스팅하는 클라우드 플랫폼으로 계정을 구성했습니다.
-
ccoctl유틸리티를 사용하여 클러스터의 클라우드 공급자 리소스를 생성했습니다. -
install-config.yaml파일에 액세스할 수 있습니다. -
서비스 계정 및 역할을 관리할 수 있는 권한이 있는 사용자로 Google Cloud CLI(
gcloud)에 로그인했습니다.
절차
install-config.yaml파일에서 다음 값을 가져옵니다.-
Google Cloud 프로젝트 이름입니다. YAML 파일에서는
platform.gcp.projectID매개변수의 값입니다. -
클러스터 이름입니다. YAML 파일에서는
metadata.name매개변수의 값입니다. -
컴퓨팅 노드의 서비스 계정입니다. YAML 파일에서 이는
compute[0].platform.gcp.serviceAccount매개변수의 값입니다.
-
Google Cloud 프로젝트 이름입니다. YAML 파일에서는
다음 명령을 실행하여
ccoctl유틸리티가 생성한 Machine API 컨트롤러의 서비스 계정을 가져옵니다.$ gcloud iam service-accounts list \ --filter="displayName=<cluster_name>-openshift-machine-api-gcp" \ --format='value(email)'여기서
<cluster_name>은install-config.yaml파일의metadata.name매개변수에 지정된 값입니다.다음 명령을 실행하여 Machine API 컨트롤러 서비스 계정에 대한 사용자 정의 역할의 역할 ID를 가져옵니다.
$ gcloud projects get-iam-policy <project_name> \ --flatten='bindings[].members' \ --format='table(bindings.role)' \ --filter="bindings.members:<machine_api_controller_service_account>"여기서
<machine_api_controller_service_account>는 Machine API 컨트롤러 서비스 계정입니다.다음 명령을 실행하여 Machine API 컨트롤러 서비스 계정에 대한 사용자 정의 역할 권한을 나열합니다.
$ gcloud iam roles describe <machine_api_role> \ --project <project_name>여기서
<machine_api_role>은 Machine API 컨트롤러 서비스 계정에 대한 사용자 지정 역할의 역할 ID입니다.출력 예
etag: <etag_value> includedPermissions: - compute.acceleratorTypes.get - compute.acceleratorTypes.list - compute.disks.create - compute.disks.createTagBinding ... - compute.zones.get - compute.zones.list - iam.serviceAccounts.actAs - iam.serviceAccounts.get - iam.serviceAccounts.list - resourcemanager.tagValues.get - resourcemanager.tagValues.list - serviceusage.quotas.get - serviceusage.services.get - serviceusage.services.list name: projects/<project_name>/roles/<machine_api_role> stage: GA title: <project_name>-openshift-machine-api-gcp여기서
<project_name>은install-config.yaml파일에 지정된 Google Cloud 프로젝트 이름입니다.참고이 잘린 예제 출력은 클러스터의 권한 목록과 일치하지 않을 수 있습니다.
다음과 유사한 명령을 실행하여
iam.serviceAccounts.actAs권한을 제외한 출력의 모든 권한을 포함하는 사용자 지정 역할을 생성합니다.$ gcloud iam roles create <machine_api_role>_without_actas \ --project=<project_name> \ --title=<machine_api_role>_without_actas \ --description="Required permissions for the Machine API controller without the iam.serviceAccounts.actAs permission" \ --permissions=compute.acceleratorTypes.get,\ compute.acceleratorTypes.list,\ compute.disks.create,\ compute.disks.createTagBinding,\ ... compute.zones.get,\ compute.zones.list,\ iam.serviceAccounts.get,\ iam.serviceAccounts.list,\ resourcemanager.tagValues.get,\ resourcemanager.tagValues.list,\ serviceusage.quotas.get,\ serviceusage.services.get,\ serviceusage.services.list이 예제에서 새 역할 이름은 원래의 사용자 지정 역할 이름인 <
machine_api_role>이며_without_actas문자열이 끝에 추가됩니다.중요이 잘린 예제 명령은 클러스터의 권한 목록과 일치하지 않을 수 있습니다. 클러스터에서
gcloud iam roles describe <machine_api_role> --project <project_name> 명령 출력의 권한 목록을 사용해야 합니다.다음 명령을 실행하여 Machine API 컨트롤러 서비스 계정에서
iam.serviceAccounts.actAs권한이 포함된 사용자 지정 역할을 제거합니다.$ gcloud projects remove-iam-policy-binding <project_name> \ --member "serviceAccount:<machine_api_controller_service_account>" \ --role "projects/<project_name>/roles/<machine_api_role>"여기서 &
lt;machine_api_role>은 원래 사용자 지정 역할입니다.다음 명령을 실행하여 Machine API 컨트롤러 서비스 계정에
iam.serviceAccounts.actAs권한을 제외하는 사용자 지정 역할을 부여합니다.$ gcloud projects add-iam-policy-binding <project_name> \ --member "serviceAccount:<machine_api_controller_service_account>" \ --role "projects/<project_name>/roles/<machine_api_role>_without_actas여기서 &
lt;machine_api_role>_without_actas는 새 사용자 지정 역할입니다.선택 사항: Machine API 컨트롤러 서비스 계정에 올바른 역할이 있는지 확인하려면 다음 명령을 실행하여 연결된 역할 ID를 확인합니다.
$ gcloud projects get-iam-policy <project_name> \ --flatten='bindings[].members' \ --format='table(bindings.role)' \ --filter="bindings.members:<machine_api_controller_service_account>"출력 예
ROLE projects/<project_name>/roles/<machine_api_role>_without_actas다음 명령을 실행하여 Machine API 컨트롤러 서비스 계정에 컴퓨팅 노드의 서비스 계정에 대한 서비스 계정 사용자 역할을 부여합니다.
$ gcloud iam service-accounts add-iam-policy-binding <compute_nodes_service_account> \ --member="serviceAccount:<machine_api_controller_service_account>" \ --role=roles/iam.serviceAccountUser여기서
<compute_nodes_service_account>는 컴퓨팅 노드의 서비스 계정입니다. 이 값은install-config.yaml파일의compute[0].platform.gcp.serviceAccount매개변수입니다.
4.10.2.4. Cloud Credential Operator 유틸리티 매니페스트 통합 링크 복사링크가 클립보드에 복사되었습니다!
개별 OpenShift Container Platform 구성 요소의 클러스터 외부에서 관리되는 단기 보안 인증 정보를 구현하려면 Cloud Credential Operator 유틸리티(ccoctl)가 생성된 매니페스트 파일을 설치 프로그램의 올바른 디렉터리로 이동해야 합니다.
사전 요구 사항
- 클러스터를 호스팅하는 클라우드 플랫폼으로 계정을 구성했습니다.
-
Cloud Credential Operator 유틸리티(
ccoctl)를 구성했습니다. -
ccoctl유틸리티를 사용하여 클러스터에 필요한 클라우드 공급자 리소스를 생성했습니다.
절차
설치 프로그램에서 사용하는 Google Cloud 계정에 다음 세분화된 권한을 추가합니다.
- compute.machineTypes.list
- compute.regions.list
- compute.zones.list
- dns.changes.create
- dns.changes.get
- dns.managedZones.create
- dns.managedZones.delete
- dns.managedZones.get
- dns.managedZones.list
- dns.networks.bindPrivateDNSZone
- dns.resourceRecordSets.create
- dns.resourceRecordSets.delete
- dns.resourceRecordSets.list
install-config.yaml구성 파일의credentialsMode매개변수를Manual로 설정하지 않은 경우 다음과 같이 값을 수정합니다.구성 파일 스니펫 샘플
apiVersion: v1 baseDomain: example.com credentialsMode: Manual # ...이전에 설치 매니페스트 파일을 생성하지 않은 경우 다음 명령을 실행하여 수행합니다.
$ openshift-install create manifests --dir <installation_directory>여기서
<installation_directory>는 설치 프로그램이 파일을 생성하는 디렉터리입니다.ccoctl유틸리티가 생성된매니페스트를 다음 명령을 실행하여 설치 프로그램에서 생성한 매니페스트에 복사합니다.$ cp /<path_to_ccoctl_output_dir>/manifests/* ./manifests/개인 키가 포함된
tls디렉터리를 설치 디렉터리에 복사합니다.$ cp -a /<path_to_ccoctl_output_dir>/tls .
4.11. Google Cloud Marketplace 오퍼링 사용 링크 복사링크가 클립보드에 복사되었습니다!
Google Cloud Marketplace 오퍼링을 통해 OpenShift Container Platform 클러스터를 배포할 수 있습니다. 이는 Google Cloud를 통해 사용량 기준(시간당 코어당)으로 청구됩니다. Red Hat은 이러한 클러스터에 대한 직접 지원을 계속 제공합니다.
기본적으로 설치 프로그램은 컴퓨팅 머신을 배포하는 데 사용되는 RHCOS(Red Hat Enterprise Linux CoreOS) 이미지를 다운로드하여 설치합니다. Google Cloud Marketplace의 RHCOS 이미지를 사용하여 OpenShift Container Platform 클러스터를 배포하려면 install-config.yaml 파일을 수정하여 Google Cloud Marketplace 제공 위치를 참조하여 기본 동작을 재정의합니다.
Google Cloud Marketplace 이미지를 사용하도록 컴퓨팅 머신의 RHCOS 이미지만 수정해야 합니다. 컨트롤 플레인 머신 및 인프라 노드에는 OpenShift Container Platform 서브스크립션이 필요하지 않으며 기본적으로 공용 RHCOS 기본 이미지를 사용합니다. 이 이미지는 Google Cloud 청구에서 서브스크립션 비용이 발생하지 않습니다. 따라서 클러스터 기본 부팅 이미지 또는 컨트롤 플레인 부팅 이미지를 수정해서는 안 됩니다. Google Cloud Marketplace 이미지를 적용하면 복구할 수 없는 추가 라이센싱 비용이 발생합니다.
사전 요구 사항
-
기존
install-config.yaml파일이 있습니다.
절차
compute.platform.gcp.osImage매개변수를 편집하여 Google Cloud Marketplace 이미지의 위치를 지정합니다.-
project매개변수를redhat-marketplace-public으로 설정합니다. name매개변수를 다음 제안 중 하나로 설정합니다.- OpenShift Container Platform
-
redhat-coreos-ocp-413-x86-64-202305021736 - OpenShift Platform Plus
-
redhat-coreos-opp-413-x86-64-202305021736 - OpenShift Kubernetes Engine
-
redhat-coreos-oke-413-x86-64-202305021736
-
파일을 저장하고 클러스터를 배포할 때 참조합니다.
다음 샘플
install-config.yaml파일은 컴퓨팅 머신의 Google Cloud Marketplace 이미지를 지정합니다.apiVersion: v1 baseDomain: example.com controlPlane: # ... compute: platform: gcp: osImage: project: redhat-marketplace-public name: redhat-coreos-ocp-413-x86-64-202305021736 # ...
4.12. 네트워크 구성 단계 링크 복사링크가 클립보드에 복사되었습니다!
기존 네트워크 환경과 통합하기 전에 두 단계에서 클러스터 네트워크 CIDR 및 서비스 네트워크 범위와 같은 OpenShift Container Platform 네트워크 플러그인 구성을 사용자 지정할 수 있습니다.
- 1 단계
매니페스트 파일을 생성하기 전에
install-config.yaml파일에서 다음 네트워크 관련 필드를 사용자 지정할 수 있습니다.-
networking.networkType -
networking.clusterNetwork -
networking.serviceNetwork -
networking.machineNetwork nodeNetworking자세한 내용은 "설치 구성 매개변수"를 참조하십시오.
참고기본 서브넷이 있는 CIDR(Classless Inter-Domain Routing)과 일치하도록
networking.machineNetwork를 설정합니다.중요CIDR 범위
172.17.0.0/16은libVirt에 의해 예약되어 있습니다. 클러스터의 네트워크에172.17.0.0/16CIDR 범위와 겹치는 다른 CIDR 범위는 사용할 수 없습니다.
-
- 2 단계
-
openshift-install create manifests 를실행하여 매니페스트 파일을 생성한 후 수정할 필드로 사용자 지정된 Cluster Network Operator 매니페스트를 정의할 수 있습니다. 매니페스트를 사용하여 고급 네트워크 구성을 지정할 수 있습니다.
2 단계에서는 install-config.yaml 파일에서 1단계에서 지정한 값을 덮어쓸 수 없습니다. 그러나 2 단계에서 네트워크 플러그인을 사용자 지정할 수 있습니다.
4.13. 고급 네트워크 구성 지정 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 네트워크 플러그인의 고급 네트워크 구성을 사용하여 클러스터를 기존 네트워크 환경에 통합할 수 있습니다.
클러스터를 설치하기 전에만 고급 네트워크 구성을 지정할 수 있습니다.
설치 프로그램에서 생성한 OpenShift Container Platform 매니페스트 파일을 수정하여 네트워크 구성을 사용자 정의하는 것은 지원되지 않습니다. 다음 절차에서와 같이 생성한 매니페스트 파일을 적용할 수 있습니다.
사전 요구 사항
-
install-config.yaml파일을 생성하고 수정 작업을 완료했습니다.
프로세스
설치 프로그램이 포함된 디렉터리로 변경하고 매니페스트를 생성합니다.
$ ./openshift-install create manifests --dir <installation_directory>여기서
<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파일에서 클러스터의 고급 네트워크 구성을 지정합니다.다음 예제에서는 OVN-Kubernetes 네트워크 공급자에 대해 IPsec을 활성화합니다.
apiVersion: operator.openshift.io/v1 kind: Network metadata: name: cluster spec: defaultNetwork: ovnKubernetesConfig: ipsecConfig: mode: Full-
선택사항:
manifests/cluster-network-03-config.yml파일을 백업합니다. 설치 프로그램은 Ignition 구성 파일을 생성할 때manifests/디렉터리를 사용합니다. 컨트롤 플레인 머신과 컴퓨팅
MachineSets를정의하는 Kubernetes 매니페스트 파일을 제거합니다.$ rm -f openshift/99_openshift-cluster-api_master-machines-*.yaml openshift/99_openshift-cluster-api_worker-machineset-*.yaml이러한 리소스는 사용자가 직접 생성하고 관리하기 때문에 초기화할 필요가 없습니다.
-
머신 API를 사용하여 컴퓨팅 머신을 생성하기 위해
MachineSet파일을 보존할 수 있지만, 사용자 환경과 일치하도록 해당 참조를 업데이트해야 합니다.
-
머신 API를 사용하여 컴퓨팅 머신을 생성하기 위해
4.14. CNO(Cluster Network Operator) 구성 링크 복사링크가 클립보드에 복사되었습니다!
클러스터 네트워킹을 관리하려면 클러스터가 안정적인 Pod 및 서비스 연결을 위해 올바른 IP 범위 및 네트워크 플러그인 설정을 사용하도록 cluster 라는 CNO(Cluster Network Operator) 네트워크 사용자 정의 리소스(CR)를 구성합니다.
일부 설정 및 필드는 설치 시 또는 default.Network.type 플러그인인 OVN-Kubernetes에 의해 상속됩니다.
CNO 구성은 Network.config.openshift.io API 그룹의 Network API에서 클러스터 설치 중에 다음 필드를 상속합니다.
clusterNetwork- Pod IP 주소가 할당되는 IP 주소 풀입니다.
serviceNetwork- 서비스를 위한 IP 주소 풀입니다.
defaultNetwork.type-
클러스터 네트워크 플러그인.
OVNKubernetes는 설치 중에 지원되는 유일한 플러그인입니다.
cluster라는 CNO 오브젝트에서 defaultNetwork 오브젝트의 필드를 설정하여 클러스터의 클러스터 네트워크 플러그인 구성을 지정할 수 있습니다.
4.14.1. CNO(Cluster Network Operator) 구성 오브젝트 링크 복사링크가 클립보드에 복사되었습니다!
CNO(Cluster Network Operator)의 필드는 다음 표에 설명되어 있습니다.
| 필드 | 유형 | 설명 |
|---|---|---|
|
|
|
CNO 개체 이름입니다. 이 이름은 항상 |
|
|
| Pod IP 주소가 할당되는 IP 주소 블록과 클러스터의 각 개별 노드에 할당된 서브넷 접두사 길이를 지정하는 목록입니다. 듀얼 스택 네트워킹을 사용하는 경우 IPv4 및 IPv6 주소 제품군을 지정합니다. 예를 들면 다음과 같습니다. spec:
clusterNetwork:
- cidr: 10.128.0.0/19
hostPrefix: 23
- cidr: fd01::/48
hostPrefix: 64
듀얼 스택 네트워킹을 사용하여 AWS에 클러스터를 설치하는 경우 주소 순서는 선택한 듀얼 스택 구성과 일치해야 합니다. 예를 들어 |
|
|
| 서비스의 IP 주소 블록입니다. 듀얼 스택 네트워킹을 사용하는 경우 IPv4 및 IPv6 주소 제품군을 지정합니다. 예를 들면 다음과 같습니다. spec:
serviceNetwork:
- 172.30.0.0/14
- fd02::/112
듀얼 스택 네트워킹을 사용하여 AWS에 클러스터를 설치하는 경우 주소 순서는 선택한 듀얼 스택 구성과 일치해야 합니다. 예를 들어
매니페스트를 생성하기 전에 |
|
|
| 클러스터 네트워크의 네트워크 플러그인을 구성합니다. |
|
|
|
이 설정은 동적 라우팅 공급자를 활성화합니다. 경로 광고 기능에는 FRR 라우팅 기능 공급자가 필요합니다. 지원되는 유일한 값은
spec:
additionalRoutingCapabilities:
providers:
- FRR
|
|
|
| 선택 사항: 클러스터를 생성하는 동안 Network Observability Operator를 설치합니다.
기본적으로 네트워크 관찰 기능이 활성화되어 있는지 여부를 제어하도록 클러스터를 생성하기 전에 참고
네트워크 관찰 기능 자동 설치 구성은 기술 프리뷰 기능입니다. |
여러 네트워크에 오브젝트를 배포해야 하는 클러스터의 경우 install-config.yaml 파일에 정의된 각 네트워크 유형에 대해 clusterNetwork.hostPrefix 매개변수에 동일한 값을 지정해야 합니다. 각 clusterNetwork.hostPrefix 매개변수에 다른 값을 설정하면 플러그인이 다른 노드 간에 오브젝트 트래픽을 효과적으로 라우팅할 수 없는 OVN-Kubernetes 네트워크 플러그인에 영향을 미칠 수 있습니다.
4.14.2. defaultNetwork 오브젝트 구성 링크 복사링크가 클립보드에 복사되었습니다!
defaultNetwork 오브젝트의 값은 다음 표에 정의되어 있습니다.
| 필드 | 유형 | 설명 |
|---|---|---|
|
|
|
참고 OpenShift Container Platform은 기본적으로 OVN-Kubernetes 네트워크 플러그인을 사용합니다. |
|
|
| 이 오브젝트는 OVN-Kubernetes 네트워크 플러그인에만 유효합니다. |
4.14.3. OVN-Kubernetes 네트워크 플러그인 구성 링크 복사링크가 클립보드에 복사되었습니다!
다음 표에서는 OVN-Kubernetes 네트워크 플러그인의 구성 필드를 설명합니다.
| 필드 | 유형 | 설명 |
|---|---|---|
|
|
| Geneve(Generic Network Virtualization Encapsulation) 오버레이 네트워크의 MTU(최대 전송 단위)입니다. 이는 기본 네트워크 인터페이스의 MTU를 기준으로 자동 탐지됩니다. 일반적으로 감지된 MTU를 재정의할 필요는 없습니다. 자동 감지 값이 예상 밖인 경우 노드의 기본 네트워크 인터페이스의 MTU가 올바른지 확인합니다. 이 옵션을 사용하여 노드의 기본 네트워크 인터페이스의 MTU 값을 변경할 수 없습니다.
클러스터에 다른 노드에 대한 다른 MTU 값이 필요한 경우, 이 값을 클러스터의 가장 낮은 MTU 값보다 |
|
|
|
모든 Geneve 패킷에 사용할 포트입니다. 기본값은 |
|
|
| IPsec 구성을 사용자 정의할 구성 오브젝트를 지정합니다. |
|
|
| IPv4 설정에 대한 구성 오브젝트를 지정합니다. |
|
|
| IPv6 설정에 대한 구성 오브젝트를 지정합니다. |
|
|
| 네트워크 정책 감사 로깅을 사용자 정의할 구성 오브젝트를 지정합니다. 설정되지 않으면 기본값 감사 로그 설정이 사용됩니다. |
|
|
|
클러스터 네트워크 경로를 알릴지 여부를 지정합니다. 기본값은
|
|
|
|
선택 사항: 송신 트래픽이 노드 게이트웨이로 전송되는 방법을 사용자 정의할 구성 오브젝트를 지정합니다. 유효한 값은 참고 송신 트래픽을 마이그레이션하는 동안 CNO(Cluster Network Operator)에서 변경 사항을 성공적으로 롤아웃할 때까지 워크로드 및 서비스 트래픽에 대한 일부 중단을 기대할 수 있습니다. |
| 필드 | 유형 | 설명 |
|---|---|---|
|
| string |
기존 네트워크 인프라가
기본값은 |
|
| string |
기존 네트워크 인프라가
기본값은 |
| 필드 | 유형 | 설명 |
|---|---|---|
|
| string |
기존 네트워크 인프라가
기본값은 |
|
| string |
기존 네트워크 인프라가
기본값은 |
| 필드 | 유형 | 설명 |
|---|---|---|
|
| integer |
노드당 1초마다 생성할 최대 메시지 수입니다. 기본값은 초당 |
|
| integer |
감사 로그의 최대 크기(바이트)입니다. 기본값은 |
|
| integer | 유지되는 최대 로그 파일 수입니다. |
|
| string | 다음 추가 감사 로그 대상 중 하나입니다.
|
|
| string |
RFC5424에 정의된 |
| 필드 | 유형 | 설명 |
|---|---|---|
|
|
|
Pod에서 호스트 네트워킹 스택으로 송신 트래픽을 보내려면 이 필드를
이 필드는 Open vSwitch 하드웨어 오프로드 기능과 상호 작용합니다. 이 필드를 |
|
|
|
참고
|
|
|
| 선택 사항: IPv4 주소에 대한 트래픽을 서비스하는 호스트의 내부 OVN-Kubernetes masquerade 주소를 구성하려면 오브젝트를 지정합니다. |
|
|
| 선택 사항: IPv6 주소의 서비스 트래픽을 위해 호스트의 내부 OVN-Kubernetes masquerade 주소를 구성하려면 오브젝트를 지정합니다. |
| 필드 | 유형 | 설명 |
|---|---|---|
|
|
|
내부적으로 사용되는 가상 IPv4 주소입니다. 트래픽을 서비스할 호스트를 활성화하는 데 사용됩니다. 호스트는 이러한 IP 주소 및 공유 게이트웨이 브리지 인터페이스로 구성됩니다. 기본값은 중요
OpenShift Container Platform 4.17 이상 버전의 경우 클러스터는 |
| 필드 | 유형 | 설명 |
|---|---|---|
|
|
|
내부적으로 사용되는 가상 IPv6 주소입니다. 트래픽을 서비스하는 호스트를 활성화하는 데 사용됩니다. 호스트는 이러한 IP 주소 및 공유 게이트웨이 브리지 인터페이스로 구성됩니다. 기본값은 중요
OpenShift Container Platform 4.17 이상 버전의 경우 클러스터는 |
| 필드 | 유형 | 설명 |
|---|---|---|
|
|
| IPsec 구현의 동작을 지정합니다. 다음 값 중 하나여야 합니다.
|
| 필드 | 유형 | 설명 |
|---|---|---|
|
|
| 클러스터 생성 중에 Network Observability Operator가 설치되어 있는지 여부를 제어합니다. 유효한 값은 다음과 같습니다.
배포 후 CNO는 Network Observability Operator가 제거된 경우 이를 모니터링하거나 다시 설치하지 않습니다. apiVersion: operator.openshift.io/v1
kind: Network
metadata:
name: cluster
spec:
networkObservability:
installationPolicy: InstallAndEnable
참고
이 필드는 |
IPsec이 활성화된 OVN-Kubernetes 구성의 예
defaultNetwork:
type: OVNKubernetes
ovnKubernetesConfig:
mtu: 1400
genevePort: 6081
ipsecConfig:
mode: Full
4.15. 클러스터 배포 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 클러스터를 배포하려면 설치 프로그램이 포함된 디렉터리에서 openshift-install create cluster 명령을 실행하여 설치를 초기화합니다. 설치 프로그램은 필요한 인프라를 프로비저닝하고 클러스터 설정을 완료합니다.
최초 설치 과정에서 설치 프로그램의 create cluster 명령을 한 번만 실행할 수 있습니다.
사전 요구 사항
- 클러스터를 호스팅하는 클라우드 플랫폼으로 계정을 구성했습니다.
- OpenShift Container Platform 설치 프로그램과 클러스터의 풀 시크릿이 있습니다.
- 호스트의 클라우드 공급자 계정에 클러스터를 배포할 수 있는 올바른 권한이 있는지 확인했습니다. 잘못된 권한이 있는 계정으로 인해 누락된 권한이 표시되는 오류 메시지와 함께 설치 프로세스가 실패합니다.
절차
클러스터에 대해 구성한 Google Cloud 계정에 서비스 계정 키를 사용하지 않고 다음 위치에 저장된 기존 Google Cloud 인증 정보를 삭제합니다.
-
GOOGLE_CREDENTIALS,GOOGLE_CLOUD_KEYFILE_JSON또는GCLOUD_KEYFILE_JSON환경 변수 -
~/.gcp/osServiceAccount.json파일 -
gcloud cli기본 자격 증명
-
설치 프로그램이 포함된 디렉터리에서 다음 명령을 실행하여 클러스터 배포를 초기화합니다.
$ ./openshift-install create cluster --dir <installation_directory> \ --log-level=info다음과 같습니다.
-
<installation_directory> : 사용자 지정./install-config.yaml파일의 위치를 지정합니다. -
--log-level: 로그 수준을 지정합니다. 다른 설치 세부 사항을 보려면info대신warn,debug또는error를 지정합니다.
-
선택사항: 클러스터를 설치하는 데 사용한 서비스 계정에 대한 권한 수를 줄일 수 있습니다.
-
서비스 계정에
Owner역할을 할당한 경우, 해당 역할을 제거하고Viewer역할로 바꿀 수 있습니다. -
Service Account Key Admin역할이 포함되어 있으면 제거할 수도 있습니다.
-
서비스 계정에
검증
클러스터 배포가 성공적으로 완료되면 다음을 수행합니다.
-
터미널에는 웹 콘솔에 대한 링크 및
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 구성 파일을 사용하면 설치 중에 인증서 업데이트가 실행되는 경우 설치 실패를 방지할 수 있습니다.
-
설치 프로그램에서 생성하는 Ignition 구성 파일에 24시간 후에 만료되는 인증서가 포함되어 있습니다. 이 인증서는 그 후에 갱신됩니다. 인증서를 갱신하기 전에 클러스터가 종료되고 24시간이 지난 후에 클러스터가 다시 시작되면 클러스터는 만료된 인증서를 자동으로 복구합니다. 예외적으로 kubelet 인증서를 복구하려면 대기 중인
4.16. 자체 DNS 레코드 프로비저닝 링크 복사링크가 클립보드에 복사되었습니다!
클러스터 이름과 기본 도메인을 사용하여 DNS 레코드를 프로비저닝합니다. api.<cluster_name>.<base_domain>. 을 API 서버 IP 주소로 지정하고 *.apps.<cluster_name>.<base_domain >을 Ingress 서비스 IP 주소로 가리킵니다.
이 기능을 사용하기 전에 userProvisionedDNS 매개변수를 install-config.yaml 파일에 추가하고 매개변수를 활성화해야 합니다. 자세한 내용은 "사용자 관리 DNS 활성화"를 참조하십시오.
사전 요구 사항
- 클러스터가 설치되어 있어야 합니다.
-
gcloudCLI 툴을 설치했습니다.
절차
다음 명령을 실행하여 클러스터의 인프라 ID를 확인합니다.
$ infra_id=$(jq -r .infraID <installation_directory>/metadata.json)다음과 같습니다.
<installation_directory>- 설치 프로그램을 실행한 디렉터리를 지정합니다.
API 서버의 IP 주소를 찾습니다.
프라이빗 클러스터를 설치한 경우 다음 명령을 실행하여 API 서버의 IP 주소를 확인합니다.
$ gcloud compute forwarding-rules describe "${infra_id}-api-internal" --project=<project_name> --region <region_name> --format json | jq -r .IPAddress다음과 같습니다.
<project_name>- Google Cloud 프로젝트의 이름을 지정합니다.
<region_name>- 클러스터를 설치한 리전을 지정합니다.
공용 클러스터를 설치한 경우 다음 명령을 실행하여 API 서버의 IP 주소를 확인합니다.
$ gcloud compute forwarding-rules describe --global "${infra_id}-apiserver" --format json | jq -r .IPAddress
-
클러스터 이름 및 기본 클러스터 도메인을 사용하여
api.<cluster_name>.<base_domain>.호스트 이름으로 자체 DNS 레코드를 프로비저닝하려면 IP 주소를 사용합니다. Ingress 서비스의 IP 주소를 찾습니다.
프라이빗 클러스터를 설치한 경우 다음 명령을 실행하여 Ingress 서비스의 IP 주소를 찾습니다.
$ gcloud compute forwarding-rules list --project=<project_name> --filter="subnetwork:(projects/<project_name>/regions/<region_name>/subnetworks/<compute_subnet_name>)" --format="json" | jq -r '.[].IPAddress'다음과 같습니다.
<project_name>- Google Cloud 프로젝트의 이름을 지정합니다.
<region_name>- 클러스터를 설치한 리전을 지정합니다.
<compute_subnet_name>- 컴퓨팅 노드가 포함된 서브넷의 이름을 지정합니다.
공용 클러스터를 설치한 경우 전달 규칙을 사용하여 IP 주소를 찾습니다.
다음 명령을 실행하여 Ingress 서비스의 전달 규칙을 찾습니다.
$ ingress_forwarding_rule=$(gcloud compute target-pools list --format=json --filter="instances[]~${infra_id}" | jq -r .[].name)전달 규칙 값을 사용하여 다음 명령을 실행하여 Ingress 서비스의 IP 주소를 찾습니다.
$ gcloud compute forwarding-rules describe --region "<region_name>" "${ingress_forwarding_rule}" --format json | jq -r .IPAddress다음과 같습니다.
<region_name>- 클러스터를 설치한 리전을 지정합니다.
-
클러스터 이름 및 기본 클러스터 도메인을 사용하여 IP 주소를 사용하여
*.apps.<cluster_name>.<base_domain>.호스트 이름으로 자체 DNS 레코드를 프로비저닝합니다.
4.17. CLI를 사용하여 클러스터에 로그인 링크 복사링크가 클립보드에 복사되었습니다!
기본 시스템 사용자로 클러스터에 로그인하려면 kubeconfig 파일을 내보냅니다. 이 구성으로 CLI OpenShift Container Platform 설치 중에 생성된 특정 API 서버에 인증하고 연결할 수 있습니다.
kubeconfig 파일은 클러스터에 특정하며 OpenShift Container Platform은 설치 중에 생성합니다.
사전 요구 사항
- OpenShift Container Platform 클러스터를 배포했습니다.
-
OpenShift CLI(
oc)를 설치합니다.
프로세스
다음 명령을 실행하여
kubeadmin자격 증명을 내보냅니다.$ export KUBECONFIG=<installation_directory>/auth/kubeconfig다음과 같습니다.
<installation_directory>- 설치 파일을 저장하는 디렉토리에 대한 경로를 지정합니다.
다음 명령을 실행하여 내보낸 구성을 사용하여
oc명령을 성공적으로 실행할 수 있는지 확인합니다.$ oc whoami출력 예
system:admin
다음 단계
- 클러스터 사용자 정의
- "원격 상태 보고 활성화"
4.18. OpenShift Container Platform의 Telemetry 액세스 링크 복사링크가 클립보드에 복사되었습니다!
클러스터 상태 및 업데이트 진행에 대한 메트릭을 제공하기 위해 Telemetry 서비스도 인터넷 액세스가 필요합니다. 연결된 경우 이 서비스는 기본적으로 자동으로 실행되고 클러스터를 OpenShift Cluster Manager에 등록합니다.
OpenShift Cluster Manager 인벤토리가 올바르거나 OpenShift Cluster Manager를 사용하여 자동으로 또는 OpenShift Cluster Manager를 사용하여 수동으로 유지 관리되는지 확인한 후 subscription watch를 사용하여 계정 또는 다중 클러스터 수준에서 OpenShift Container Platform 서브스크립션을 추적합니다. 구독 모니터링에 대한 자세한 내용은 추가 리소스 섹션에서 "Red Hat 구독 서비스에서 수집하고 사용하는 데이터"를 참조하십시오.