7단계: Apigee 환경에 배포

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

VS Code에서 Apigee를 사용해 로컬 개발 및 테스트를 완료하고 나면 API를 Apigee 환경에 보관 파일로 배포할 수 있습니다. 이 단계에서는 보관 파일 배포를 지원하는 Apigee 환경을 만들고 API 프록시 구성 보관 파일을 Apigee 환경에 배포합니다.

시작하기 전에: Apigee에서 gcloud를 사용하여 시작하기의 설명대로 Google Cloud SDK와 gcloud beta apigee 구성요소를 설치합니다.

환경 만들기의 단계에 따라 다음을 수행합니다.
1. Apigee 조직에서 새 개발 환경을 만들고 아카이브를 배포 유형으로 사용 설정합니다. UI 또는 API를 사용합니다.
  예를 들면 다음과 같습니다.
2. Instances Attachments API를 사용하여 런타임 인스턴스에 환경을 연결합니다.
  이 명령어는 장기 실행 작업을 트리거합니다. 계속하기 전에 환경이 런타임에 연결되었는지 확인하세요.
3. 환경 그룹이 아직 없는 경우 Create environment groups API를 사용하여 환경 그룹을 만듭니다.
  계속하기 전에 환경 그룹이 생성되었는지 확인합니다. 다음과 같은 요청을 사용하여 새 그룹의 상태를 확인할 수 있습니다.
```
curl -i -H "$AUTH" -H "Content-Type:application/json" \
  "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/environments/ENVIRONMENT_NAME"
```
4. Environment group attachment API를 사용하여 새 환경을 환경 그룹에 연결합니다.
  환경을 그룹에 연결하면 그룹의 호스트 이름을 통해 해당 환경의 프록시가 라우팅됩니다. 이는 완료하는 데 몇 분 정도 걸릴 수 있는 장기 실행 작업을 트리거합니다. 다음 단계로 계속하기 전에 1~2분 정도 기다리는 것이 좋습니다. 그 동안 이전과 마찬가지로 작업 상태를 확인해도 좋습니다.
Apigee 환경에 API 프록시 구성 보관 파일을 배포합니다.
1. Apigee VS 코드의 터미널 탭에서 myapigeeworkspace 디렉터리로 이동합니다.
```
cd myapigeeworkspace
```
  ls를 실행하면 디렉터리에 src 폴더가 포함됩니다.
2. 다음 명령어를 실행합니다.
```
gcloud beta apigee archives deploy --environment=dev --labels=release=052021
```
  다음은 응답의 예시입니다.
```
Using Apigee organization dev
Waiting for operation [b64c2665-b5ac-43cc-9e2d-232e8895c2ed] to complete...done
```
터미널 탭에서 다음 명령어를 실행하여 API를 테스트합니다.
```
curl https://INTERNAL_LOAD_BALANCER_IP/helloworld /
  -H "Host: ENV_GROUP_HOSTNAME" 
```
이 예시의 변수와 API 액세스 설정 방법에 대한 자세한 내용은 샘플 프록시 배포를 참조하세요.

다음과 같은 오류 메시지가 표시됩니다.
```
{"fault":{"faultstring":"Failed to resolve API Key variable request.queryparam.apikey",
  "detail":{"errorcode":"steps.oauth.v2.FailedToResolveAPIKey"}}}
```
helloworld API를 포함하는 API 제품을 만든 후 API 제품을 사용해 개발자를 만들고 등록해야 API 키를 가져올 수 있습니다.

API 키 가져오기

Apigee UI를 사용하여 API 제품을 만듭니다.

게시 > API 제품을 선택합니다.
+ 만들기를 클릭합니다.
API 제품의 제품 세부정보를 입력합니다.

입력란에 다음 정보를 입력합니다.

입력란	설정
`Name:`	myproduct
`Display name:`	myproduct
`Environment:`	개발
`Access:`	공개
`Quota:`	비워 두기
`Allowed OAuth scope:`	비워 두기

작업 섹션에서 + 작업 추가를 클릭합니다.
소스 아래의 API 프록시 드롭다운 메뉴에서 helloworld를 선택합니다.
작업 아래의 경로 필드에 /를 입력합니다.
다른 필드는 기본값 그대로 둡니다.
저장을 클릭하여 작업을 저장합니다.
저장을 클릭하여 API 제품을 저장합니다.

조직의 개발자를 만듭니다.

탐색 메뉴에서 게시 > 개발자를 선택합니다.
+ Developer를 클릭합니다.

입력란에 다음 정보를 입력합니다.

입력란	설정
`First Name:`	Alex
`Last Name:`	Hamilton
`Username:`	ahamilton
`Email:`	ahamilton@example.com

만들기를 클릭합니다.

앱 등록

Publish > Apps를 선택합니다.
+앱을 클릭합니다.

입력란에 다음 정보를 입력합니다.

입력란	설정
`Name:`	myapp
`Display name:`	myapp
`Developer:`	ahamilton@example.com
`Callback URL:`	비워 두기
`Notes:`	비워 두기
`Expiry:`	삭제 안함
`Product:`	제품 추가를 클릭합니다. myproduct를 선택합니다. Add(추가)를 클릭합니다.
`Custom attributes:`	비워 두기

API 키를 복사합니다.
1. 앱 페이지(게시 > 앱)에서 myapp을 클릭합니다.
2. myapp 페이지의 사용자 인증 정보 섹션에서 키 옆에 있는 표시를 클릭합니다. API 키는 생성한 API 제품과 연결되어 있습니다.
3. API 키를 선택하여 복사합니다.

다음과 같이 apikey 쿼리 매개변수를 사용하여 API 키를 전달하는 curl 호출을 다시 실행합니다.

curl -v https://$PUBLIC_FACING_IP/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY

다음 응답이 반환됩니다.

{
  "root": {
    "city": "San Jose",
    "firstName": "John",
    "lastName": "Doe",
    "state": "CA"
  }
}

수고하셨습니다. API 보관 파일이 Apigee 환경에 성공적으로 배포되었습니다.

다음 단계에서는 API 보관 파일을 Apigee 프로덕션 환경으로 승격합니다.

1 2 3 4 5 6 7 (다음) 8단계: 보관 파일을 프로덕션으로 승격