1단계: 클러스터 만들기

시작하기 전에:

이 단계에서는 이전 단계에서 환경 변수를 만들었다고 가정합니다. 다음 명령어로 확인합니다.

echo $PROJECT_ID
echo $CLUSTER_LOCATION
echo $ORG_NAME
echo $ENV_NAME

설명 및 명령어를 클릭하여 변수를 정의합니다.

이 단계에서는 다음 환경 변수를 사용합니다.

PROJECT_ID: Google Cloud 프로젝트의 ID입니다. 하이브리드 빠른 시작 - 2단계: Google Cloud 프로젝트 만들기를 참조하세요.
```
export PROJECT_ID=your_project_ID
```
CLUSTER_LOCATION: 클러스터를 만들 리전입니다.
```
export CLUSTER_LOCATION=cluster-region
```
참고: Apigee에서는 영역 이름이 아닌 리전 이름 사용이 권장됩니다. 리전은 리소스를 호스팅할 수 있는 특정 지리적 위치입니다. 리전에는 여러 영역이 포함될 수 있습니다. 예를 들어 us-west1 리전은 미국 서부 해안에 있는 us-west1-a, us-west1-b, and us-west1-c의 3개 영역이 포함된 리전을 의미합니다. 사용 가능한 리전은 사용 가능한 리전 및 영역에 나열되어 있습니다. 예를 들어 us-west1이 유효한 리전 이름이고, us-west1-a는 이 리전에 있는 영역입니다. 대부분의 하이브리드 설치에서는 CLUSTER_LOCATION 변수에 리전 이름을 사용합니다.
ORG_NAME: 조직 이름입니다. Google Cloud 프로젝트 ID와 일치해야 합니다. 하이브리드 빠른 시작 - 4단계: 조직 만들기를 참조하세요.
```
export ORG_NAME=your_organization_name
```
ENV_NAME: 하이브리드 환경 이름입니다. 하이브리드 빠른 시작 - 6단계: 환경 그룹 만들기를 참조하세요.
```
export ENV_NAME=your_environment_name
```

이 절차에서는 Apigee Hybrid를 실행할 클러스터를 설정하는 방법을 설명합니다. 이 안내는 하이브리드를 실행하는 플랫폼에 따라 다릅니다. 안내를 보려면 플랫폼을 선택하세요.

GKE

이 단계에서는 셸 환경을 설정하고 Google Cloud 프로젝트에서 GKE 클러스터를 만드는 방법을 설명합니다.

클러스터 만들기

Apigee Hybrid 클러스터의 클러스터 요구사항 수집: 클러스터의 최소 구성은 다음과 같습니다.

구성	스테이트풀(Stateful) 노드 풀	스테이트리스(Stateless) 노드 풀
노드 수	3(리전당)	3(리전당)
CPU	4	4
RAM	15	15
기본 라벨 이름	apigee-data	apigee-runtime
스토리지	동적	ApigeeDeployment CRD로 관리

최소 클러스터 구성에 대한 자세한 내용은 최소 클러스터 구성을 참조하세요.

이 Hybrid 버전 1.7.6에서 지원하는 GKE 버전을 확인합니다.
- Apigee Hybrid: 지원되는 플랫폼
다음 안내에 따라 노드가 6개 이상인 리전 클러스터를 만듭니다.
- 리전 클러스터 만들기.
  팁: Google Cloud Console을 사용하여 클러스터를 만드는 경우 클러스터를 만들기 위해 만들기를 클릭하기 전에 노드 풀을 추가하세요.
  
  참고: Apigee에서는 리전 클러스터 만드는 것이 좋습니다. 영역 클러스터를 만들려면 이후 단계에서 안내에 따라 사용자 위치를 묻는 영역을 사용하세요.
  
  팁: 기본 네트워크에서 클러스터를 만들지 않는 경우기존 서브넷에 클러스터 만들기의 안내를 따르세요.

클러스터에 최소 2개의 노드 풀을 만듭니다. 최소 노드 풀 요구사항은 다음과 같습니다.

기본 노드 풀 이름	설명	최소 노드	노드 풀당 최소 CPU	노드당 최소 CPU
`apigee-data`	스테이트풀(Stateful) 노드 풀	3	4	4/풀의 노드 수
`apigee-runtime`	스테이트리스(Stateless) 노드 풀	3	4	4/풀의 노드 수

노드 풀 추가 및 관리의 안내를 따르세요.

노드 풀 구성에 대한 자세한 내용은 전용 노드 풀 구성을 참조하세요.

팁: 노드 풀을 만든 후에 다음 명령어를 사용하여 확인할 수 있습니다.

gcloud container node-pools list \
  --cluster=${CLUSTER_NAME} \
  --region=${CLUSTER_LOCATION}

클러스터를 만든 후 다음 명령어를 사용하여 클러스터에서 워크로드 아이덴티티를 사용 설정합니다.
```
gcloud container clusters update ${CLUSTER_NAME} \
  --workload-pool=$PROJECT_ID.svc.id.goog \
  --region ${CLUSTER_LOCATION}
```
자세한 내용은 클러스터에 워크로드 아이덴티티 사용 설정을 참조하세요.
참고: 리전별 클러스터 대신 영역별 클러스터를 만든 경우 다음 명령어와 같이 --region 대신 --zone 인수를 사용합니다.
```
gcloud container clusters update ${CLUSTER_NAME} \
  --workload-pool=$PROJECT_ID.svc.id.goog \
  --zone ${CLUSTER_LOCATION}
```
다음 명령어를 사용하여 바로 전에 만든 클러스터의 gcloud 사용자 인증 정보를 가져옵니다.
```
gcloud container clusters get-credentials ${CLUSTER_NAME} \
  --region ${CLUSTER_LOCATION} \
  --project ${PROJECT_ID}
```
참고: 리전별 클러스터 대신 영역별 클러스터를 만든 경우 다음 명령어를 사용하여 사용자 인증 정보를 가져옵니다.
```
gcloud container clusters get-credentials ${CLUSTER_NAME} \
  --zone ${CLUSTER_LOCATION} \
  --project ${PROJECT_ID}
```

클러스터를 설치하여 실행 중이면 다음 단계로 이동합니다.

GKE On-Prem

클러스터 만들기

Apigee Hybrid 클러스터의 클러스터 요구사항을 수집합니다.

클러스터의 최소 구성은 다음과 같습니다.

구성	스테이트풀(Stateful) 노드 풀	스테이트리스(Stateless) 노드 풀
노드 수	3(리전당)	3(리전당)
CPU	4	4
RAM	15	15
기본 라벨 이름	apigee-data	apigee-runtime
스토리지	동적	ApigeeDeployment CRD로 관리

최소 클러스터 구성에 대한 자세한 내용은 최소 클러스터 구성을 참조하세요.

노드 풀을 최소 2개 이상 만듭니다.

기본 노드 풀 이름	설명
`apigee-data`	스테이트풀(Stateful) 노드 풀
`apigee-runtime`	스테이트리스(Stateless) 노드 풀

노드 풀 구성에 대한 자세한 내용은 전용 노드 풀 구성을 참조하세요.

이 Hybrid 버전 1.7.6에서 지원하는 GKE 버전을 확인합니다.
- Apigee Hybrid: 지원되는 플랫폼
다음 안내에 따라 사용자 클러스터를 만듭니다.
- GKE On-Prem 문서의 사용자 클러스터를 만듭니다(빠른 시작).

클러스터를 설치하여 실행 중이면 다음 단계로 이동합니다.

베어메탈용 Anthos

요구사항 및 기본 요건

Anthos clusters on bare metal은 고유 머신 리소스에서 직접 Kubernetes 클러스터를 실행할 수 있게 해줍니다.

다음 요구사항 및 기본 요건을 검토하세요.

하드웨어 요구사항: Anthos clusters on bare metal 하드웨어 구성
설치 기본 요건 개요

클러스터 만들기

Apigee Hybrid 클러스터의 클러스터 요구사항을 수집합니다.

클러스터의 최소 구성은 다음과 같습니다.

구성	스테이트풀(Stateful) 노드 풀	스테이트리스(Stateless) 노드 풀
노드 수	3(리전당)	3(리전당)
CPU	4	4
RAM	15	15
기본 라벨 이름	apigee-data	apigee-runtime
스토리지	동적	ApigeeDeployment CRD로 관리

최소 클러스터 구성에 대한 자세한 내용은 최소 클러스터 구성을 참조하세요.

노드 풀을 최소 2개 이상 만듭니다.

기본 노드 풀 이름	설명
`apigee-data`	스테이트풀(Stateful) 노드 풀
`apigee-runtime`	스테이트리스(Stateless) 노드 풀

노드 풀 구성에 대한 자세한 내용은 전용 노드 풀 구성을 참조하세요.

이 Hybrid 버전 1.7.6에서 지원하는 GKE 버전을 확인합니다.
- Apigee Hybrid: 지원되는 플랫폼
베어메탈용 Anthos 클러스터 문서에서 다음 안내에 따라 사용자 클러스터를 만듭니다.
- 클러스터 만들기: 개요
- Anthos clusters on bare metal 문서의 Anthos clusters on bare metal 빠른 시작

클러스터를 설치하여 실행 중이면 다음 단계로 이동합니다.

AKS

AKS 클러스터 만들기

Apigee Hybrid 클러스터의 클러스터 요구사항을 수집합니다.

클러스터의 최소 구성은 다음과 같습니다.

구성	스테이트풀(Stateful) 노드 풀	스테이트리스(Stateless) 노드 풀
노드 수	3(리전당)	3(리전당)
CPU	4	4
RAM	15	15
기본 라벨 이름	apigee-data	apigee-runtime
스토리지	동적	ApigeeDeployment CRD로 관리

최소 클러스터 구성에 대한 자세한 내용은 최소 클러스터 구성을 참조하세요.

노드 풀을 최소 2개 이상 만듭니다.

기본 노드 풀 이름	설명
`apigee-data`	스테이트풀(Stateful) 노드 풀
`apigee-runtime`	스테이트리스(Stateless) 노드 풀

노드 풀 구성에 대한 자세한 내용은 전용 노드 풀 구성을 참조하세요.

이 Hybrid 버전 1.7.6에서 지원하는 AKS 버전을 확인합니다.
- Apigee Hybrid: 지원되는 플랫폼
다음 여러 안내 중 하나를 사용하여 클러스터를 만듭니다.
- Azure CLI 사용: 빠른 시작: Azure CLI를 사용하여 Azure Kubernetes 서비스 클러스터 배포
- Azure 포털 사용: 빠른 시작: Azure 포털을 사용하여 Azure Kubernetes 서비스(AKS) 클러스터 배포

EKS

클러스터 만들기

Apigee Hybrid 클러스터의 클러스터 요구사항을 수집합니다.

클러스터의 최소 구성은 다음과 같습니다.

구성	스테이트풀(Stateful) 노드 풀	스테이트리스(Stateless) 노드 풀
노드 수	3(리전당)	3(리전당)
CPU	4	4
RAM	15	15
기본 라벨 이름	apigee-data	apigee-runtime
스토리지	동적	ApigeeDeployment CRD로 관리

최소 클러스터 구성에 대한 자세한 내용은 최소 클러스터 구성을 참조하세요.

노드 풀을 최소 2개 이상 만듭니다.

기본 노드 풀 이름	설명
`apigee-data`	스테이트풀(Stateful) 노드 풀
`apigee-runtime`	스테이트리스(Stateless) 노드 풀

노드 풀 구성에 대한 자세한 내용은 전용 노드 풀 구성을 참조하세요.

이 Hybrid 버전 1.7.6에서 지원하는 EKS 버전을 확인합니다.
- Apigee Hybrid: 지원되는 플랫폼
다음 안내에 따라 사용자 클러스터를 만듭니다.
- EKS 개요 문서
- Amazon EKS 클러스터 만들기

클러스터를 설치하여 실행 중이면 다음 단계로 이동합니다.

GKE on AWS

클러스터 만들기

Apigee Hybrid 클러스터의 클러스터 요구사항을 수집합니다.

클러스터의 최소 구성은 다음과 같습니다.

구성	스테이트풀(Stateful) 노드 풀	스테이트리스(Stateless) 노드 풀
노드 수	3(리전당)	3(리전당)
CPU	4	4
RAM	15	15
기본 라벨 이름	apigee-data	apigee-runtime
스토리지	동적	ApigeeDeployment CRD로 관리

최소 클러스터 구성에 대한 자세한 내용은 최소 클러스터 구성을 참조하세요.

노드 풀을 최소 2개 이상 만듭니다.

기본 노드 풀 이름	설명
`apigee-data`	스테이트풀(Stateful) 노드 풀
`apigee-runtime`	스테이트리스(Stateless) 노드 풀

노드 풀 구성에 대한 자세한 내용은 전용 노드 풀 구성을 참조하세요.

이 Hybrid 버전 1.7.6에서 지원하는 GKE 버전을 확인합니다.
- Apigee Hybrid: 지원되는 플랫폼
다음 안내에 따라 사용자 클러스터를 만듭니다.
- GKE on AWS 개요 문서
- Anthos clusters on AWS 설치 개요

클러스터를 설치하여 실행 중이면 다음 단계로 이동합니다.

OpenShift

클러스터 만들기

Apigee Hybrid 클러스터의 클러스터 요구사항을 수집합니다.

클러스터의 최소 구성은 다음과 같습니다.

구성	스테이트풀(Stateful) 노드 풀	스테이트리스(Stateless) 노드 풀
노드 수	3(리전당)	3(리전당)
CPU	4	4
RAM	15	15
기본 라벨 이름	apigee-data	apigee-runtime
스토리지	동적	ApigeeDeployment CRD로 관리

최소 클러스터 구성에 대한 자세한 내용은 최소 클러스터 구성을 참조하세요.

노드 풀을 최소 2개 이상 만듭니다.

기본 노드 풀 이름	설명
`apigee-data`	스테이트풀(Stateful) 노드 풀
`apigee-runtime`	스테이트리스(Stateless) 노드 풀

노드 풀 구성에 대한 자세한 내용은 전용 노드 풀 구성을 참조하세요.

이 Hybrid 버전 1.7.6에서 지원하는 OpenShift 버전을 확인합니다.
- Apigee Hybrid: 지원되는 플랫폼
OpenShift 클러스터를 빌드하여 런타임 영역에 배포하고 OpenShift 사용자 클러스터에 Apigee를 설치합니다.
OpenShift 문서(예: GCP에 클러스터를 빠르게 설치)에서 GCP의 OpenShift 클러스터 생성 및 관리에 대한 추가 정보를 확인할 수 있습니다.

GCP VM에서 OpenShift 클러스터를 설정하는 방법에 대한 자세한 내용은 GCP VM에서 Openshift에 Apigee Hybrid 설정 방법을 참조하세요.

OpenShift 설치의 일부로 oc CLI 도구를 설치하고 구성합니다. OpenShift 문서의 OpenShift CLI 시작하기를 참조하세요.

클러스터를 설치한 후 다음 단계로 이동합니다.

다음 단계

1 (다음) 2단계: cert-manager 설치 3 4 5 6 7 8 9