1단계: 클러스터 만들기

이 단계에서는 셸 환경을 설정하고 Apigee Hybrid 테스트에 적합한 Microsoft® Azure Kubernetes Service(AKS) 클러스터를 만드는 방법을 설명합니다.

터미널 셸 설정

로컬 셸에 Azure CLI(az) 및 kubectl 도구가 설치되어 있는지 확인합니다. Azure CLI 도구는 Azure의 기본 명령줄 인터페이스를 제공하며 kubectl은 Kubernetes 클러스터를 대상으로 명령어를 실행할 수 있는 기본 명령줄 인터페이스를 제공합니다.

리소스 그룹 만들기

다음 명령어로 Azure 콘솔 또는 Azure CLI를 사용하여 리소스 그룹을 만듭니다.

az group create --name my-hybrid-rg --location eastus

가상 네트워크 만들기

충돌하지 않는 CIDR 범위로 가상 네트워크를 만듭니다.

예:

구문

az network vnet create \
 --name vnet-name \
 --resource-group my-hybrid-rg \
 --address-prefixes vnet-address-range \
 --subnet-name vnet-subnet-name \
 --subnet-prefix subnet-address-range

예

az network vnet create \
 --name my-hybrid-rg-vnet \
 --resource-group my-hybrid-rg \
 --address-prefixes 120.38.1.0/14 \
 --subnet-name my-hybrid-rg-vnet-subnet \
 --subnet-prefix 120.38.1.0/16

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

my-hybrid-rg는 가상 네트워크 이름입니다.
vnet-address-range는 CIDR 표기법으로 이 가상 네트워크에 예약된 주소 블록 목록입니다.
vnet-subnet-name은 가상 네트워크 내의 서브넷 이름입니다.
subnet-address-range는 CIDR 표기법으로 이 서브넷에 예약된 주소 블록의 목록입니다.

AKS 클러스터 만들기

이 단계에서는 AKS 클러스터를 만듭니다.

Microsoft® Azure 포털을 엽니다.
Kubernetes 서비스를 클릭합니다.

다음 최소 구성 설정으로 클러스터를 만듭니다.

권장 최소 스토리지: AKS 디스크 사양을 검토하고 IOP 및 비용 요구사항에 따라 스토리지 볼륨 크기를 선택합니다.

프로덕션용 Cassandra 구성 및 StorageClass 구성에서 Apigee Hybrid의 클러스터 구성 가이드라인을 확인할 수 있습니다.

탭	속성	값
기본사항	구독	구독 이름
	리소스 그룹	이전에 만든 리소스 그룹
	지역	이전에 지정한 리전 예: (미국) 미국 동부
	Kubernetes 클러스터 이름	클러스터의 이름입니다. 예: `my-hybrid-aks-cluster`
	Kubernetes 버전	1.16.x 이상의 버전 선택
	DNS 이름 프리픽스	DNS 이름 프리픽스입니다. 예: `my-hybrid-aks-cluster-dns`
	노드 수	3
	노드 크기	DS3 표준 참고: 가상 CPU가 4개 미만인 경우 CPU가 충분하지 않아 Cassandra 포드 만들기를 실패할 수 있습니다. 스토리지는 Kubernetes 스테이트풀(Stateful) 동적 프로비저닝 도구를 사용하여 프로비저닝됩니다.
확장	가상 노드	사용 중지됨
	VM 확장 집합	사용 설정됨
인증	RBAC 사용 설정	예
	서비스 주 구성원	기본값
네트워킹	HTTP 애플리케이션 라우팅	아니요
	부하 분산기	스탠더드
	네트워크 구성	Azure CNI 참고: 네트워킹 설정 계획에 대한 자세한 내용은클러스터의 IP 주소 지정 계획 참조하세요.
	가상 네트워크	가상 네트워크 이름입니다. 이전에 만든 가상 네트워크를 선택하거나 새로 만들기 링크를 클릭하여 새 네트워크를 만들 수 있습니다. 예를 들면 `my-hybrid-rg-vnet`입니다.
	클러스터 서브넷	예: `default (10.240.0.0/16)`
	Kubernetes 서비스 주소 범위	서비스 주소 범위입니다. 겹치지 않는 주소 범위를 사용해야 합니다. 예: `10.0.0.0/16`
	Kubernetes DNS 서비스 IP 주소	예: `10.0.0.10`
	Docker 브리지 주소	예: `172.17.0.1/16`
모니터링	컨테이너 모니터링 사용 설정	예
	로그 애널리틱스 작업공간	예: `DefaultWorkspace-66f9d75c-2cd9-47dd-ad0f-c43d888e9cef-EUS`
태그		없음

검토 및 만들기를 클릭합니다.
클러스터 생성이 완료되면 다음 단계로 이동합니다.

클러스터 사용자 인증 정보 설정

아직 추가되지 않은 경우 다음 명령어를 사용하여 새로 만든 클러스터의 Kubernetes 클러스터 사용자 인증 정보를 추가합니다.

az aks get-credentials --resource-group my-hybrid-rg --name my-hybrid-aks-cluster

현재 컨텍스트 설정

컨텍스트는 액세스 매개변수 그룹입니다. 각 컨텍스트에는 Kubernetes 클러스터, 사용자, 네임스페이스가 포함되어 있습니다. 현재 컨텍스트는 현재 kubectl의 기본값인 클러스터입니다. 모든 kubectl 명령어가 이 클러스터를 대상으로 실행됩니다.

다음 명령어를 사용하여 현재 컨텍스트가 방금 만든 클러스터로 설정되었는지 확인합니다.

kubectl config current-context
 my-hybrid-aks-cluster-context

컨텍스트가 예상대로 클러스터에 설정되지 않은 경우 다음 단계에 따라 변경합니다.

모든 컨텍스트를 나열하여 현재 컨텍스트를 확인합니다. 다음 예시에서는 컨텍스트가 my-hybrid-aks-ext01로 설정됩니다.

kubectl config get-contexts
CURRENT   NAME                            CLUSTER                                 AUTHINFO
          my-hybrid-aks-cluster    my-hybrid-aks-cluster          clusterUser_my-hybrid-rg2_myhybrid-aks-cluster
*         my-hybrid-aks-ext01      my-hybrid-aks-ext01            clusterUser_my-hybrid-rg_my-hybrid-aks-ext01

필요한 경우 현재 컨텍스트를 방금 만든 클러스터(Apigee Hybrid를 설치하려는 클러스터)로 설정합니다. 이전의 get-contexts 출력을 가정했을 때 만든 클러스터 이름이 my-hybrid-aks-cluster이면 다음과 같이 my-hybrid-aks-cluster 컨텍스트로 전환합니다.
```
kubectl config use-context my-hybrid-aks-cluster
```
여기서 my-hybrid-aks-cluster는 전환할 클러스터 컨텍스트의 이름입니다.

요약

이제 AKS에서 Kubernetes 클러스터를 실행했습니다. 셸 환경이 설정되었으며 이제 로컬 머신에 Apigee Hybrid 런타임 소프트웨어를 설치할 준비가 되었습니다.

1 (다음) 2단계: cert-manager 및 ASM 설치 3 4 5