5단계: 환경 그룹 만들기

조직 드롭다운 목록에서 하이브리드 지원 조직이 선택되어 있는지 확인합니다. 선택되어 있지 않은 경우 다음 예시와 같이 드롭다운 목록에서 선택합니다.

환경 뷰가 표시됩니다(아직 환경 없음).

새 환경 대화상자가 표시됩니다.

1. 표시 이름(필수): UI에 사용되는 환경의 별칭입니다. 예를 들면 'My First Environment' 또는 'test'입니다. 환경 이름과 달리 표시 이름은 대문자와 기타 특수문자를 포함할 수 있습니다.
2. 환경 이름(필수): 환경의 프로그래매틱 이름이며 환경 ID라고도 합니다.

   예를 들면 'my-environment' 또는 'test'입니다.

   표시 이름과 환경 이름은 다를 수 있습니다.

3. 설명(선택사항): 환경의 목적에 대한 알림으로 추가할 환경에 대한 추가 정보입니다. 예를 들면 '초기 설치 중에 생성됨'입니다.

Apigee에서 새 환경을 만들고 프로비저닝 대기중임을 나타냅니다.

잠시 후 프로비저닝됨으로 변경됩니다.

하지만 아직 완료되지 않았습니다. 또한 새 환경을 런타임의 overrides.yaml 파일에 추가해야 합니다. 하지만 그 전에 먼저 런타임을 설치해야 합니다.

명령줄에서 다음 명령어를 사용하여 gcloud 인증 사용자 인증 정보를 가져옵니다.

TOKEN=$(gcloud auth print-access-token)

echo $TOKEN

for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a

echo %TOKEN%

• ENV_NAME(필수)은 환경의 프로그래매틱 ID입니다. 환경 이름은 소문자, 대시, 숫자를 포함할 수 있으며 소문자로 시작해야 합니다. 이 이름은 식별자로 사용되며 생성 후에는 변경할 수 없습니다.

  export ENV_NAME=environment_name

• ENV_DISPLAY_NAME(필수)은 환경의 사용자 친화적인 이름입니다. 이 값은 고유할 필요가 없으며 공백과 특수문자를 포함할 수 있습니다. 예를 들면 'My Example Environment'입니다.

  ENV_DISPLAY_NAME=friendly_name

• ORG_NAME(필수)은 조직 ID입니다. 4단계: 조직 만들기에서 ORG_NAME 환경 변수를 정의했는지 확인합니다.

  echo $ORG_NAME

• ENV_DESCRIPTION(선택사항)은 목적에 맞게 알림으로 사용하려는 환경에 대한 정보입니다. 예를 들면 'Apigee Hybrid 안내용 예시 환경'입니다.

  ENV_DESCRIPTION=description_text

다음 예시에서는 다음 명령어를 사용하여 환경을 만드는 요청 구조를 보여줍니다.

curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json"   -d '{
    "name": "'"$ENV_NAME"'",
    "displayName": "'"$ENV_DISPLAY_NAME"'",
    "description": "'"$ENV_DESCRIPTION"'"
  }'   "https://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입니다. 이 프로세스는 몇 분이 소요될 수 있습니다.

생성된 환경 그룹과 함께 환경 그룹 개요 뷰가 표시됩니다.

환경 그룹 추가 대화상자가 표시됩니다.

새로 만든 환경 그룹 위에 마우스 포인터를 올려놓고 수정edit을 클릭합니다.

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

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

명령줄에서 다음 명령어를 사용하여 gcloud 인증 사용자 인증 정보를 가져옵니다.

TOKEN=$(gcloud auth print-access-token)

for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a

echo $DOMAIN

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

설정되어 있지 않다면 Apigee Hybrid 설치용으로 사용할 도메인으로 도메인 이름을 만듭니다. 예를 들면 다음과 같습니다.

export DOMAIN=domain-name.com

echo $ENV_NAME

export ENV_GROUP=environment-group-name

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 '{
     "environment": "'"$ENV_NAME"'",
   }' \
   "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"