1단계: 환경 변수 정의

이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.

Apigee Edge 문서를 보세요.

이 단계에서 수행할 작업

이 섹션에서는 문서 전체(특히 이 구성 튜토리얼)에서 사용되는 여러 환경 변수를 설정하는 방법을 설명합니다. 표시된 대로 명령어를 입력할 수 있도록 환경 변수를 사용하는 것이 좋습니다.

이는 Apigee 프로비저닝 마법사를 시작하기 전에 명령줄에서 수행하는 두 단계 중 첫 번째입니다.

단계 수행

명령줄에서 환경 변수를 정의하려면 다음 안내를 따르세요.

  1. 현재 프로젝트에 다음 환경 변수를 정의합니다. 
    PROJECT_ID="YOUR_PROJECT_ID"
PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format="value(projectNumber)")
RUNTIME_LOCATION="YOUR_RUNTIME_LOCATION"
ANALYTICS_REGION="YOUR_ANALYTICS_REGION"
RUNTIMEDBKEY_LOCATION="RUNTIMEDB_LOCATION"
APPKEY_KEY_RING_NAME="RUNTIMEDB_KEY_RING_NAME"
APPKEY_KEY_NAME="RUNTIMEDB_KEY_NAME"
DISK_KEY_RING_NAME="DISK_KEY_RING_NAME"
DISK_KEY_NAME="DISK_KEY_NAME"

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

    • PROJECT_ID는 기본 요건의 일부로 만든 Cloud 프로젝트 ID입니다. 프로젝트 ID를 모르는 경우 Cloud 콘솔 또는 gcloud projects list 명령어를 사용하여 찾습니다.
    • PROJECT_NUMBER는 기본 요건의 일부로 만든 Cloud 프로젝트 번호입니다. 이 예시에서는 gcloud 명령어를 실행하여 프로젝트 번호를 가져옵니다. 또는 Google Cloud Console 프로젝트 대시보드에서 찾거나 gcloud projects list 명령어를 사용하여 찾을 수 있습니다.

    • RUNTIME_LOCATION은 인스턴스가 위치한 물리적 위치입니다. 유효한 값은 모든 Compute Engine 리전(유료 조직의 경우)이거나 Compute Engine 영역(평가 조직의 경우)입니다. 자세한 내용은 Compute Engine 위치를 참조하세요.

    • ANALYTICS_REGION은 애널리틱스 데이터를 저장하는 물리적 위치입니다.

      유효한 값은 Compute Engine 리전의 일부입니다. 가능한 값은 다음과 같습니다.

      • asia-northeast1
      • asia-south1
      • europe-west1
      • us-central1
      • us-east1
      • us-west1
      • australia-southeast1
      • europe-west2

      평가 및 유료 계정 모두 분석 위치에 리전을 사용합니다. 여기서 유료 조직의 값은 RUNTIME_LOCATION(또한 리전)과 값이 동일할 수 있습니다. 하지만 ANALYTICS_REGION 값은 RUNTIME_LOCATION과 동일하면 안 됩니다. 그러나 동일하면 성능상 이점이 있을 수 있습니다.

      평가 계정의 경우 분석 위치는 리전이지만 런타임 위치는 영역이므로 동일하지 않습니다.

    • RUNTIME_LOCATION은 애플리케이션 키링과 키가 저장되는 실제 물리적 위치입니다. Apigee는 애플리케이션 키를 사용하여 KVM, 캐시, 클라이언트 보안 비밀번호 등의 애플리케이션 데이터를 암호화한 다음 데이터베이스에 저장합니다.

      분석 리전과 마찬가지로 유효한 값은 Compute Engine 리전의 하위 집합입니다. 이 값은 $RUNTIME_LOCATION(리전이라고도 함)과 같을 수 있지만 반드시 그럴 필요는 없습니다. 결과가 동일하면 성능상 이점을 얻을 수 있습니다.

    • RUNTIME_LOCATION은 애플리케이션 키가 저장되는 키링의 이름입니다. 키링의 이름은 조직에서 고유해야 합니다. 추가 리전을 만드는 경우 해당 리전의 키링 이름은 기존 키링 이름과 동일할 수 없습니다.
    • APPKEY_KEY_NAME은 애플리케이션 키의 이름입니다. 애플리케이션 키 이름은 지정된 키링 내에서 고유해야 합니다.
    • DISK_KEY_RING_NAME은 디스크 키링의 이름입니다. 디스크 키링 이름은 애플리케이션 키 이름과 달라야 합니다. $RUNTIME_LOCATION과 동일한 위치에 디스크 키링을 만듭니다.
    • DISK_KEY_NAME은 Apigee가 디스크에 기록하기 전에 런타임 인스턴스 데이터를 암호화하는 데 사용하는 디스크 암호화 키의 이름입니다.

    다음 예시에서는 유료 조직의 환경 변수를 정의합니다. 

    PROJECT_ID="my-cloud-project"
PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format="value(projectNumber)")
RUNTIME_LOCATION="us-west1"
ANALYTICS_REGION="us-west1"
RUNTIMEDBKEY_LOCATION="us-west1"
APPKEY_KEY_RING_NAME="us-west1"
APPKEY_KEY_NAME="us-west1"
DISK_KEY_RING_NAME="us-west1"
DISK_KEY_NAME="us-west1"

    평가 조직의 경우 RUNTIME_LOCATION은 리전 대신 영역으로 설정됩니다.

    명령어에 $PROJECT_ID와 같은 변수 이름을 문자열 리터럴로 사용합니다.

    프로비저닝 및 구성 중에는 이러한 모든 환경 변수를 사용하지 못할 수 있습니다.

  2. (선택사항) 방금 설정한 값을 에코하여 작업을 확인합니다. 명령어에 변수를 사용하려면 변수 이름 앞에 달러 기호($)를 추가합니다. 
    echo $PROJECT_ID
echo $PROJECT_NUMBER
echo $ANALYTICS_REGION
echo $RUNTIMEDBKEY_LOCATION
echo $APPKEY_KEY_RING_NAME
echo $APPKEY_KEY_NAME
echo $DISK_KEY_RING_NAME
echo $DISK_KEY_NAME

    echo 명령어에 대한 응답은 다음과 같이 표시됩니다.

    Authorization: Bearer ya29.a123456678940B63hPSAMPLEsampleKKYVsample0f3pWDWZDuH2-hENkNa
TvgZ1PD977TMvv6edBQPJezdHw040880Ol_LoD5ZDkt-i-knizia_KhA9L20sSvztL81-SAMPLE42ELPMASk2_
1CxN
my-cloud-project
1234567890
us-west1
us-west1
us-west1
$RUNTIMEDB_KEY_RING_NAME
$RUNTIMEDB_KEY_NAME
$DISK_KEY_RING_NAME
$DISK_KEY_NAME

이 프로세스 중에 오류가 발생하면 문제 해결을 참조하세요.

1 다음: API 사용 설정 3 4 5 6 7 8