3단계: 환경 그룹 만들기

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

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

환경 만들기

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

Apigee UI

UI에 액세스하고 환경을 추가하기 위해 다음 단계를 수행합니다.

  1. Apigee UI를 엽니다. 처음 로그인하는 경우 Hybrid에 동의 대화상자가 표시됩니다. 2개 이상의 계정에서 선택하라는 메시지가 표시되면 Apigee Hybrid를 설치하는 데 사용하는 Google Cloud 프로젝트를 소유한 계정을 선택합니다. 그런 다음 허용을 클릭합니다.
  2. 브라우저는 UI 기본 방문 페이지로 이동합니다.

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

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

    하이브리드 지원 조직 목록

  4. 관리 > 환경 > 개요를 클릭합니다.

    관리, 환경, 개요를 펼친 Apigee UI 메뉴

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

  5. +환경을 클릭합니다.

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

    새 환경 대화상자

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

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

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

    3. 설명(선택사항): 환경의 목적에 대한 알림으로 추가할 환경에 대한 추가 정보입니다. 예를 들면 '초기 설치 중에 생성됨'입니다.
  7. 다른 기본값을 유지하고 만들기를 클릭합니다.

    Apigee는 새 환경을 만듭니다.

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

Apigee API

환경 만들기 API로 환경을 만들려면 다음 단계를 수행합니다.

  1. Apigee를 관리하는 데 사용하는 기기에서 터미널을 엽니다.
  2. 명령줄에서 다음 명령어를 사용하여 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%

    그러면 토큰이 인코딩된 문자열로 표시됩니다.

  3. 다음의 환경 변수를 만듭니다.

    Linux/macOS

    export ENV_NAME="YOUR_ENV_NAME"

    Windows

    set ENV_NAME="YOUR_ENV_NAME"

    각 항목의 의미는 다음과 같습니다.

    • ENV_NAME (필수) 환경 이름은 소문자, 대시, 숫자를 포함할 수 있으며 소문자로 시작해야 합니다. 이 이름은 식별자로 사용되며 환경을 만든 후에는 변경될 수 없습니다.
  4. 다음 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"

    성공적인 생성 요청에는 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입니다.

  5. 환경이 성공적으로 생성되었는지 확인합니다.
    curl -H "Authorization: Bearer $TOKEN" \
              "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

    생성 요청에 성공하면 Environments API가 다음과 유사한 메시지로 응답합니다.

    [
      "your-environment-name"
    ]

환경 그룹 만들기

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

Apigee UI

Apigee UI를 사용하여 환경 그룹을 만들려면 다음 단계를 수행합니다.

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

  3. 조직 드롭다운 목록에서 조직이 선택되어 있는지 확인합니다. 선택하지 않았으면 드롭다운 목록에서 선택합니다.
  4. 관리 > 환경 > 그룹을 클릭합니다.

    환경 그룹 개요 뷰가 표시됩니다.

    환경 그룹 뷰

  5. +환경 그룹을 클릭합니다.

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

    빈 이름 필드를 보여주는 환경 그룹 추가 대화상자

  6. 이름을 입력한 다음 추가를 클릭합니다.
  7. 새로 만든 환경 그룹 위에 마우스 포인터를 올려놓고 수정을 클릭합니다.

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

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

  8. 할당된 환경이 표시되지 않는 환경 그룹 창 수정

  9. 환경 상자에서 추가(+)를 클릭합니다.
  10. 환경 추가 대화상자가 표시됩니다.
  11. 사용 가능한 환경을 나열하는 환경 추가 대화상자

  12. 목록에서 환경을 선택한 다음 추가를 클릭합니다.

Apigee API

Apigee API를 사용하여 환경 그룹을 만들려면 다음 안내를 따르세요.

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

    Linux/MacOS

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

    Windows

    for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a
  2. 다음의 환경 변수를 만듭니다.

    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 (필수) 환경 이름은 소문자, 대시, 숫자를 포함할 수 있으며 소문자로 시작해야 합니다. 이 이름은 식별자로 사용되며 생성 후에는 변경할 수 없습니다.
  3. 환경 그룹을 만듭니다.
    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"
        
  4. 새 그룹에 환경을 할당합니다.
    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"
        
  5. 다음 CURL 명령어를 사용하여 환경 그룹이 성공적으로 생성되었는지 확인합니다.
    curl -H "Authorization: Bearer $TOKEN" \
      "https://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"
              }
            ]
          }
        
  6. 다음 CURL 명령어를 사용하여 새로 만든 환경 그룹의 최신 연결을 가져옵니다.
    curl -H "Authorization: Bearer $TOKEN" \ 
      "https://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부: 하이브리드 런타임 설정으로 이동하여 설치 계속하기