3단계: 환경 그룹 만들기

이 단계에서는 환경 및 환경 그룹을 만듭니다.

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 기본 방문 페이지로 이동합니다.

왼쪽 탐색창과 링크가 있는 대형 이미지로 구성된 Apigee UI의 방문 페이지입니다.

조직 드롭다운 목록에서 조직이 선택되어 있는지 확인합니다. 선택되어 있지 않은 경우 다음 예시와 같이 드롭다운 목록에서 선택합니다.
관리 > 환경 > 개요를 클릭합니다.

환경 뷰가 표시됩니다(아직 환경 없음).
+환경을 클릭합니다.
새 환경 대화상자가 표시됩니다.
새 환경 대화상자에 다음 정보를 입력합니다.
1. 표시 이름(필수): UI에 사용되는 환경의 별칭입니다. 예를 들면 'My First Environment' 또는 'test'입니다. 환경 이름과 달리 표시 이름은 대문자와 기타 특수문자를 포함할 수 있습니다.
2. 환경 이름(필수): 환경의 프로그래매틱 이름이며 환경 ID라고도 합니다.
  예를 들면 'my-environment' 또는 'test'입니다.
  
  주의: 환경 이름은 소문자, 숫자, 하이픈만 포함할 수 있습니다. 대문자 또는 기타 특수문자는 사용할 수 없습니다. 또한 환경 이름은 최대 32자(영문 기준)까지 가능합니다. 예를 들면 my-test-env 또는 my-test-env-42입니다.
  
  표시 이름과 환경 이름은 다를 수 있습니다.
3. 설명(선택사항): 환경의 목적에 대한 알림으로 추가할 환경에 대한 추가 정보입니다. 예를 들면 '초기 설치 중에 생성됨'입니다.
다른 기본값을 유지하고 만들기를 클릭합니다.
Apigee는 새 환경을 만듭니다.

이제 환경 그룹을 만들고 새 환경을 그룹에 추가해야 합니다.

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를 엽니다.

브라우저는 Apigee UI 기본 방문 페이지로 이동합니다.

조직 드롭다운 목록에서 조직이 선택되어 있는지 확인합니다. 선택하지 않았으면 드롭다운 목록에서 선택합니다.
관리 > 환경 > 그룹을 클릭합니다.
환경 그룹 개요 뷰가 표시됩니다.
+환경 그룹을 클릭합니다.
환경 그룹 추가 대화상자가 표시됩니다.
이름을 입력하고 추가를 클릭합니다.
새로 만든 환경 그룹 위에 마우스 포인터를 올려놓고 수정을 클릭합니다.

이 그룹 내 환경에 배포되는 모든 프록시에 사용될 호스트 이름을 추가합니다. 이 이름은 관리 액세스 권한이 있는 도메인이어야 합니다. 호스트 이름은 example.com과 같이 도메인 자체이거나 my-proxies.example.com과 같이 하위 도메인을 포함할 수 있습니다.

도메인을 등록해야 하는 경우 Google Domains와 같은 도메인 등록기관을 참조하세요.

선택적으로 도메인의 부하 분산기를 구성할 수 있습니다. 부하 분산기에 대한 자세한 내용은 Cloud Load Balancing 개요를 참조하세요.
환경 상자에서 추가(+)를 클릭합니다.
환경 추가 대화상자가 표시됩니다.
목록에서 환경을 선택한 다음 추가를 클릭합니다.
저장을 클릭합니다.

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부: 하이브리드 런타임 설정으로 이동하여 설치 계속하기

3단계: 환경 그룹 만들기 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

환경 만들기

Cloud 콘솔의 Apigee

기본 Apigee UI

Apigee API

Linux/MacOS

Windows

Linux/macOS

Windows

데이터 상주 없음

데이터 상주

데이터 상주 없음

데이터 상주

환경 그룹 만들기

Cloud 콘솔의 Apigee

기본 Apigee UI

Apigee API

Linux/MacOS

Windows

Linux/macOS

Windows

데이터 상주 없음

데이터 상주

데이터 상주 없음

데이터 상주

데이터 상주 없음

데이터 상주

데이터 상주 없음

데이터 상주

다음 단계

3단계: 환경 그룹 만들기