4단계: apigeectl 설치

이 단계에서는 apigeectl을 다운로드 및 설치하고, 설치 디렉터리를 설정하고, Google Cloud 서비스 계정을 만들고, Apigee hybrid가 작동하는 데 필요한 TLS 사용자 인증 정보를 만드는 방법을 설명합니다.

`apigeectl` 다운로드 및 설치

apigeectl은 Kubernetes 클러스터에서 Apigee Hybrid 설치 및 관리를 위한 명령줄 인터페이스(CLI)입니다.

apigeectl을 가져오려면 다음 절차를 따르세요.

다음 명령어를 사용하여 최신 버전 번호를 변수에 저장합니다.

export VERSION=$(curl -s \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1)

참고: 일부 MacOS 터미널 셸은 이 명령어에서 오류를 반환할 수 있습니다. 오류가 표시되면 ?ignoreCache=1 없이 다음과 같이 실행합니다.

export VERSION=$(curl -s \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt)

다음 명령어를 사용하여 변수가 버전 번호로 채워졌는지 확인합니다. 다른 버전을 사용하려면 대신 환경 변수에 저장하면 됩니다.
```
echo $VERSION
```
```
  1.4.0
```

다음 명령어를 사용하여 운영체제용 출시버전 패키지를 다운로드합니다.

Mac 64비트:

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_64.tar.gz

Linux 64비트:

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_64.tar.gz

Mac 32비트:

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_32.tar.gz

Linux 32비트:

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_32.tar.gz

Apigee hybrid 설치의 기본 디렉터리 역할을 하는 디렉터리를 시스템에 만듭니다.
다음 명령어를 사용하여 다운로드한 gzip 파일 콘텐츠를 방금 만든 기본 디렉터리에 추출합니다.
```
tar xvzf filename.tar.gz -C path-to-base-directory
```
cd 명령어를 사용하여 디렉터리를 기본 디렉터리로 변경합니다.
tar 콘텐츠는 기본적으로 이름에 해당 버전과 플랫폼이 포함된 디렉터리로 확장됩니다. 예를 들면 ./apigeectl_1.4.0-d591b23_linux_64입니다. 다음 명령어를 사용하여 디렉터리 이름을 apigeectl로 변경합니다.
```
mv apigeectl_1.4.0-d591b23_linux_64 apigeectl
```
다음 명령어를 사용하여 디렉터리로 변경합니다.
```
cd ./apigeectl
```
이 디렉터리는 apigeectl 홈 디렉터리입니다. 여기에 apigeectl 실행 가능한 명령어가 있습니다.
다음 명령어를 사용하여 이 홈 디렉터리 경로를 저장할 환경 변수를 만듭니다.
```
export APIGEECTL_HOME=$PWD
```
다음 명령어를 사용하여 변수에 올바른 경로가 포함되었는지 확인합니다.
```
echo $APIGEECTL_HOME
```

프로젝트 디렉터리 구조 설정

다음 디렉터리 구조는 권장되는 방식입니다. 이 방식은 Apigee Hybrid 출시 소프트웨어를 개발자가 만들어야 하는 구성 파일과 분리합니다. 만들려는 $APIGEECTL_HOME 변수 및 심볼릭 링크를 사용하면 원하는 경우 새 소프트웨어 버전으로 쉽게 전환할 수 있습니다. Apigee Hybrid 업그레이드도 참조하세요.

다음 명령어를 사용하여 기본 디렉터리(apigeectl 디렉터리가 있는 디렉터리)에 있는지 확인합니다.
```
cd $APIGEECTL_HOME/..
```
다음 명령어를 사용하여 hybrid-files라는 새 폴더를 만듭니다. 디렉터리에 원하는 이름을 지정할 수 있지만 문서에서는 hybrid-files 이름을 일관되게 사용합니다. 나중에 이 폴더에 구성 파일, 서비스 계정 키, TLS 인증서를 저장합니다. 이 폴더를 사용하면 구성 파일을 apigeectl 소프트웨어 설치와 별도로 유지할 수 있습니다.
```
mkdir hybrid-files
```
현재 디렉터리 구조는 이제 다음과 같이 표시됩니다.
```
pwd && ls
/hybrid-base-directory
  apigeectl
  hybrid-files
```
다음 명령어를 사용하여 디렉터리를 hybrid-files 폴더로 변경합니다.
```
cd hybrid-files
```
hybrid-files 디렉터리 내에서 다음 하위 디렉터리를 만들어 나중에 만들 파일을 구성합니다.
```
mkdir overrides
mkdir service-accounts
mkdir certs
```
hybrid-files 디렉터리 내에서 $APIGEECTL_HOME에 대해 다음 심볼릭 링크를 만듭니다. 이러한 링크를 사용하면 다음 예시와 같이 hybrid-files 디렉터리 내부에서 apigeectl 명령어를 실행할 수 있습니다.
참고: 이 프로세스를 처음 사용하는 경우가 아니라면 다음 심볼릭 링크가 존재할 수 있습니다. 다음 명령어를 사용하여 링크가 존재하는지 확인합니다. 디렉터리가 존재하면 이 단계를 건너뜁니다.
```
ls -l | grep ^l
```
```
ln -s $APIGEECTL_HOME/tools tools
ln -s $APIGEECTL_HOME/config config
ln -s $APIGEECTL_HOME/templates templates
ln -s $APIGEECTL_HOME/plugins plugins
```
심볼릭 링크가 올바르게 생성되었는지 확인하려면 이 명령어를 실행하고 링크 경로가 올바른 위치를 가리키는지 확인합니다.
```
ls -l | grep ^l
```

이제 Kubernetes 클러스터에서 Apigee Hybrid를 구성, 배포, 관리할 수 있는 홈이 제공됩니다. 이제 하이브리드 런타임 구성요소를 구성하는 데 필요한 Google Cloud 서비스 계정과 사용자 인증 정보를 만듭니다.

1 2 3 4 (다음) 5단계: 서비스 계정 설정 6 7

4단계: apigeectl 설치

apigeectl 다운로드 및 설치

프로젝트 디렉터리 구조 설정

`apigeectl` 다운로드 및 설치