1단계: AKS 클러스터 만들기

이 단계에서는 셸 환경을 설정하고 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

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

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

AKS 클러스터 만들기

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

  1. Microsoft® Azure 포털을 엽니다.
  2. Kubernetes 서비스를 클릭합니다.
  3. 다음 최소 구성 설정으로 클러스터를 만듭니다.

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

    탭 속성 값
    기본사항 구독 구독 이름
    리소스 그룹 이전에 만든 리소스 그룹
    리전 이전에 지정한 리전 예: (미국) 미국 동부
    Kubernetes 클러스터 이름 클러스터의 이름입니다. 예: my-hybrid-aks-cluster
    Kubernetes 버전 버전 1.14.x 이상의 버전 선택
    DNS 이름 프리픽스 DNS 이름 프리픽스입니다. 예: my-hybrid-aks-cluster-dns
    노드 수 3
    노드 크기 DS3 표준
    확장 가상 노드 사용 중지됨
    VM 확장 집합 사용 설정됨
    인증 RBAC 사용 설정 예
    서비스 주 구성원 기본
    네트워킹 HTTP 애플리케이션 라우팅 아니요
    부하 분산기 표준
    네트워크 구성 고급
    가상 네트워크 가상 네트워크 이름입니다. 이전에 만든 가상 네트워크를 선택하거나 새로 만들기 링크를 클릭하여 새 네트워크를 만들 수 있습니다. 예를 들면 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
    태그 없음
  4. 검토 및 만들기를 클릭합니다.
  5. 클러스터 생성이 완료되면 다음 단계로 이동합니다.

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

아직 추가되지 않은 경우 다음 명령어를 사용하여 새로 만든 클러스터의 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

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

  1. 모든 컨텍스트를 나열하여 현재 컨텍스트를 확인합니다. 다음 예시에서는 컨텍스트가 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
  2. 필요한 경우 현재 컨텍스트를 방금 만든 클러스터(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단계: apigeectl 설치 3 4