이 페이지는 Cloud Translation API를 통해 번역되었습니다.

3단계: 환경 그룹 만들기

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

Apigee에서 API 프록시는 프록시에 대해 격리된 컨텍스트를 제공하는 환경에 배포됩니다. 환경은 그룹 내 환경에 배포되는 모든 프록시의 호스트 이름을 제공하는 환경 그룹으로 구성됩니다. 1개 이상의 환경과 1개 이상의 환경 그룹이 있어야 합니다. 자세한 내용은 환경 및 환경 그룹 정보를 참조하세요.

환경 만들기

환경 그룹을 만들기 전에 먼저 환경을 만듭니다. Apigee UI나 API를 사용하여 환경을 만들 수 있습니다. 이 단계에 익숙해지기 위해서는 UI를 사용하는 것이 좋습니다.

Apigee UI

Apigee UI에서 새 환경을 만들려면 다음 안내를 따르세요.

Apigee UI에서 관리 > 환경으로 이동합니다.
환경으로 이동
환경 창에서 + 환경 만들기를 클릭합니다.
환경 만들기 창에서 다음을 입력합니다.
- 이름: 프로그래매틱 환경 이름입니다. 이름을 만든 후에는 변경할 수 없습니다.
  
  이름은 2~32자(영문 기준) 사이여야 하며 소문자, 숫자, 하이픈일 수 있습니다. 이름은 문자로 시작해야 하며 하이픈으로 끝나서는 안 됩니다. 이름은 조직의 다른 환경 이름과 달라야 합니다.
- 표시 이름: UI에 표시되는 환경의 이름입니다.
- 설명: 선택사항입니다. 환경에 대한 설명입니다.
- 인스턴스: 인스턴스 필드를 비워 둡니다. 인스턴스는 Apigee Hybrid 설치에 적용되지 않습니다.
- 환경 그룹: 지금은 환경 그룹 필드를 비워 둡니다. 다음 절차에서 환경 그룹을 만듭니다.
- 배포 유형: 대부분의 Apigee Hybrid 설치의 경우 개별 API 프록시를 배포하는 옵션을 선택합니다. API 프록시 구성 환경 보관 파일을 선택적으로 배포할 수 있습니다. 자세한 내용은 지원되는 배포 유형을 참조하세요.
  참고: 이 환경에 사용되는 배포 유형은 환경을 만든 후 변경할 수 없습니다.
만들기를 클릭합니다.

완료되면 새 환경이 환경 창의 테이블에 표시됩니다.

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"
]

환경 그룹 만들기

이제 환경 그룹을 만들고 바로 전에 만든 환경을 여기에 할당합니다.

Apigee UI

Apigee UI에서 새 환경 그룹을 만들려면 다음 안내를 따르세요.

Apigee UI에서 관리 > 환경 > 환경 그룹으로 이동합니다.
환경 그룹으로 이동
+ 환경 그룹 만들기를 클릭합니다.
다음을 입력합니다.
- 환경 그룹 이름: 환경 그룹 이름입니다. 이름은 영숫자 문자로 시작하고 끝나야 합니다. 최대 63자(영문 기준)의 영숫자 문자와 하이픈으로 구성될 수 있습니다. 이름은 조직의 기존 환경 그룹 이름과 달라야 합니다.
- 호스트 이름: 프록시를 호출하는 데 사용할 수 있는 호스트 이름 목록입니다. 각 호스트 이름은 별도의 줄에 있어야 합니다.
  
  참고: 환경 그룹에 할당된 이름은 해당 그룹에서 고유해야 하며 다른 환경 그룹에서 사용할 수 없습니다.
  
  이 도메인으로 Google 부하 분산기 구성을 클릭할 수도 있습니다. 그러면 Cloud 콘솔에서 호스트 이름에 대한 부하 분산을 구성할 수 있는 부하 분산 페이지가 열립니다.
- 환경: 환경 그룹에 포함할 환경의 선택적 목록입니다.
만들기를 클릭합니다.

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-1234-caaa660b2bd6",
              "environment": "your_envtest_hybrid",
              "createdAt": "1677826263567",
              "environmentGroupId": "your_envgroup_hybrid"
            }
          ]
        }

다음 단계

2부: 하이브리드 런타임 설정으로 이동하여 설치 계속하기

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

환경 만들기

Apigee UI

Apigee API

Linux/MacOS

Windows

Linux/macOS

Windows

데이터 상주 없음

데이터 상주

데이터 상주 없음

데이터 상주

환경 그룹 만들기

Apigee UI

Apigee API

Linux/MacOS

Windows

Linux/macOS

Windows

데이터 상주 없음

데이터 상주

데이터 상주 없음

데이터 상주

데이터 상주 없음

데이터 상주

데이터 상주 없음

데이터 상주

다음 단계

3단계: 환경 그룹 만들기