조직 온보딩

Private Cloud용 Edge v4.18.05

setup-org 스크립트를 사용하여 온보딩 프로세스를 실행합니다. 관리 서버 노드에서 스크립트를 실행해야 합니다.

조직을 온보딩하려면 다음 단계를 따르세요.

1. 관리 서버 노드에 apigee-provision를 설치합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-provision install

2. 관리 서버 노드에서 setup-org 스크립트를 실행합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

   구성 파일은 'apigee' 사용자가 읽을 수 있어야 합니다. 구성 파일의 예는 온보딩 구성 파일을 참고하세요.

3. 조직 온보딩이 완료되었는지 확인합니다. 이를 수행하는 한 가지 방법은 브라우저에서 다음 URL을 요청하여 UI에 로그인하는 것입니다.

   http://IP_address:9000/login

   여기서 IP_address는 Edge UI를 설치한 서버의 IP 주소입니다.

   추가 인증 단계는 온보딩 확인하기를 참고하세요.

4. 첫 번째 프록시를 만듭니다.

온보딩 구성 파일

setup-org 스크립트로 자동 구성을 실행하려면 다음 예와 같이 -f 옵션과 함께 구성 파일을 전달합니다.

/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

이 섹션에는 setup-org를 사용하여 조직을 온보딩하기 위한 샘플 구성 파일이 포함되어 있습니다.

조직을 온보딩할 때 setup-org 스크립트는 다음을 실행합니다.

• 새 조직을 만듭니다.
• 환경을 만듭니다.
• 환경의 가상 호스트를 만듭니다.
• 지정된 사용자를 조직 관리자로 설정합니다. 참고:
  • 조직 관리자를 위해 기존 사용자를 사용하거나 새 사용자를 만들 수 있습니다.
  • 조직 관리자는 시스템 관리자와 동일하지 않아야 합니다.
• 조직을 '게이트웨이' 포드와 연결합니다. (기본값이며 변경할 수 없습니다.)
• 환경을 모든 메시지 프로세서와 연결합니다.
• 분석을 사용 설정합니다.

다음 예시를 복사하여 필요에 따라 수정하여 조직을 온보딩합니다.

IP1=192.168.1.1

# Specify the IP or DNS name of the Management Server.
MSIP="$IP1"

# Specify the Edge sys admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=admin_password  # If omitted, you are prompted for it.

# Specify organization name.
ORG_NAME=myorg  # lowercase only, no spaces, underscores, or periods.

# Specify the organization administrator user.
# Either specify an existing user, or specify the information
# necessary to create a new user.
# Do not use the sys admin as the organization administrator.
#
# Create a new user for the organization administrator.
NEW_USER="y"
# New user information if NEW_USER="y".
USER_NAME=new@user.com
FIRST_NAME=new
LAST_NAME=user
# Org admin password must be at least 8 characters long and contain one uppercase
# letter, one lowercase letter, and one digit or special character
USER_PWD="newUserPword"
ORG_ADMIN=new@user.com
#
# Or, specify an existing user as the organization admin,
# omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD.
# NEW_USER="n"
# ORG_ADMIN=existing@user.com

# Specify environment name.
ENV_NAME=prod  # lowercase only

# Specify virtual host information.
VHOST_PORT=9001
VHOST_NAME=default

# If you have a DNS entry for the virtual host.
VHOST_ALIAS=myorg-test.apigee.net

# If you do not have a DNS entry for the virtual host,
# specify the IP and port of each router as a space-separated list:
# VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001"

# Optionally configure TLS/SSL for virtual host.
# VHOST_SSL=y     # Set to "y" to enable TLS/SSL on the virtual host.
# KEYSTORE_JAR=   # JAR file containing the cert and private key.
# KEYSTORE_NAME=  # Name of the keystore.
# KEYSTORE_ALIAS= # The key alias.
# KEY_PASSWORD=   # The key password, if it has one.

# Specify the analytics group.
# AXGROUP=axgroup-001 # Default name is axgroup-001.

참고:

• VHOST_ALIAS의 경우 가상 호스트에 액세스하는 데 사용할 DNS 레코드가 이미 있는 경우 호스트 별칭과 선택적으로 포트를 지정합니다(예: 'myapi.example.com'). 아직 DNS 레코드가 없는 경우 라우터의 IP 주소를 사용할 수 있습니다.
  

  가상 호스트를 구성하는 방법에 관한 자세한 내용은 가상 호스트 설정을 참고하세요.

• TLS/SSL 구성의 경우 JAR 파일 만들기 및 TLS/SSL 구성의 기타 측면에 관한 자세한 내용은 키 저장소 및 신뢰 저장소 및 프라이빗 클라우드용 API에 대한 TLS 액세스 구성을 참고하세요.
• 가상 호스트 구성에 대한 자세한 내용은 Private Cloud용 API에 대한 TLS 액세스 구성을 참조하세요.
• 동일한 이름으로 두 개의 조직을 만들 수 없습니다. 이 경우 두 번째 생성이 실패합니다.

관리 API를 사용하여 조직을 온보딩하는 방법에 관한 자세한 내용은 조직, 환경, 가상 호스트 만들기를 참고하세요.

온보딩 확인

온보딩이 완료되면 관리 서버 노드에서 다음 CURL 명령어를 실행하여 시스템 상태를 확인합니다.

1. 다음 명령어를 실행하여 관리 서버에서 사용자 및 조직 상태를 확인합니다.

   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/org_name/deployments

2. 다음 명령어를 실행하여 분석을 확인합니다.

   curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus

3. 설치 토폴로지에 표시된 대로 노드 2에서 다음 명령어를 실행하여 PostgreSQL 데이터베이스 상태를 확인합니다.

   psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

   명령 프롬프트에서 다음 명령어를 입력하여 조직의 분석 표를 봅니다.

   \d analytics."org_name.env_name.fact"

   다음 명령어를 사용하여 psql을 종료합니다.

   \q

4. 웹브라우저를 사용하여 Apigee Edge UI에 액세스합니다. 설치가 완료될 때 이미 관리 콘솔 URL을 확인했음을 기억하세요.
   1. 원하는 브라우저를 실행하고 Edge UI의 URL을 입력합니다. 다음과 유사합니다. 여기서 IP 주소는 노드 1 (설치 토폴로지 참고) 또는 대체 구성을 위해 UI를 설치한 노드의 IP 주소입니다.

      http://192.168.56.111:9000/login

      9000은 UI에서 사용하는 포트 번호입니다.

      Edge UI를 호스팅하는 서버에서 브라우저를 직접 시작하는 경우 다음 형식의 URL을 사용할 수 있습니다.

      http://localhost:9000/login

   2. 콘솔 로그인 페이지에서 Apigee 시스템 관리자 사용자 이름/비밀번호를 지정합니다.
5. 새 Apigee 사용자 계정에 가입하고 새 사용자 인증 정보를 사용하여 로그인합니다. 콘솔 로그인 페이지에서 로그인 버튼을 클릭합니다.

   브라우저가 http://192.168.56.111:9000/platform/#/org_name/로 리디렉션되고 생성한 조직을 구성할 수 있는 대시보드가 열립니다 (Apigee 관리자 사용자 인증 정보를 사용하여 로그인한 경우).

첫 번째 프록시 만들기

새 조직을 온보딩하고 온보딩 프로세스가 성공했는지 확인한 후 이제 첫 번째 프록시를 만들 수 있습니다. 자세한 내용은 첫 번째 API 프록시 빌드를 참고하세요.

다음과 같은 리소스도 참고해 보시기 바랍니다.

• 샘플 목록
• 자체 API 빌드 실험에 사용할 수 있는 모의 타겟 RESTful API