조직 및 환경 유지보수

Private Cloud용 Edge v4.19.01

이 섹션에서는 프라이빗 클라우드용 Apigee Edge 설치에서 Apigee 조직, 환경, 가상 호스트를 생성, 관리, 삭제하는 등 다양한 관리 작업을 설명합니다.

조직, 환경, 가상 호스트에 관한 소개는 플래닛, 리전, 포드, 조직, 환경, 가상 호스트 정보를 참고하세요.

사용자, 조직, 환경 상태 확인

관리 서버는 Edge Private Cloud의 온프레미스 설치에서 다른 모든 구성요소를 함께 유지하는 데 중요한 역할을 합니다. 다음 curl 명령어를 실행하여 관리 서버에서 사용자, 조직, 배포 상태를 확인할 수 있습니다.

curl -u adminEmail:admin_passwd http://localhost:8080/v1/users
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations
curl -u adminEmail;:admin_passwd http://localhost:8080/v1/organizations/orgname/deployments

시스템은 모든 호출에 200 HTTP 상태를 표시해야 합니다. 이 방법이 실패하면 다음을 수행합니다.

  1. /opt/apigee/var/log/apigee/management-server의 관리 서버 로그에서 오류가 있는지 확인합니다.
  2. 관리 서버를 호출하여 제대로 작동하는지 확인합니다.
  3. ELB에서 서버를 삭제한 후 관리 서버를 다시 시작합니다. 
    /opt/apigee/bin/apigee-service management-server restart

구성 파일 사용 정보

아래에 표시된 명령어는 구성 파일을 입력으로 사용합니다. 예를 들어 구성 파일을 setup-org 명령어에 전달하여 환경 및 가상 호스트를 비롯한 조직의 모든 속성을 정의합니다.

전체 구성 파일과 구성 파일에서 설정할 수 있는 속성에 대한 정보는 조직 온보딩을 참조하세요.

가상 호스트 설정 정보

Edge의 가상 호스트는 API 프록시가 노출되는 도메인과 Edge 라우터 포트를 정의하고 더 나아가 앱에서 API 프록시에 액세스하는 데 사용하는 URL을 정의합니다. 또한 가상 호스트는 API 프록시에 액세스할 때 HTTP 프로토콜을 사용하거나 암호화된 HTTPS 프로토콜을 사용하여 액세스할지 여부를 정의합니다.

아래에 표시된 스크립트와 API 호출을 사용하여 가상 호스트를 만듭니다. 가상 호스트를 만들 때 다음 정보를 지정해야 합니다.

  • API 프록시에서 가상 호스트를 참조하는 데 사용하는 가상 호스트의 이름입니다.
  • 가상 호스트의 라우터에 있는 포트입니다. 일반적으로 이러한 포트는 9001에서 시작하여 새 가상 호스트마다 1씩 증가합니다.
  • 가상 호스트의 호스트 별칭입니다. 일반적으로 가상 호스트의 DNS 이름입니다.

    Edge 라우터는 요청을 처리하는 API 프록시를 결정하는 과정에서 수신 요청의 호스트 헤더를 호스트 별칭 목록과 비교합니다. 가상 호스트를 통해 요청할 때 가상 호스트의 호스트 별칭과 일치하는 도메인 이름을 지정하거나 라우터의 IP 주소와 호스트 별칭이 포함된 호스트 헤더를 지정합니다.

예를 들어 포트 9001에서 호스트 별칭이 myapis.apigee.net인 가상 호스트를 만든 경우, 해당 가상 호스트를 통해 API에 대해 curl 요청을 실행하면 다음 형식 중 하나를 사용할 수 있습니다.

  • myapis.apigee.net의 DNS 항목이 있는 경우: 
    curl http://myapis.apigee.net:9001/proxy-base-path/resource-path
  • myapis.apigee.net에 대한 DNS 항목이 없는 경우: 
    curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'

    두 번째 양식에서는 라우터의 IP 주소를 지정하고 호스트 헤더에 호스트 별칭을 전달합니다.

가상 호스트의 DNS 항목이 없는 경우의 옵션

DNS 항목이 없는 경우 호스트 별칭을 라우터의 IP 주소 및 가상 호스트의 포트(routerIP:port)로 설정하는 방법이 있습니다. 예를 들면 다음과 같습니다.

192.168.1.31:9001

그런 다음 아래 형식으로 curl 명령어를 만듭니다.

curl http://routerIP:9001/proxy-base-path/resource-path

이 옵션은 Edge UI에서 잘 작동하므로 선호됩니다.

라우터가 여러 개인 경우 각 라우터의 IP 주소와 가상 호스트의 포트를 지정하여 각 라우터의 호스트 별칭을 추가합니다.

또는 호스트 별칭을 temp.hostalias.com과 같은 값으로 설정할 수 있습니다. 그런 다음 모든 요청에서 Host 헤더를 전달해야 합니다.

curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'Host: temp.hostalias.com'

또는 /etc/hosts 파일에 호스트 별칭을 추가합니다. 예를 들어 /etc/hosts에 다음 줄을 추가합니다.

192.168.1.31   temp.hostalias.com

그런 다음 DNS 항목이 있는 것처럼 요청을 수행할 수 있습니다.

curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path