GSP907

개요

이 실습에서는 Apigee 인스턴스에서 백엔드 서비스로 전송되는 요청에NAT(네트워크 주소 변환) IP 주소를 사용 설정하여 허용 목록에 추가할 수 있는 예측 가능한 IP 주소를 만듭니다.

목표

다음 작업을 실행하는 방법을 알아봅니다.

• Apigee API 참고 리소스에서 Apigee API 호출하기
• Apigee 런타임에서 수신되는 Apigee 요청에 대해 NAT IP 주소를 만들고 활성화하기
• 백엔드 서버로 전송되는 요청이 구성된 NAT IP 주소를 사용하는지 확인하기

설정

실습 시작 버튼을 클릭하기 전에

다음 안내를 확인하세요. 실습에는 시간 제한이 있으며 일시중지할 수 없습니다. 실습 시작을 클릭하면 타이머가 시작됩니다. 이 타이머는 Google Cloud 리소스를 사용할 수 있는 시간이 얼마나 남았는지를 표시합니다.

실무형 실습을 통해 시뮬레이션이나 데모 환경이 아닌 실제 클라우드 환경에서 실습 활동을 진행할 수 있습니다. 실습 시간 동안 Google Cloud에 로그인하고 액세스하는 데 사용할 수 있는 새로운 임시 사용자 인증 정보가 제공됩니다.

이 실습을 완료하려면 다음을 준비해야 합니다.

• 표준 인터넷 브라우저 액세스 권한(Chrome 브라우저 권장)

참고: 이 실습을 실행하려면 시크릿 모드(권장) 또는 시크릿 브라우저 창을 사용하세요. 개인 계정과 학습자 계정 간의 충돌로 개인 계정에 추가 요금이 발생하는 일을 방지해 줍니다.

• 실습을 완료하기에 충분한 시간(실습을 시작하고 나면 일시중지할 수 없음)

참고: 이 실습에는 학습자 계정만 사용하세요. 다른 Google Cloud 계정을 사용하는 경우 해당 계정에 비용이 청구될 수 있습니다.

실습을 시작하고 Google Cloud 콘솔에 로그인하는 방법

1. 실습 시작 버튼을 클릭합니다. 실습 비용을 결제해야 하는 경우 결제 수단을 선택할 수 있는 대화상자가 열립니다. 왼쪽에는 다음과 같은 항목이 포함된 실습 세부정보 창이 있습니다.

   • Google Cloud 콘솔 열기 버튼
   • 남은 시간
   • 이 실습에 사용해야 하는 임시 사용자 인증 정보
   • 필요한 경우 실습 진행을 위한 기타 정보

2. Google Cloud 콘솔 열기를 클릭합니다(Chrome 브라우저를 실행 중인 경우 마우스 오른쪽 버튼으로 클릭하고 시크릿 창에서 링크 열기를 선택합니다).

   실습에서 리소스가 가동되면 다른 탭이 열리고 로그인 페이지가 표시됩니다.

   팁: 두 개의 탭을 각각 별도의 창으로 나란히 정렬하세요.

   참고: 계정 선택 대화상자가 표시되면 다른 계정 사용을 클릭합니다.

3. 필요한 경우 아래의 사용자 이름을 복사하여 로그인 대화상자에 붙여넣습니다.

   {{{user_0.username | "Username"}}}

   실습 세부정보 창에서도 사용자 이름을 확인할 수 있습니다.

4. 다음을 클릭합니다.

5. 아래의 비밀번호를 복사하여 시작하기 대화상자에 붙여넣습니다.

   {{{user_0.password | "Password"}}}

   실습 세부정보 창에서도 비밀번호를 확인할 수 있습니다.

6. 다음을 클릭합니다.

   중요: 실습에서 제공하는 사용자 인증 정보를 사용해야 합니다. Google Cloud 계정 사용자 인증 정보를 사용하지 마세요. 참고: 이 실습에 자신의 Google Cloud 계정을 사용하면 추가 요금이 발생할 수 있습니다.

7. 이후에 표시되는 페이지를 클릭하여 넘깁니다.

   • 이용약관에 동의합니다.
   • 임시 계정이므로 복구 옵션이나 2단계 인증을 추가하지 않습니다.
   • 무료 체험판을 신청하지 않습니다.

잠시 후 Google Cloud 콘솔이 이 탭에서 열립니다.

참고: Google Cloud 제품 및 서비스에 액세스하려면 탐색 메뉴를 클릭하거나 검색창에 제품 또는 서비스 이름을 입력합니다.

Cloud Shell 활성화

Cloud Shell은 다양한 개발 도구가 탑재된 가상 머신으로, 5GB의 영구 홈 디렉터리를 제공하며 Google Cloud에서 실행됩니다. Cloud Shell을 사용하면 명령줄을 통해 Google Cloud 리소스에 액세스할 수 있습니다.

1. Google Cloud 콘솔 상단에서 Cloud Shell 활성화 를 클릭합니다.

2. 다음 창을 클릭합니다.

   • Cloud Shell 정보 창을 통해 계속 진행합니다.
   • 사용자 인증 정보를 사용하여 Google Cloud API를 호출할 수 있도록 Cloud Shell을 승인합니다.

연결되면 사용자 인증이 이미 처리된 것이며 프로젝트가 학습자의 PROJECT_ID, (으)로 설정됩니다. 출력에 이 세션의 PROJECT_ID를 선언하는 줄이 포함됩니다.

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud는 Google Cloud의 명령줄 도구입니다. Cloud Shell에 사전 설치되어 있으며 명령줄 자동 완성을 지원합니다.

3. (선택사항) 다음 명령어를 사용하여 활성 계정 이름 목록을 표시할 수 있습니다.

gcloud auth list

4. 승인을 클릭합니다.

출력:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. (선택사항) 다음 명령어를 사용하여 프로젝트 ID 목록을 표시할 수 있습니다.

gcloud config list project

출력:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} 참고: gcloud 전체 문서는 Google Cloud에서 gcloud CLI 개요 가이드를 참고하세요.

Apigee 콘솔 열기

Apigee 콘솔을 열려면 다음 단계를 따르세요.

• Google Cloud 콘솔의 검색 창에 Apigee를 입력한 다음 검색 결과에서 Apigee API 관리를 클릭합니다.

Apigee 콘솔이 열리고 자주 사용되는 위치로 연결되는 빠른 링크가 방문 페이지에 표시됩니다.

• 탐색 메뉴()에서 Apigee 옆에 있는 즐겨찾기()를 클릭합니다.

이제 Apigee가 탐색 메뉴에 즐겨찾기로 추가됩니다.

작업 1. API 참고 리소스 살펴보기

이 작업에서는 Google API 탐색기를 사용하여 Apigee API 참고 리소스를 살펴봅니다.

1. 다음 Google API 탐색기 링크를 복사하여 Google Cloud 콘솔 브라우저 창의 새 탭에 붙여넣습니다. Apigee API용 Google API 탐색기

Apigee API는 조직을 프로그래매틱 방식으로 개발하고 관리하는 데 사용할 수 있습니다. Apigee API는 참고 리소스 페이지에서 바로 호출할 수 있습니다.

2. 오른쪽 창에서 v1.organizations.instances REST 리소스로 이동합니다.
3. v1.organizations.instances 섹션에서 list를 클릭합니다.

이 페이지에서는 Apigee API의 list instances 메서드를 설명합니다.

4. API 사용해 보기 창에서 상위 항목을 다음으로 설정합니다.

organizations/{{{ project_0.project_id | PROJECT }}}

5. 실행을 클릭합니다.

6. 창이 팝업되고 Google API 탐색기로 계속 진행할 계정을 선택하라는 메시지가 표시되면 실습 사용자 이름을 선택한 다음 허용을 클릭합니다.

API 응답이 다음과 같을 것입니다.

{ "instances": [ { "name": "eval-instance", "location": "{{{ project_0.default_zone | ZONE }}}", "host": "172.21.60.2", "port": "443", "state": "ACTIVE" } ] }

또는 다음과 같을 수도 있습니다.

{ "instances": [ { "name": "eval-instance", "location": "europe-west1", "createdAt": "1706780597609", "lastModifiedAt": "1706780670711", "state": "CREATING", "peeringCidrRange": "SLASH_22", "runtimeVersion": "1-11-0-apigee-14", "ipRange": "10.188.120.0/28" } ] }

인스턴스의 이름은 eval-instance입니다. 이 인스턴스에 대한 NAT IP 주소를 만들 것입니다.

7. API 사용해 보기 창의 오른쪽 상단에서 펼치기 를 클릭합니다.

펼쳐진 창에 요청에 해당하는 cURL, HTTP 요청, 그리고 이 요청을 수행하는 데 사용할 수 있는 JavaScript 코드 스니펫이 표시됩니다.

8. 펼쳐진 창을 닫으려면 되돌리기를 클릭합니다.

작업 2. 인스턴스 프로비저닝이 완료될 때까지 기다리기

이 작업에서는 Apigee 평가 조직 프로비저닝이 완료될 때까지 기다립니다.

Apigee 조직 프로비저닝이 완료되기까지 시간이 꽤 걸릴 수 있습니다. 조직 프로비저닝 진행 상황은 Apigee API를 사용하여 모니터링할 수 있습니다.

모니터링 스크립트 시작하기

1. Cloud 콘솔 탭으로 돌아갑니다.
2. 오른쪽 상단 툴바에서 Cloud Shell 활성화 버튼을 클릭합니다.

3. 메시지가 표시되면 계속을 클릭합니다.

Cloud Shell을 프로비저닝하고 연결하는 데 몇 분 정도 소요됩니다. 연결되면 사용자가 미리 인증되어 있고 프로젝트가 PROJECT_ID로 설정되어 있습니다.

4. Cloud Shell에서 다음 명령어를 사용하여 GOOGLE_CLOUD_PROJECT 변수에 프로젝트 이름이 들어 있는지 확인합니다.

echo ${GOOGLE_CLOUD_PROJECT}

GOOGLE_CLOUD_PROJECT 변수에 (Apigee 조직 이름과 동일한) 프로젝트 이름이 들어 있을 것입니다.

5. GOOGLE_CLOUD_PROJECT 변수가 설정되어 있지 않다면 다음 명령어에서 {project}를 프로젝트 이름으로 바꾸고 이를 사용하여 변수를 수동으로 설정합니다.

export GOOGLE_CLOUD_PROJECT={project} 참고: 이때 중괄호도 없애야 합니다.

6. 다음 명령어를 Cloud Shell에 붙여넣습니다.

export INSTANCE_NAME=eval-instance; export ENV_NAME=eval; if [ -z "${GOOGLE_CLOUD_PROJECT}" ]; then echo "Error: GOOGLE_CLOUD_PROJECT environment variable is not set. Please set it to your project ID."; else export PREV_INSTANCE_STATE=; echo "waiting for runtime instance ${INSTANCE_NAME} to be active"; while : ; do export INSTANCE_STATE=$(curl -s -H "Authorization: Bearer $(gcloud auth print-access-token)" -X GET "https://apigee.googleapis.com/v1/organizations/${GOOGLE_CLOUD_PROJECT}/instances/${INSTANCE_NAME}" | jq "select(.state != null) | .state" --raw-output); [[ "${INSTANCE_STATE}" == "${PREV_INSTANCE_STATE}" ]] || (echo; echo "INSTANCE_STATE=${INSTANCE_STATE}"); export PREV_INSTANCE_STATE=${INSTANCE_STATE}; [[ "${INSTANCE_STATE}" != "ACTIVE" ]] || break; echo -n "."; sleep 5; done; echo; echo "instance created, waiting for environment ${ENV_NAME} to be attached to instance"; while : ; do export ATTACHMENT_DONE=$(curl -s -H "Authorization: Bearer $(gcloud auth print-access-token)" -X GET "https://apigee.googleapis.com/v1/organizations/${GOOGLE_CLOUD_PROJECT}/instances/${INSTANCE_NAME}/attachments" | jq "select(.attachments != null) | .attachments[] | select(.environment == \"${ENV_NAME}\" or (.environment | endswith(\"/${ENV_NAME}\"))) | .environment" --raw-output); [[ -n "${ATTACHMENT_DONE}" ]] && break; echo -n "."; sleep 5; done; echo; echo "${ENV_NAME} environment attached"; echo "***ORG IS READY TO USE***"; fi

위 명령어는 Apigee API를 사용하여 런타임 인스턴스가 생성되고 eval 환경이 연결되었는지 확인합니다.

7. 인스턴스가 준비될 때까지 기다립니다.

***ORG IS READY TO USE*** 텍스트가 출력되면 인스턴스가 준비된 것입니다.

참고: 명령어에 조직을 사용할 준비가 되었다고 바로 표시될 경우 사용자가 실습을 시작하기 전에 실습이 미리 준비된 것일 수 있습니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 모니터링 스크립트를 실행하고 인스턴스 기다리기

작업 3. API 프록시를 만들고 배포하기

이 작업에서는 백엔드 서비스에 보이는 IP 주소를 테스트하는 API 프록시를 만듭니다.

1. Apigee 탐색 메뉴에서 프록시 개발 > API 프록시를 선택합니다.
2. 환경 선택 드롭다운에서 eval을 선택합니다.

참고: 드롭다운에서 eval 환경을 선택할 수 없는 경우 페이지를 새로고침하세요.

3. 프록시 마법사를 사용하여 새 프록시를 만들려면 + 만들기를 클릭합니다.
4. 프록시 템플릿에서 일반 템플릿 > 리버스 프록시(가장 일반적)를 선택합니다.

참고: OpenAPI 사양 템플릿 섹션에 있는 리버스 프록시(가장 일반적)를 선택하면 안 됩니다.

5. 다음 속성을 지정합니다.

   속성	값
   프록시 이름	test-nat
   기본 경로	/test-nat
   대상(기존 API)	https://httpbin.org/ip

지금 만들고 있는 것은 httpbin 요청 및 응답 서비스에 대한 API 프록시입니다. 이 서비스는 API를 테스트할 때 유용합니다.

요청이 프록시 서버를 통과하면 각 서버의 IP 주소가 X-Forwarded-For 헤더에 추가됩니다. httpbin.org /ip 엔드포인트는 X-Forwarded-For 헤더의 IP 주소와 httpbin.org 서버에 연결한 마지막 IP 주소를 반환합니다.

6. 다음을 클릭합니다.
7. 배포(선택사항) 설정은 기본값으로 두고 만들기를 클릭합니다.
8. 개요 탭에서 배포 상태에 버전 1이 평가 중이라고 표시될 때까지 기다립니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. API 프록시를 만들고 배포하기

작업 4. API 프록시 테스트하기

이 작업에서는 API 프록시를 호출하여 백엔드 서비스에 사용되는 인스턴스 IP 주소가 동적인지 확인합니다.

apigeex-test-vm이라는 가상 머신이 자동으로 생성되었습니다. 이 가상 머신을 사용하여 비공개 IP 주소를 통해 Apigee 런타임을 호출합니다.

Apigee 런타임 호출하기

1. Cloud Shell에서 VM에 대한 SSH 연결을 엽니다.

TEST_VM_ZONE=$(gcloud compute instances list --filter="name=('apigeex-test-vm')" --format "value(zone)") gcloud compute ssh apigeex-test-vm --zone=${TEST_VM_ZONE} --force-key-file-overwrite

2. 각 질문에 대해 Enter 키 또는 Return 키를 입력하여 기본 입력값을 지정합니다.

로그인되어 있는 ID가 프로젝트 소유자이므로 이 머신에 대한 SSH가 허용됩니다.

이제 Cloud Shell 세션이 VM 내에서 실행됩니다.

3. VM의 셸에서 필요한 셸 변수를 설정합니다.

export PROJECT_NAME=$(gcloud config get-value project) export ORG=${PROJECT_NAME} export INSTANCE_NAME=eval-instance export INTERNAL_LB_IP=$(curl -s -H "Authorization: Bearer $(gcloud auth print-access-token)" -X GET "https://apigee.googleapis.com/v1/organizations/${ORG}/instances/${INSTANCE_NAME}" | jq ".host" --raw-output) export EVAL_ENVGROUP_HOSTNAME=$(curl -s -H "Authorization: Bearer $(gcloud auth print-access-token)" -X GET "https://apigee.googleapis.com/v1/organizations/${ORG}/envgroups/eval-group" | jq ".hostnames[0]" --raw-output) echo "INTERNAL_LB_IP=${INTERNAL_LB_IP}" echo "EVAL_ENVGROUP_HOSTNAME=${EVAL_ENVGROUP_HOSTNAME}"

EVAL_ENVGROUP_HOSTNAME에는 eval-group 환경 그룹의 호스트 이름이 들어 있습니다. 이 호스트 이름의 DNS 항목이 자동으로 생성되었습니다. DNS 항목은 내부 부하 분산기의 비공개 IP 주소를 지정합니다.

참고: DNS 항목은 비공개 DNS 영역과 비공개 IP 주소를 사용합니다. 비공개 DNS 항목은 apigeex-vpc 네트워크 외부에서는 확인되지 않으며, 비공개 IP 주소는 apigeex-vpc 네트워크 외부의 Cloud Shell 또는 IP 주소에서 액세스할 수 없습니다.

4. eval 환경에 배포된 test-nat API 프록시를 호출합니다.

curl -k "https://${EVAL_ENVGROUP_HOSTNAME}/test-nat"

-k 옵션은 curl에 TLS 인증서 확인을 건너뛰라고 지시합니다. 내부 부하 분산기는 신뢰할 수 있는 인증 기관(CA)에서 생성한 인증서가 아닌 자체 서명 인증서를 사용하고 있습니다.

참고: 프로덕션 사용 사례에서는 인증서 확인을 우회하기 위해 -k 옵션을 사용하면 안 됩니다.

curl 명령어가 test-nat 프록시에서 생성된 응답을 반환합니다. 응답은 다음과 같을 것입니다.

{ "origin": "10.0.0.2,10.0.0.5,10.0.0.7, 34.83.164.141" }

origin 필드 응답에 여러 개의 IP 주소가 표시됩니다. 마지막 IP 주소는 httpbin.org 서버를 호출한 마지막 서버의 IP 주소입니다. 처음 3개의 IP 주소는 모두 내부 IP 주소로, 요청이 인스턴스에서 httpbin.org까지 이동하는 동안 거친 다른 홉들을 나타냅니다.

호출을 여러 번 반복해 보면 마지막 IP 주소가 매번 동일할 수 있습니다. 그러나 인스턴스에 NAT 주소를 추가하지 않는 한 마지막 IP 주소는 시간이 지남에 따라 변경될 수 있기 때문에 허용 목록에 추가하기가 어렵습니다.

작업 5. 인스턴스에 대한 NAT IP 만들기

이 작업에서는 런타임 인스턴스가 백엔드 서비스를 호출할 때 사용할 NAT IP를 만듭니다.

NAT IP는 Apigee 인스턴스에서 백엔드 서비스로 전송되는 호출에 예측 가능한 IP 주소를 제공하는 데 사용됩니다.

1. Apigee API 브라우저 탭으로 돌아갑니다.
2. 왼쪽 창에서 organizations.instances.natAddresses 섹션을 펼칩니다.
3. organizations.instances.natAddresses에서 create를 클릭합니다.

이 페이지에서는 Apigee API의 create NAT address 메서드를 설명합니다.

4. API 사용해 보기 창에서 상위 항목을 다음으로 설정합니다.

organizations/{{{ project_0.project_id | PROJECT }}}/instances/eval-instance

5. 요청 본문 매개변수 추가를 클릭한 다음 이름을 클릭합니다.
6. 큰따옴표 사이에 다음 문자열을 입력합니다.

eval-instance-ip

7. 실행을 클릭합니다.

창이 팝업되고 Google API 탐색기로 계속 진행할 계정을 선택하라는 메시지가 표시되면 실습 사용자 이름을 선택한 다음 허용을 클릭합니다.

API 응답이 다음과 같을 것입니다.

{ "name": "organizations/qwiklabs-gcp-01-f24706170325/operations/c79a19c8-ae9f-49de-978e-7f4873b06e51", "metadata": { "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata", "operationType": "INSERT", "targetResourceName": "organizations/qwiklabs-gcp-01-f24706170325/instances/eval-instance/natAddresses/eval-instance-ip", "state": "IN_PROGRESS" } }

작업은 비동기식이지만 빠르게 완료될 것입니다.

8. 왼쪽 창의 organizations.instances.natAddresses에서 get을 클릭합니다.

이 페이지에서는 Apigee API의 get NAT address 메서드를 설명합니다.

9. API 사용해 보기 창에서 상위 항목을 다음으로 설정합니다.

organizations/{{{ project_0.project_id | PROJECT }}}/instances/eval-instance/natAddresses/eval-instance-ip

10. 실행을 클릭합니다.

창이 팝업되고 Google API 탐색기로 계속 진행할 계정을 선택하라는 메시지가 표시되면 실습 사용자를 선택한 다음 허용을 클릭합니다.

API 응답이 다음과 같을 것입니다.

{ "name": "eval-instance-ip", "ipAddress": "104.198.6.224", "state": "RESERVED" }

NAT 주소가 예약되었으나 아직 활성화되지 않았습니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 인스턴스에 대한 NAT IP 만들기

작업 6. NAT IP 활성화하기

이 작업에서는 이전 작업에서 만든 NAT IP를 활성화합니다.

1. organizations.instances.natAddresses에서 activate를 클릭합니다.

이 페이지에서는 Apigee API의 activate NAT address 메서드를 설명합니다.

2. API 사용해 보기 창에서 상위 항목을 다음으로 설정합니다.

organizations/{{{ project_0.project_id | PROJECT }}}/instances/eval-instance/natAddresses/eval-instance-ip

3. 실행을 클릭합니다.

창이 팝업되고 Google API 탐색기로 계속 진행할 계정을 선택하라는 메시지가 표시되면 실습 사용자를 선택한 다음 허용을 클릭합니다.

API 응답이 다음과 같을 것입니다.

{ "name": "organizations/qwiklabs-gcp-01-f24706170325/operations/4b96ee01-55a5-4824-859a-04c2e034d1d4", "metadata": { "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata", "operationType": "INSERT", "targetResourceName": "organizations/qwiklabs-gcp-01-f24706170325/instances/eval-instance/natAddresses/eval-instance-ip", "state": "IN_PROGRESS" } }

작업은 비동기식이지만 빠르게 완료될 것입니다.

4. 왼쪽 창의 organizations.instances.natAddresses에서 get을 클릭합니다.

이 페이지에서는 Apigee API의 get NAT address 메서드를 설명합니다.

5. API 사용해 보기 창에서 상위 항목을 다음으로 설정합니다.

organizations/{{{ project_0.project_id | PROJECT }}}/instances/eval-instance/natAddresses/eval-instance-ip

6. 실행을 클릭합니다.
7. 창이 팝업되고 Google API 탐색기로 계속 진행할 계정을 선택하라는 메시지가 표시되면 실습 사용자 이름을 선택한 다음 허용을 클릭합니다.

API 응답이 다음과 같을 것입니다.

{ "name": "eval-instance-ip", "ipAddress": "104.198.6.224", "state": "ACTIVE" } 참고: NAT IP의 상태가 여전히 RESERVED라면 활성화가 완료되고 ACTIVE 상태가 반환될 때까지 '실행'을 계속 클릭하세요.

이제 NAT 주소가 활성화되었습니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. NAT IP 활성화하기

작업 7. NAT 주소 테스트하기

이 작업에서는 API 프록시를 호출하여 백엔드 서비스에 대한 호출에 이 NAT 주소가 사용되는지 확인합니다.

Apigee 런타임 호출하기

1. Cloud Shell에서, VM에 대한 SSH 연결이 끊어진 경우 VM에 대한 새 SSH 연결을 엽니다.

TEST_VM_ZONE=$(gcloud compute instances list --filter="name=('apigeex-test-vm')" --format "value(zone)") gcloud compute ssh apigeex-test-vm --zone=${TEST_VM_ZONE} --force-key-file-overwrite

2. 필요한 경우 각 질문에 대해 Enter 키 또는 Return 키를 입력하여 기본 입력값을 지정합니다.

이제 Cloud Shell 세션이 VM 내에서 실행됩니다.

3. VM의 셸에서 필요한 셸 변수를 설정합니다.

export PROJECT_NAME=$(gcloud config get-value project) export ORG=${PROJECT_NAME} export INSTANCE_NAME=eval-instance export NAT_ADDR_NAME=eval-instance-ip export INTERNAL_LB_IP=$(curl -s -H "Authorization: Bearer $(gcloud auth print-access-token)" -X GET "https://apigee.googleapis.com/v1/organizations/${ORG}/instances/${INSTANCE_NAME}" | jq ".host" --raw-output) export EVAL_ENVGROUP_HOSTNAME=$(curl -s -H "Authorization: Bearer $(gcloud auth print-access-token)" -X GET "https://apigee.googleapis.com/v1/organizations/${ORG}/envgroups/eval-group" | jq ".hostnames[0]" --raw-output) export NAT_IP_ADDRESS=$(curl -s -H "Authorization: Bearer $(gcloud auth print-access-token)" -X GET "https://apigee.googleapis.com/v1/organizations/${ORG}/instances/${INSTANCE_NAME}/natAddresses/${NAT_ADDR_NAME}" | jq ".ipAddress" --raw-output) echo "INTERNAL_LB_IP=${INTERNAL_LB_IP}" echo "EVAL_ENVGROUP_HOSTNAME=${EVAL_ENVGROUP_HOSTNAME}" echo "NAT_IP_ADDRESS=${NAT_IP_ADDRESS}"

NAT_IP_ADDRESS 값을 기록해 둡니다.

NAT_IP_ADDRESS는 이제 런타임 인스턴스가 백엔드 서비스를 호출할 때 사용하는 NAT 공개 IP 주소입니다. 백엔드 서비스는 이 알려진 IP 주소를 허용 목록에 추가할 수 있습니다.

참고: DNS 항목은 비공개 DNS 영역과 비공개 IP 주소를 사용합니다. 비공개 DNS 항목은 apigeex-vpc 네트워크 외부에서는 확인되지 않으며, 비공개 IP 주소는 apigeex-vpc 네트워크 외부의 Cloud Shell 또는 IP 주소에서 액세스할 수 없습니다.

4. eval 환경에 배포된 test-nat API 프록시를 호출합니다.

curl -k "https://${EVAL_ENVGROUP_HOSTNAME}/test-nat"

-k 옵션은 curl에 TLS 인증서 확인을 건너뛰라고 지시합니다. 내부 부하 분산기는 신뢰할 수 있는 인증 기관(CA)에서 생성한 인증서가 아닌 자체 서명 인증서를 사용하고 있습니다.

참고: 프로덕션 사용 사례에서는 인증서 확인을 우회하기 위해 -k 옵션을 사용하면 안 됩니다.

curl 명령어가 test-nat 프록시에서 생성된 응답을 반환합니다. 응답은 다음과 같을 것입니다.

{ "origin": "10.0.0.2,10.0.0.5,10.0.0.6, 104.198.6.224" }

origin 필드에 여전히 여러 개의 IP 주소가 표시됩니다. 마지막 IP 주소는 런타임 인스턴스 전용 NAT 주소입니다.

5. 다음 명령어를 사용하여 Apigee API로 NAT 주소를 가져와서 NAT IP 주소가 일치하는지 확인합니다.

curl -s -H "Authorization: Bearer $(gcloud auth print-access-token)" -X GET "https://apigee.googleapis.com/v1/organizations/${ORG}/instances/${INSTANCE_NAME}/natAddresses/${NAT_ADDR_NAME}"

수고하셨습니다

API 참고 리소스에서 Apigee API를 호출하는 방법을 배웠습니다. Apigee API를 사용하여 런타임 인스턴스에 대한 NAT IP 주소를 만들고 활성화했습니다. httpbin IP 주소 서비스를 호출하는 API 프록시를 만들었습니다. 마지막으로, 백엔드에 보이는 IP 주소가 구성된 NAT IP 주소인지 확인했습니다.

다음 단계/더 학습하기

• Google API 탐색기
• NAT IP 프로비저닝

Google Cloud 교육 및 자격증

Google Cloud 기술을 최대한 활용하는 데 도움이 됩니다. Google 강의에는 빠른 습득과 지속적인 학습을 지원하는 기술적인 지식과 권장사항이 포함되어 있습니다. 기초에서 고급까지 수준별 학습을 제공하며 바쁜 일정에 알맞은 주문형, 실시간, 가상 옵션이 포함되어 있습니다. 인증은 Google Cloud 기술에 대한 역량과 전문성을 검증하고 입증하는 데 도움이 됩니다.

설명서 최종 업데이트: 2025년 1월 29일

실습 최종 테스트: 2025년 1월 29일

Copyright 2026 Google LLC. All rights reserved. Google 및 Google 로고는 Google LLC의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표일 수 있습니다.