이 단계에서는 apigeectl을 다운로드하고 설치하는 방법을 설명합니다.
apigeectl
다운로드 및 설치
apigeectl
은 Kubernetes 클러스터에서 Apigee Hybrid 설치 및 관리를 위한 명령줄 인터페이스(CLI)입니다.
다음 단계에서는 apigeectl
을 다운로드하고 설치하는 방법을 설명합니다.
Linux
-
다음 명령어를 사용하여 운영체제용 출시버전 패키지를 다운로드합니다.
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.10.5/apigeectl_linux_64.tar.gz
- Apigee hybrid 설치의 기본 디렉터리 역할을 하는 디렉터리를 시스템에 만듭니다.
-
다음 명령어를 사용하여 다운로드한 gzip 파일 콘텐츠를 방금 만든 기본 디렉터리에 추출합니다.
tar xvzf filename.tar.gz -C path-to-base-directory
-
cd
명령어를 사용하여 디렉터리를 기본 디렉터리로 변경합니다. -
tar 콘텐츠는 기본적으로 이름에 해당 버전과 플랫폼이 포함된 디렉터리로 확장됩니다. 예를 들면
./apigeectl_1.10.5-d591b23_linux_64
입니다. 다음 명령어를 사용하여 디렉터리 이름을apigeectl
로 변경합니다.mv apigeectl_1.10.5-d591b23_linux_64/ apigeectl
-
다음 명령어를 사용하여 디렉터리로 변경합니다.
cd ./apigeectl
이 디렉터리는
apigeectl
홈 디렉터리입니다. 여기에apigeectl
실행 가능한 명령어가 있습니다. version
명령어를 사용하여apigeectl
버전을 확인합니다../apigeectl version
Version: 1.10.5
-
다음 명령어를 사용하여 이 홈 디렉터리 경로를 저장할 환경 변수를 만듭니다.
export APIGEECTL_HOME=$PWD
-
다음 명령어를 사용하여 변수에 올바른 경로가 포함되었는지 확인합니다.
echo $APIGEECTL_HOME
MacOS
-
다음 명령어를 사용하여 운영체제용 출시버전 패키지를 다운로드합니다.
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.10.5/apigeectl_mac_64.tar.gz
- Apigee hybrid 설치의 기본 디렉터리 역할을 하는 디렉터리를 시스템에 만듭니다.
-
다음 명령어를 사용하여 다운로드한 gzip 파일 콘텐츠를 방금 만든 기본 디렉터리에 추출합니다.
tar xvzf filename.tar.gz -C path-to-base-directory
-
cd
명령어를 사용하여 디렉터리를 기본 디렉터리로 변경합니다. -
tar 콘텐츠는 기본적으로 이름에 해당 버전과 플랫폼이 포함된 디렉터리로 확장됩니다. 예를 들면
./apigeectl_1.10.5-d591b23_mac_64
입니다. 다음 명령어를 사용하여 디렉터리 이름을apigeectl
로 변경합니다.mv apigeectl_1.10.5-d591b23_mac_64 apigeectl
-
다음 명령어를 사용하여 디렉터리로 변경합니다.
cd ./apigeectl
이 디렉터리는
apigeectl
홈 디렉터리입니다. 여기에apigeectl
실행 가능한 명령어가 있습니다. version
명령어를 사용하여apigeectl
버전을 확인합니다../apigeectl version
Version: 1.10.5
-
다음 명령어를 사용하여 이 홈 디렉터리 경로를 저장할 환경 변수를 만듭니다.
export APIGEECTL_HOME=$PWD
-
다음 명령어를 사용하여 변수에 올바른 경로가 포함되었는지 확인합니다.
echo $APIGEECTL_HOME
Windows
-
다음 명령어를 사용하여 운영체제용 출시버전 패키지를 다운로드합니다.
curl -LO ^ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.10.5/apigeectl_windows_64.zip
- Apigee hybrid 설치의 기본 디렉터리 역할을 하는 디렉터리를 시스템에 만듭니다.
-
다음 명령어를 사용하여 다운로드한 .ZIP 파일 콘텐츠를 현재 디렉터리에 추출합니다.
tar xvzf filename.zip -C path-to-base-directory
-
cd
명령어를 사용하여 디렉터리를 기본 디렉터리로 변경합니다. -
tar 파일 콘텐츠는 기본적으로 이름에 해당 버전과 플랫폼이 포함된 디렉터리로 확장됩니다(예: 예를 들면
.\apigeectl_1.10.5-d591b23_windows_64
입니다. 다음 명령어를 사용하여 디렉터리 이름을apigeectl
로 변경합니다.rename apigeectl_1.10.5-d591b23_windows_64 apigeectl
-
다음 명령어를 사용하여 디렉터리로 변경합니다.
cd .\apigeectl
이 디렉터리는
apigeectl
홈 디렉터리입니다. 여기에apigeectl
실행 가능한 명령어가 있습니다. version
명령어를 사용하여apigeectl
버전을 확인합니다../apigeectl version
Version: 1.10.5
-
다음 명령어를 사용하여 이 홈 디렉터리 경로를 저장할 환경 변수를 만듭니다.
set APIGEECTL_HOME=%CD%
-
다음 명령어를 사용하여 변수에 올바른 경로가 포함되었는지 확인합니다.
echo %APIGEECTL_HOME%
프로젝트 디렉터리 구조 설정
다음 디렉터리 구조는 권장되는 방식입니다. 이 방식은 Apigee Hybrid 출시 소프트웨어를 개발자가 만들어야 하는 구성 파일과 분리합니다. 만들려는 $APIGEECTL_HOME
변수 및 심볼릭 링크를 사용하면 원하는 경우 새 소프트웨어 버전으로 쉽게 전환할 수 있습니다. Apigee Hybrid 업그레이드도 참조하세요.
Linux
-
다음 명령어를 사용하여 기본 디렉터리(
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
디렉터리의 경로를 저장할 환경 변수를 만듭니다.export HYBRID_FILES=$PWD
echo $HYBRID_FILES
-
hybrid-files
디렉터리 내에서 다음 하위 디렉터리를 만들어 나중에 만들 파일을 구성합니다.mkdir overrides
mkdir certs
-
hybrid-files
디렉터리 내에서$APIGEECTL_HOME
에 대해 다음 심볼릭 링크를 만듭니다. 이러한 링크를 사용하면 다음 예시와 같이hybrid-files
디렉터리 내부에서apigeectl
명령어를 실행할 수 있습니다.ln -s
$APIGEECTL_HOME
/tools toolsln -s
$APIGEECTL_HOME
/config configln -s
$APIGEECTL_HOME
/templates templatesln -s
$APIGEECTL_HOME
/plugins plugins -
심볼릭 링크가 올바르게 생성되었는지 확인하려면 이 명령어를 실행하고 링크 경로가 올바른 위치를 가리키는지 확인합니다.
ls -l | grep ^l
MacOS
-
다음 명령어를 사용하여 기본 디렉터리(
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
디렉터리의 경로를 저장할 환경 변수를 만듭니다.export HYBRID_FILES=$PWD
echo $HYBRID_FILES
-
hybrid-files
디렉터리 내에서 다음 하위 디렉터리를 만들어 나중에 만들 파일을 구성합니다.mkdir overrides
mkdir certs
-
hybrid-files
디렉터리 내에서$APIGEECTL_HOME
에 대해 다음 심볼릭 링크를 만듭니다. 이러한 링크를 사용하면 다음 예시와 같이hybrid-files
디렉터리 내부에서apigeectl
명령어를 실행할 수 있습니다.ln -s
$APIGEECTL_HOME
/tools toolsln -s
$APIGEECTL_HOME
/config configln -s
$APIGEECTL_HOME
/templates templatesln -s
$APIGEECTL_HOME
/plugins plugins -
심볼릭 링크가 올바르게 생성되었는지 확인하려면 이 명령어를 실행하고 링크 경로가 올바른 위치를 가리키는지 확인합니다.
ls -l | grep ^l
Windows
-
다음 명령어를 사용하여 기본 디렉터리(
apigeectl
디렉터리가 있는 디렉터리)에 있는지 확인합니다.cd %APIGEECTL_HOME%\..
-
다음 명령어를 사용하여
hybrid-files
라는 새 폴더를 만듭니다. 디렉터리에 원하는 이름을 지정할 수 있지만 문서에서는hybrid-files
이름을 일관되게 사용합니다. 나중에 이 폴더에 구성 파일, 서비스 계정 키, TLS 인증서를 저장합니다. 이 폴더를 사용하면 구성 파일을apigeectl
소프트웨어 설치와 별도로 유지할 수 있습니다.mkdir hybrid-files
-
현재 디렉터리 구조는 다음과 같습니다.
dir
Directory of C:\Users\example\hybrid 08/05/2021 01:38 PM <DIR> . 08/05/2021 01:38 PM <DIR> .. 08/02/2021 01:11 PM <DIR> apigeectl 08/02/2021 11:13 AM 5,803,963 apigeectl_1.10.5rc1-437dccc_windows_64.zip 08/05/2021 01:38 PM <DIR> hybrid-files
-
디렉터리를
hybrid-files
폴더로 변경합니다. -
hybrid-files
디렉터리의 경로를 저장할 환경 변수를 만듭니다.set HYBRID_FILES=%CD%
echo %HYBRID_FILES%
-
hybrid-files
디렉터리 내에서 다음 하위 디렉터리를 만들어 나중에 만들 파일을 구성합니다.mkdir overrides
mkdir certs
-
hybrid-files
디렉터리 내에서$APIGEECTL_HOME
에 대해 다음 심볼릭 링크를 만듭니다. 이러한 링크를 사용하면 다음 예시와 같이hybrid-files
디렉터리 내부에서apigeectl
명령어를 실행할 수 있습니다.mklink /d config %APIGEECTL_HOME%\config\
mklink /d plugins %APIGEECTL_HOME%\plugins\
mklink /d templates %APIGEECTL_HOME%\templates\
mklink /d tools %APIGEECTL_HOME%\tools\
-
심볼릭 링크가 올바르게 생성되었는지 확인하려면
dir
를 사용합니다.dir
Directory of C:\Users\example\hybrid\hybrid-files 08/05/2021 01:56 PM <DIR> . 08/05/2021 01:56 PM <DIR> .. 08/05/2021 01:46 PM <DIR> certs 08/05/2021 01:55 PM <SYMLINKD> config [C:\Users\example\hybrid\apigeectl\config\] 08/05/2021 01:46 PM <DIR> overrides 08/05/2021 01:56 PM <SYMLINKD> plugins [C:\Users\example\hybrid\apigeectl\plugins\] 08/05/2021 01:56 PM <SYMLINKD> templates [C:\Users\example\hybrid\apigeectl\templates\] 08/05/2021 01:56 PM <SYMLINKD> tools [C:\Users\example\hybrid\apigeectl\tools\]
이제 Kubernetes 클러스터에서 Apigee Hybrid를 구성, 배포, 관리할 수 있는 홈이 제공됩니다. 이제 하이브리드 런타임 구성요소를 구성하는 데 필요한 Google Cloud 서비스 계정과 사용자 인증 정보를 만듭니다.
1 2 3 (다음) 4단계: 서비스 계정 설정 5 6 7 8 9 10 11