이 단계에서는 환경 및 환경 그룹을 만듭니다.
Apigee에서 API 프록시는 프록시에 대해 격리된 컨텍스트를 제공하는 환경에 배포됩니다. 환경은 그룹 내 환경에 배포되는 모든 프록시의 호스트 이름을 제공하는 환경 그룹으로 구성됩니다. 1개 이상의 환경과 1개 이상의 환경 그룹이 있어야 합니다. 자세한 내용은 환경 및 환경 그룹 정보를 참조하세요.
환경 만들기
환경 그룹을 만들기 전에 먼저 환경을 만듭니다. Apigee UI나 API를 사용하여 환경을 만들 수 있습니다. 이 단계에 익숙해지기 위해서는 UI를 사용하는 것이 좋습니다.
Cloud 콘솔의 Apigee
Cloud 콘솔의 Apigee에서 새 환경을 만들려면 다음 안내를 따르세요.
- 브라우저에서 Cloud 콘솔의 Apigee UI를 엽니다.
- 왼쪽 탐색창에서 관리 > 환경을 선택합니다.
- 환경 창에서 + 환경 만들기를 클릭합니다.
- 환경 만들기 창에서 다음을 입력합니다.
이름: 프로그래매틱 환경 이름입니다. 이름을 만든 후에는 변경할 수 없습니다.
이름은 2~32자(영문 기준) 사이여야 하며 소문자, 숫자, 하이픈일 수 있습니다. 이름은 문자로 시작해야 하며 하이픈으로 끝나서는 안 됩니다. 이름은 조직의 다른 환경 이름과 달라야 합니다.
- 표시 이름: UI에 표시되는 환경의 이름입니다.
- 설명: 선택사항입니다. 환경에 대한 설명입니다.
- 인스턴스: 인스턴스 필드를 비워 둡니다. 인스턴스는 Apigee Hybrid 설치에 적용되지 않습니다.
- 환경 그룹: 지금은 환경 그룹 필드를 비워 둡니다. 다음 절차에서 환경 그룹을 만듭니다.
- 배포 유형: 대부분의 Apigee Hybrid 설치의 경우 개별 API 프록시를 배포하는 옵션을 선택합니다. API 프록시 구성 환경 보관 파일을 선택적으로 배포할 수 있습니다. 자세한 내용은 지원되는 배포 유형을 참조하세요.
- 만들기를 클릭합니다.
완료되면 새 환경이 환경 창의 테이블에 표시됩니다.
기본 Apigee UI
UI에 액세스하고 환경을 추가하기 위해 다음 단계를 수행합니다.
- Apigee UI를 엽니다. 처음 로그인하는 경우 Hybrid에 동의 대화상자가 표시됩니다. 2개 이상의 계정에서 선택하라는 메시지가 표시되면 Apigee Hybrid를 설치하는 데 사용하는 Google Cloud 프로젝트를 소유한 계정을 선택합니다. 그런 다음 허용을 클릭합니다.
-
조직 드롭다운 목록에서 조직이 선택되어 있는지 확인합니다. 선택되어 있지 않은 경우 다음 예시와 같이 드롭다운 목록에서 선택합니다.
- 관리 > 환경 > 개요를 클릭합니다.
환경 뷰가 표시됩니다(아직 환경 없음).
- +환경을 클릭합니다.
새 환경 대화상자가 표시됩니다.
- 새 환경 대화상자에 다음 정보를 입력합니다.
- 표시 이름(필수): UI에 사용되는 환경의 별칭입니다. 예를 들면 'My First Environment' 또는 'test'입니다. 환경 이름과 달리 표시 이름은 대문자와 기타 특수문자를 포함할 수 있습니다.
- 환경 이름(필수): 환경의 프로그래매틱 이름이며 환경 ID라고도 합니다.
예를 들면 'my-environment' 또는 'test'입니다.
표시 이름과 환경 이름은 다를 수 있습니다.
- 설명(선택사항): 환경의 목적에 대한 알림으로 추가할 환경에 대한 추가 정보입니다. 예를 들면 '초기 설치 중에 생성됨'입니다.
- 다른 기본값을 유지하고 만들기를 클릭합니다.
Apigee는 새 환경을 만듭니다.
이제 환경 그룹을 만들고 새 환경을 그룹에 추가해야 합니다.
브라우저는 UI 기본 방문 페이지로 이동합니다.
Apigee API
환경 만들기 API로 환경을 만들려면 다음 단계를 수행합니다.
- Apigee를 관리하는 데 사용하는 기기에서 터미널을 엽니다.
-
명령줄에서 다음 명령어를 사용하여
gcloud인증 사용자 인증 정보를 가져옵니다.Linux/MacOS
export TOKEN=$(gcloud auth print-access-token)
토큰이 입력되었는지 확인하려면 다음 예시와 같이
echo를 사용합니다.echo $TOKEN
그러면 토큰이 인코딩된 문자열로 표시됩니다.
Windows
for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a토큰이 입력되었는지 확인하려면 다음 예시와 같이
echo를 사용합니다.echo %TOKEN%
그러면 토큰이 인코딩된 문자열로 표시됩니다.
- 다음의 환경 변수를 만듭니다.
Linux/macOS
export ENV_NAME="YOUR_ENV_NAME"
Windows
set ENV_NAME="YOUR_ENV_NAME"
각 항목의 의미는 다음과 같습니다.
-
ENV_NAME(필수) 환경 이름은 소문자, 대시, 숫자를 포함할 수 있으며 소문자로 시작해야 합니다. 이 이름은 식별자로 사용되며 환경을 만든 후에는 변경될 수 없습니다.
-
- 다음 Apigee API를 호출합니다.
데이터 상주 없음
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" -d '{ "name": "'"$ENV_NAME"'" }' "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"데이터 상주
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" -d '{ "name": "'"$ENV_NAME"'" }' "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"성공적인 생성 요청에는 Environments API가 다음과 유사한 메시지로 응답해야 합니다.
{ "name": "organizations/hybrid-example/operations/c2aee040-7e79-4fd4-b0cf-79ca1b7098a8", "metadata": { "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata", "operationType": "INSERT", "targetResourceName": "organizations/hybrid-example/environments/example-env", "state": "IN_PROGRESS" } }
응답의
state속성이 나타내는 것처럼 Apigee는 새 환경을 만들기 시작하였으므로 상태는IN_PROGRESS입니다. - 환경이 성공적으로 생성되었는지 확인합니다.
데이터 상주 없음
curl -H "Authorization: Bearer $TOKEN" \ "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"데이터 상주
curl -H "Authorization: Bearer $TOKEN" \ "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"생성 요청에 성공하면 Environments API가 다음과 유사한 메시지로 응답합니다.
[ "your-environment-name" ]
환경 그룹 만들기
이제 환경 그룹을 만들고 바로 전에 만든 환경을 여기에 할당합니다.
Cloud 콘솔의 Apigee
Cloud 콘솔의 Apigee에서 새 환경 그룹을 만들려면 다음 안내를 따르세요.
- 브라우저에서 Cloud 콘솔의 Apigee UI를 엽니다.
- 왼쪽 탐색창에서 관리 > 환경을 선택합니다.
- 환경 창에서 환경 그룹을 선택합니다.
- + 환경 그룹 만들기를 클릭합니다.
- 다음을 입력합니다.
- 환경 그룹 이름: 환경 그룹 이름입니다. 이름은 영숫자 문자로 시작하고 끝나야 합니다. 최대 63자(영문 기준)의 영숫자 문자와 하이픈으로 구성될 수 있습니다. 이름은 조직의 기존 환경 그룹 이름과 달라야 합니다.
호스트 이름: 프록시를 호출하는 데 사용할 수 있는 호스트 이름 목록입니다. 각 호스트 이름은 별도의 줄에 있어야 합니다.
이 도메인으로 Google 부하 분산기 구성을 클릭할 수도 있습니다. 그러면 Cloud 콘솔에서 호스트 이름에 대한 부하 분산을 구성할 수 있는 부하 분산 페이지가 열립니다.
- 환경: 환경 그룹에 포함할 환경의 선택적 목록입니다.
- 만들기를 클릭합니다.
기본 Apigee UI
Apigee UI를 사용하여 환경 그룹을 만들려면 다음 단계를 수행합니다.
- Apigee UI를 엽니다.
- 조직 드롭다운 목록에서 조직이 선택되어 있는지 확인합니다. 선택하지 않았으면 드롭다운 목록에서 선택합니다.
- 관리 > 환경 > 그룹을 클릭합니다.
환경 그룹 개요 뷰가 표시됩니다.
- +환경 그룹을 클릭합니다.
환경 그룹 추가 대화상자가 표시됩니다.
- 이름을 입력하고 추가를 클릭합니다.
-
새로 만든 환경 그룹 위에 마우스 포인터를 올려놓고 수정을 클릭합니다.
이 그룹 내 환경에 배포되는 모든 프록시에 사용될 호스트 이름을 추가합니다. 이 이름은 관리 액세스 권한이 있는 도메인이어야 합니다. 호스트 이름은
example.com과 같이 도메인 자체이거나my-proxies.example.com과 같이 하위 도메인을 포함할 수 있습니다.도메인을 등록해야 하는 경우 Google Domains와 같은 도메인 등록기관을 참조하세요.
선택적으로 도메인의 부하 분산기를 구성할 수 있습니다. 부하 분산기에 대한 자세한 내용은 Cloud Load Balancing 개요를 참조하세요.
- 환경 상자에서 추가(+)를 클릭합니다.
-
환경 추가 대화상자가 표시됩니다.
- 목록에서 환경을 선택한 다음 추가를 클릭합니다.
- 저장을 클릭합니다.
브라우저는 Apigee UI 기본 방문 페이지로 이동합니다.
Apigee API
Apigee API를 사용하여 환경 그룹을 만들려면 다음 안내를 따르세요.
-
명령줄에서 다음 명령어를 사용하여
gcloud인증 사용자 인증 정보를 가져옵니다.Linux/MacOS
TOKEN=$(gcloud auth print-access-token)
Windows
for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a - 다음의 환경 변수를 만듭니다.
Linux/macOS
export DOMAIN="YOUR_DOMAIN"
export ENV_GROUP="YOUR_ENVIRONMENT_GROUP"Windows
data-terminal-prefix=">">set ENV_GROUP="YOUR_ENVIRONMENT_GROUP"
data-terminal-prefix=">">set DOMAIN="YOUR_DOMAIN"각 항목의 의미는 다음과 같습니다.
DOMAIN(필수) 이 그룹 내 환경에 배포되는 모든 프록시에서 사용할 호스트 이름입니다. 관리하는 도메인이어야 합니다. 주소는example.com과 같은 도메인 자체이거나my-proxies.example.com과 같은 하위 도메인을 포함할 수 있습니다. 관리형 도메인이 없으면 지금은 자리표시자를 입력할 수 있습니다. 나중에 도메인 주소를 변경할 수 있습니다.-
ENV_GROUP(필수) 환경 이름은 소문자, 대시, 숫자를 포함할 수 있으며 소문자로 시작해야 합니다. 이 이름은 식별자로 사용되며 생성 후에는 변경할 수 없습니다.
- 환경 그룹을 만듭니다.
데이터 상주 없음
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \ -d '{ "name": "'"$ENV_GROUP"'", "hostnames":["'"$DOMAIN"'"] }' \ "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"데이터 상주
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \ -d '{ "name": "'"$ENV_GROUP"'", "hostnames":["'"$DOMAIN"'"] }' \ "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups" - 새 그룹에 환경을 할당합니다.
데이터 상주 없음
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \ -d '{ "environment": "'"$ENV_NAME"'", }' \ "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"데이터 상주
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \ -d '{ "environment": "'"$ENV_NAME"'", }' \ "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments" - 다음 CURL 명령어를 사용하여 환경 그룹이 성공적으로 생성되었는지 확인합니다.
데이터 상주 없음
curl -H "Authorization: Bearer $TOKEN" \ "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"
데이터 상주
curl -H "Authorization: Bearer $TOKEN" \ "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"
생성 요청에 성공하면 Environments Group API가 다음과 유사한 메시지로 응답합니다.
{ "environmentGroups": [ { "name": "your_envgroup_hybrid", "hostnames": [ "apigee.hybrid.com" ], "createdAt": "1677826235324", "lastModifiedAt": "1677826235324", "state": "ACTIVE" } ] } - 다음 CURL 명령어를 사용하여 새로 만든 환경 그룹의 최신 연결을 가져옵니다.
데이터 상주 없음
curl -H "Authorization: Bearer $TOKEN" \ "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"
데이터 상주
curl -H "Authorization: Bearer $TOKEN" \ "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"
아래 샘플 응답 출력에 표시된 것처럼 결과에 고유한 해시 값이 표시되면 환경 그룹 생성 및 연결이 성공한 것입니다.
{ "environmentGroupAttachments": [ { "name": "c27046d1-b83e-4cba-xxxx-caaa660b2bd6", "environment": "your_envtest_hybrid", "createdAt": "1677826263567", "environmentGroupId": "your_envgroup_hybrid" } ] }
다음 단계
2부: 하이브리드 런타임 설정으로 이동하여 설치 계속하기