조직 온보딩

Private Cloud용 Edge v. 4.17.01

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

온보딩 프로세스의 일부로 스크립트는 다음을 수행합니다.

  • 조직을 만듭니다.
  • 지정된 사용자를 조직 관리자로 설정합니다.
    • 이 사용자는 시스템 관리자와 달라야 합니다. 즉, 시스템 관리자를 조직 관리자로 사용하지 마세요.
    • 조직 관리자의 기존 사용자를 지정하거나 새 사용자를 만들도록 스크립트를 구성할 수 있습니다.
  • 조직을 포드와 연결하며, 기본적으로 조직을 '게이트웨이' 포드와 연결합니다.
  • 환경을 만드세요.
  • 환경의 가상 호스트를 만듭니다.
  • 환경을 모든 메시지 프로세서와 연결합니다.
  • 분석을 사용 설정합니다.

온보딩을 위한 구성 파일

구성 파일을 setup-org 명령어에 전달합니다. setup-org 명령어를 호출하고 자동 구성 파일의 경로를 포함하여 -f 옵션을 지정합니다.

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

자동 설치의 유일한 요구사항은 'apigee' 사용자가 구성 파일에 액세스하거나 읽을 수 있어야 한다는 것입니다.

다음은 자동 구성 파일의 예입니다. 필요에 따라 다음과 같이 수정합니다.

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=adminPassword     # 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
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

# 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 주소를 사용할 수 있습니다.

    가상 호스트를 구성하는 방법에 관한 자세한 내용은 Edge 데모 설치 요구사항을 참고하세요.
  • TLS/SSL 구성의 경우 JAR 파일 만들기와 TLS/SSL 구성의 다른 측면에 대한 자세한 내용은 키 저장소 및 트러스트 저장소Private Cloud용 API에 대한 TLS 액세스 구성을 참조하세요.

온보딩 절차

  1. 관리 서버 노드에 apigee-provision을 설치합니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. 관리 서버 노드에서 명령어를 실행합니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    이 구성 파일은 'apigee' 사용자가 액세스하거나 읽을 수 있어야 합니다.

온보딩 인증

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

  1. 다음 CURL 명령어를 실행하여 관리 서버에서 사용자 및 조직 상태를 확인합니다.
    > curl -u <adminEmail>:<admin Passwd> http://localhost:8080/v1/users
    > curl -u <adminEmail>:<admin Passwd> http://localhost:8080/v1/organizations :u > <admin_name 8080/v1/organizationw:u >
  2. 분석을 사용 설정한 경우 다음 명령어를 사용합니다.
    > curl -u <adminEmail>:<admin Passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provision/axstatus
  3. 머신 2에서 다음 명령어를 실행하여 psql을 시작하여 PostgreSQL 데이터베이스 상태를 확인할 수도 있습니다.
    > psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee


    명령어 프롬프트에서 다음 명령어를 입력하여 조직의 분석 테이블을 확인합니다.
    \apigee=# apigee: \d analytics.
    \apigee=# factname > analytics."
  4. 웹브라우저를 사용하여 Apigee Edge 사용자 인터페이스에 액세스합니다. 설치가 끝날 때 이미 관리 콘솔 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

      참고: 포트 9000이 열려 있는지 확인하세요.
    2. 콘솔 로그인 페이지에서 Apigee 시스템 관리자의 사용자 이름/비밀번호를 지정합니다.
      참고: 설치 중에 설정한 전역 시스템 관리자 비밀번호입니다. 또는 다음 방법을 이용할 수도 있습니다.
  5. 새 Apigee 사용자 계정에 가입하고 새 사용자 인증 정보를 사용하여 로그인합니다.
    1. 로그인을 클릭하면 브라우저가 다음으로 리디렉션됩니다.
      http://192.168.56.111:9000/platform/#/<orgname>/

      대시보드가 열리고 이전에 만든 조직을 구성할 수 있는 대시보드가 열립니다 (Apigee 관리자 인증 정보를 사용하여 로그인한 경우).
    2. Edge를 처음 사용하는 경우 이제 첫 번째 API 프록시를 만들 수 있습니다. 자세한 내용은 첫 번째 API 프록시 빌드를 참고하세요.

      또한 샘플 목록을 포함한 샘플 섹션과 자체 API 빌드 실험에서 사용할 수 있는 모의 대상 RESTful API(모의 대상 API)도 참고하세요.