Azure Red Hat OpenShift 4 클러스터 만들기

아티클
12/06/2024

Azure Red Hat OpenShift는 클러스터를 신속하게 배포하고 관리할 수 있는 관리형 OpenShift 서비스입니다. 이 문서에서는 Azure CLI 또는 Azure Portal을 사용하여 Azure Red Hat OpenShift 클러스터를 배포하는 방법을 보여 줍니다.

Azure CLI
Azure Portal

시작하기 전에

Azure CLI 버전 2.67.0 이상을 사용하고 있는지 확인합니다. 설치한 Azure CLI 버전을 찾는 데 사용합니다 az --version . 설치 또는 업그레이드해야 하는 경우 Azure CLI 설치를 참조하세요.

Azure Red Hat OpenShift에는 OpenShift 클러스터를 만들고 실행하는 데 최소 40개의 코어가 필요합니다. 새 Azure 구독에 대한 기본 Azure 리소스 할당량이 이 요구 사항을 충족하지 않습니다. 리소스 제한 늘리기를 요청하려면 표준 할당량: VM 시리즈별 제한 늘리기를 참조하세요.

예를 들어, 지원되는 최소 가상 머신 패밀리 SKU인 "표준 DSv3”의 현재 구독 할당량을 확인하려면 다음을 수행합니다.
```
LOCATION=eastus
az vm list-usage -l $LOCATION \
--query "[?contains(name.value, 'standardDSv3Family')]" \
-o table
```

권한 확인

이 문서에서는 클러스터에 대한 가상 네트워크를 포함하는 리소스 그룹을 만듭니다. 이렇게 하려면 가상 네트워크에서 직접 또는 이를 포함하는 리소스 그룹이나 구독에서 기여자 및 사용자 액세스 관리자 권한 또는 소유자 권한이 필요합니다.

또한 도구가 클러스터에 대해 사용자를 대신하여 애플리케이션 및 서비스 주체를 만들려면 충분한 Microsoft Entra 권한(테넌트의 멤버 사용자 또는 애플리케이션 관리자 역할이 할당된 게스트)이 필요합니다. 자세한 내용은 구성원 및 게스트 및 Microsoft Entra ID 사용자에게 관리자 및 비관리자 역할 할당을 참조하세요.

리소스 공급자 등록

여러 Azure 구독이 있는 경우 관련 구독 ID를 지정합니다.
```
az account set --subscription <SUBSCRIPTION ID>
```
Microsoft.RedHatOpenShift 리소스 공급자를 등록합니다.
```
az provider register -n Microsoft.RedHatOpenShift --wait
```
Microsoft.Compute 리소스 공급자를 등록합니다.
```
az provider register -n Microsoft.Compute --wait
```
Microsoft.Storage 리소스 공급자를 등록합니다.
```
az provider register -n Microsoft.Storage --wait
```
Microsoft.Authorization 리소스 공급자를 등록합니다.
```
az provider register -n Microsoft.Authorization --wait
```

Red Hat 풀 비밀 가져오기(선택 사항)

참고 항목

ARO 풀 비밀은 ARO용 RH OpenShift 라이선스 비용을 변경하지 않습니다.

Red Hat 풀 비밀을 사용하면 클러스터가 OperatorHub의 운영자 등 다른 콘텐츠와 함께 Red Hat 컨테이너 레지스트리에 액세스할 수 있습니다. 이 단계는 선택 사항이지만 권장됩니다. 나중에 풀 비밀을 추가하려는 경우 이 지침을 따릅니다. cloud.openshift.com 필드는 풀 비밀에 해당 필드가 포함되어 있어도 비밀에서 제거됩니다. 이 필드는 데이터를 RedHat으로 보내는 추가 모니터링 기능을 사용하도록 설정하므로 기본적으로 사용하지 않도록 설정됩니다. 이 기능을 사용하도록 설정하려면 https://docs.openshift.com/container-platform/4.11/support/remote_health_monitoring/enabling-remote-health-reporting.html을 참조하세요.

Red Hat OpenShift 클러스터 관리자 포털로 이동하여 로그인합니다.

회사 이메일로 Red Hat 계정에 로그인하거나 새 Red Hat 계정을 만들고 사용 약관에 동의해야 합니다.
풀 비밀 다운로드를 선택하고 ARO 클러스터에서 사용할 풀 비밀을 다운로드합니다.

저장된 pull-secret.txt 파일을 안전한 위치에 보관합니다. Red Hat 또는 인증된 파트너에 대한 샘플 또는 연산자를 포함하는 클러스터를 만들어야 하는 경우 각 클러스터 만들기에 파일이 사용됩니다.

az aro create 명령을 실행하는 경우 --pull-secret @pull-secret.txt 매개 변수를 사용하여 풀 비밀을 참조할 수 있습니다. pull-secret.txt 파일을 저장한 디렉터리에서 az aro create를 실행합니다. 그렇지 않으면 @pull-secret.txt를 @/path/to/my/pull-secret.txt로 바꿉니다.

풀 비밀을 복사하거나 다른 스크립트에서 참조하는 경우에는 풀 비밀을 유효한 JSON 문자열로 포맷해야 합니다.

클러스터에 대한 사용자 지정 도메인 준비(선택 사항)

az aro create 명령을 실행할 때 --domain foo.example.com 매개 변수를 사용하여 클러스터의 사용자 지정 도메인을 지정할 수 있습니다.

참고 항목

Azure CLI를 통해 클러스터를 만들 때 도메인 이름을 추가하는 것은 선택 사항이지만 포털을 통해 클러스터를 추가할 때 도메인 이름(또는 OpenShift 콘솔 및 API 서버에 대해 자동 만들어진 DNS 이름의 일부로 사용되는 접두사)이 필요합니다. 자세한 내용은 빠른 시작: Azure Portal을 사용하여 Azure Red Hat OpenShift 클러스터 배포를 참조하세요.

클러스터에 사용자 지정 도메인을 제공하는 경우 다음 사항에 유의합니다.

클러스터를 만든 후 지정된 --domain에 대해 DNS 서버에 2개의 DNS A 레코드를 만들어야 합니다.
- api - api 서버 IP 주소를 가리킵니다.
- *.apps - 수신 IP 주소를 가리킵니다.
- 클러스터 생성 후 az aro show -n -g --query '{api:apiserverProfile.ip, ingress:ingressProfiles[0].ip}' 명령을 실행하여 이러한 값을 검색합니다.
OpenShift 콘솔은 기본 제공 도메인 https://console-openshift-console.apps.<random>.<location>.aroapp.io 대신 https://console-openshift-console.apps.example.com과 같은 URL에서 사용할 수 있습니다.
기본적으로 OpenShift는 사용자 지정 도메인 *.apps.example.com에서 만든 모든 경로에 자체 서명된 인증서를 사용합니다. 클러스터에 연결한 후 사용자 지정 DNS를 사용하도록 선택하면 OpenShift 설명서에 따라 수신 컨트롤러의 사용자 지정 CA 및 API 서버의 사용자 지정 CA를 구성해야 합니다.

두 개의 빈 서브넷이 있는 가상 네트워크 만들기

다음으로 두 개의 빈 서브넷이 포함된 가상 네트워크를 만듭니다. 요구 사항을 충족하는 기존 가상 네트워크가 있는 경우 이 단계를 건너뛸 수 있습니다.

네트워킹 및 요구 사항에 대한 자세한 내용은 Azure Red Hat Openshift에 대한 네트워킹을 참조하세요.

az 명령을 실행하는 셸 환경에서 다음 변수를 설정합니다.

LOCATION=eastus                 # the location of your cluster
RESOURCEGROUP=aro-rg            # the name of the resource group where you want to create your cluster
CLUSTER=cluster                 # the name of your cluster

리소스 그룹을 만듭니다.

Azure 리소스 그룹은 Azure 리소스가 배포되고 관리되는 논리 그룹입니다. 리소스 그룹을 만들 때 위치를 지정하라는 메시지가 나타납니다. 이 위치는 리소스 그룹 메타데이터가 저장되는 위치이며 리소스를 만드는 동안 다른 지역을 지정하지 않으면 리소스가 Azure에서 실행되는 위치이기도 합니다. az group create 명령을 사용하여 리소스 그룹을 만듭니다.

참고 항목

Azure 리소스 그룹을 만들 수 있는 일부 지역에서는 Azure Red Hat OpenShift를 사용할 수 없습니다. Azure Red Hat OpenShift가 지원되는 위치에 대한 정보는 사용 가능한 지역을 참조하세요.
```
az group create \
  --name $RESOURCEGROUP \
  --location $LOCATION
```
다음 예제 출력에서는 성공적으로 만들어진 리소스 그룹이 나와 있습니다.
```
{
  "id": "/subscriptions/<guid>/resourceGroups/aro-rg",
  "location": "eastus",
  "name": "aro-rg",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "type": "Microsoft.Resources/resourceGroups"
}
```

가상 네트워크를 만듭니다.

OpenShift 4를 실행하는 Azure Red Hat OpenShift 클러스터에는 마스터 및 작업자 노드에 사용할 두 개의 빈 서브넷이 있는 가상 네트워크가 필요합니다. 이를 위해 새 가상 네트워크를 만들거나 기존 가상 네트워크를 사용할 수 있습니다.

이전에 만든 동일한 리소스 그룹에 새 가상 네트워크를 만듭니다.

az network vnet create \
   --resource-group $RESOURCEGROUP \
   --name aro-vnet \
   --address-prefixes 10.0.0.0/22

다음 예제 출력을 보면 가상 네트워크가 성공적으로 만들어졌습니다.

{
  "newVNet": {
    "addressSpace": {
      "addressPrefixes": [
        "10.0.0.0/22"
      ]
    },
    "dhcpOptions": {
      "dnsServers": []
    },
    "id": "/subscriptions/<guid>/resourceGroups/aro-rg/providers/Microsoft.Network/virtualNetworks/aro-vnet",
    "location": "eastus",
    "name": "aro-vnet",
    "provisioningState": "Succeeded",
    "resourceGroup": "aro-rg",
    "type": "Microsoft.Network/virtualNetworks"
  }
}

마스터 노드에 사용할 빈 서브넷을 추가합니다.

az network vnet subnet create \
  --resource-group $RESOURCEGROUP \
  --vnet-name aro-vnet \
  --name master-subnet \
  --address-prefixes 10.0.0.0/23

작업자 노드에 사용할 빈 서브넷을 추가합니다.

az network vnet subnet create \
  --resource-group $RESOURCEGROUP \
  --vnet-name aro-vnet \
  --name worker-subnet \
  --address-prefixes 10.0.2.0/23

클러스터 만들기

다음 명령을 실행하여 클러스터를 만듭니다. 다음 옵션 중 하나를 사용하도록 선택하는 경우 이에 따라 명령을 수정합니다.

선택적으로 클러스터가 다른 콘텐츠와 함께 Red Hat 컨테이너 레지스트리에 액세스할 수 있도록 하는 Red Hat 가져오기 비밀을 전달할 수 있습니다. 명령에 --pull-secret @pull-secret.txt 인수를 추가합니다.
필요에 따라 사용자 지정 도메인을 사용할 수 있습니다. foo.example.com을 사용자 지정 도메인으로 대체하는 --domain foo.example.com 인수를 명령에 추가합니다.

참고 항목

만들기 시점에 정의할 수 있는 최대 작업자 노드 수는 50개입니다. 클러스터가 만들어진 후 최대 250개의 노드를 스케일 아웃할 수 있습니다.

az aro create \
  --resource-group $RESOURCEGROUP \
  --name $CLUSTER \
  --vnet aro-vnet \
  --master-subnet master-subnet \
  --worker-subnet worker-subnet

az aro create 명령을 실행한 후 클러스터를 만드는 데 일반적으로 약 45분이 소요됩니다.

대규모 ARO 클러스터

100개 이상의 작업자 노드가 있는 Azure Red Hat OpenShift 클러스터를 배포하려는 경우 대규모 Azure Red Hat OpenShift 클러스터 배포를 참조하세요.

다른 ARO 버전 선택

클러스터를 만들 때 특정 버전의 ARO를 사용하도록 선택할 수 있습니다. 먼저 CLI를 사용하여 사용 가능한 ARO 버전을 쿼리합니다.

az aro get-versions --location <region>

버전을 선택했으면 az aro create 명령에서 --version 매개 변수를 사용하여 지정합니다.

az aro create \
  --resource-group $RESOURCEGROUP \
  --name $CLUSTER \
  --vnet aro-vnet \
  --master-subnet master-subnet \
  --worker-subnet worker-subnet \
  --version <x.y.z>

시작하기 전에

Azure Portal에 로그인합니다.

Microsoft.RedHatOpenShift 리소스 공급자를 등록합니다. Azure Portal을 사용하여 리소스 공급자를 등록하는 방법에 대한 지침은 리소스 공급자 등록을 참조하세요.

Azure Red Hat OpenShift 클러스터 만들기

Azure Portal 메뉴 또는 홈페이지의 왼쪽 위 페이지에 있는 세 개의 가로 막대 아래에서 모든 서비스를 선택합니다.
Azure Red Hat OpenShift 클러스터를 검색하고 선택합니다.
만들기를 실행합니다.
기본 사항 탭에서 다음 옵션을 구성합니다.
- 프로젝트 세부 정보:
  - Azure 구독을 선택합니다.
  - Azure 리소스 그룹(예: myResourceGroup)을 선택하거나 만듭니다.
- 인스턴스 세부 정보:
  - Azure Red Hat OpenShift 클러스터의 지역을 선택합니다.
  - myAROCluster와 같은 OpenShift 클러스터 이름을 입력합니다.
  - 도메인 이름을 입력합니다.
  - 마스터 VM 크기 및 작업자 VM 크기를 선택합니다.
  - 작업자 노드 수(예: 생성할 작업자 노드 수)를 선택합니다.
참고 항목

도메인 이름 필드는 임의 문자열로 미리 채워집니다. OpenShift 콘솔 및 API 서버에 대해 자동으로 생성된 DNS 이름의 일부로 사용할 도메인 이름(예: example.com) 또는 문자열/접두사(예: abc)를 지정할 수 있습니다. 리소스 그룹 이름이 지정되지 않을 경우 이 접두사는 클러스터 VM을 호스트하기 위해 만들어진 리소스 그룹 이름의 일부로도 사용됩니다.
인증 탭에서 다음 섹션을 완료합니다.

서비스 주체 정보에서 새로 만들기 또는 기존을 선택합니다. 기존 서비스 주체를 사용하도록 선택한 경우 다음 정보를 입력합니다.
- 서비스 주체 클라이언트 ID는 사용자의 appId입니다.
- 서비스 주체 클라이언트 암호는 서비스 주체의 암호 해독된 비밀 값입니다.
참고 항목

서비스 주체를 만들어야 하는 경우 Azure Red Hat OpenShift 클러스터에서 서비스 주체 만들기 및 사용을 참조하세요.

풀 비밀 아래에서 Red Hat 풀 비밀(예: 클러스터의 풀 비밀 암호화 값)을 입력합니다. 끌어오기 비밀이 없는 경우 이 필드를 비워 둡니다.
네트워킹 탭에서 필수 옵션을 구성합니다.

참고 항목

OpenShift 4를 실행하는 Azure Red Hat OpenShift 클러스터에는 컨트롤 플레인 및 작업자 노드에 사용할 두 개의 빈 서브넷이 있는 가상 네트워크가 필요합니다.

태그 탭에서 태그를 추가하여 리소스를 구성합니다.

검토 + 만들기를 선택한 후 유효성 검사가 완료되면 만들기를 선택합니다.

Azure Portal의 검토 + 만들기 탭 스크린샷.

Azure Red Hat OpenShift 클러스터를 만드는 데 약 35~45분이 걸립니다. 배포가 완료되면 다음 중 하나를 수행하여 리소스로 이동합니다.
- 리소스로 이동을 클릭하거나
- Azure Red Hat OpenShift 클러스터 리소스 그룹으로 이동하고 Azure Red Hat OpenShift 리소스를 선택합니다.
  - 아래 클러스터 대시보드의 예: myResourceGroup을 검색하고 myAROCluster 리소스를 선택합니다.

다음 단계

Azure Red Hat OpenShift 클러스터에 연결하는 방법을 알아봅니다.

다음을 통해 공유

Azure Red Hat OpenShift 4 클러스터 만들기

시작하기 전에

권한 확인

리소스 공급자 등록

Red Hat 풀 비밀 가져오기(선택 사항)

클러스터에 대한 사용자 지정 도메인 준비(선택 사항)

두 개의 빈 서브넷이 있는 가상 네트워크 만들기

클러스터 만들기

대규모 ARO 클러스터

다른 ARO 버전 선택

시작하기 전에

Azure Red Hat OpenShift 클러스터 만들기

다음 단계

피드백

추가 리소스