1단계: 클러스터 만들기

현재 Apigee Hybrid 문서의 1.8 버전을 보고 있습니다. This version is end of life. You should upgrade to a newer version. 자세한 내용은 지원되는 버전을 참조하세요.

Version 1.8 (unsupported)

지원되는 버전:

• v1.12(최신 버전)                        
• v1.11                         
• v1.10                                        
• 지원되는 버전 목록

지원되지 않는 버전:

• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

업그레이드: Apigee Hybrid 버전 1.8.8로 업그레이드하는 경우 자세한 내용은 Apigee Hybrid 업그레이드를 참조하세요. 새로 설치하는 경우 아래 설명된 구성을 계속 진행합니다.

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

GKE

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

주의: Apigee는 GKE Sandbox 또는 gVisor의 GKE 설치용 하이브리드를 지원하지 않습니다.

클러스터 만들기

1. 다음의 환경 변수를 만듭니다.

   Linux/macOS

   export CLUSTER_NAME="YOUR_CLUSTER_NAME"
   export CLUSTER_LOCATION="YOUR_CLUSTER_LOCATION"

   Windows

   set CLUSTER_NAME="YOUR_CLUSTER_NAME"
   set CLUSTER_LOCATION=YOUR_CLUSTER_LOCATION

   각 항목의 의미는 다음과 같습니다.

   • CLUSTER_NAME (필수): 새 클러스터의 이름입니다.
   • CLUSTER_LOCATION: 클러스터를 만들 리전입니다.
     참고: Apigee에서는 영역 이름이 아닌 리전 이름 사용이 권장됩니다. 리전은 리소스를 호스팅할 수 있는 특정 지리적 위치입니다. 리전에는 여러 영역이 포함될 수 있습니다. 예를 들어 us-west1 리전은 미국 서부 해안에 있는 us-west1-a, us-west1-b, and us-west1-c의 3개 영역이 포함된 리전을 의미합니다. 사용 가능한 리전은 사용 가능한 리전 및 영역에 나열되어 있습니다. 예를 들어 us-west1이 유효한 리전 이름이고, us-west1-a는 이 리전에 있는 영역입니다. 대부분의 하이브리드 설치에서는 CLUSTER_LOCATION 변수에 리전 이름을 사용합니다.
2. Apigee Hybrid 클러스터의 클러스터 요구사항 수집: 클러스터의 최소 구성은 다음과 같습니다.

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

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

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

6. 클러스터가 생성되면 클러스터에서 워크로드 아이덴티티를 사용 설정합니다. 이 작업은 최대 30분이 걸릴 수 있습니다.

   gcloud container clusters update ${CLUSTER_NAME} \
     --workload-pool=${PROJECT_ID}.svc.id.goog \
     --project ${PROJECT_ID} \
     --region ${CLUSTER_LOCATION}

   자세한 내용은 워크로드 아이덴티티 사용 설정을 참조하세요.

   참고: 리전별 클러스터 대신 영역별 클러스터를 만든 경우 다음 명령어와 같이--region 대신 --zone 인수를 사용합니다.

   gcloud container clusters update ${CLUSTER_NAME} \
     --workload-pool=${PROJECT_ID}.svc.id.goog \
     --zone ${CLUSTER_LOCATION} \
     --project ${PROJECT_ID}

7. 다음 명령어를 사용하여 바로 전에 만든 클러스터의 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

클러스터 만들기

1. 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) 노드 풀

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

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

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

베어메탈용 Anthos

요구사항 및 기본 요건

베어메탈용 Anthos 클러스터는 고유 머신 리소스에서 직접 Kubernetes 클러스터를 실행할 수 있게 해줍니다.

설치 기본 요건 개요를 확인하세요.

클러스터 만들기

1. 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) 노드 풀

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

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

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

AKS

AKS 클러스터 만들기

1. 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) 노드 풀

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

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

EKS

클러스터 만들기

1. 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) 노드 풀

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

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

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

GKE on AWS

클러스터 만들기

1. 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) 노드 풀

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

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

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

OpenShift

클러스터 만들기

1. 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) 노드 풀

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

2. 이 Hybrid 버전 1.8.8에서 지원하는 OpenShift 버전을 확인합니다.
   • Apigee Hybrid: 지원되는 플랫폼
3. OpenShift 클러스터를 빌드하여 런타임 영역에 배포하고 OpenShift 사용자 클러스터에 Apigee를 설치합니다.
   OpenShift 문서(예: Google Cloud에 클러스터를 빠르게 설치)에서 Google Cloud의 OpenShift 클러스터 생성 및 관리에 대한 추가 정보를 확인할 수 있습니다.
   Google Cloud VM에서 OpenShift 클러스터를 설정하는 방법에 대한 자세한 내용은 GCP VM에서 Openshift에 Apigee Hybrid 설정 방법을 참조하세요.

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

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

 

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