Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

조직 온보딩

조직을 온보딩하려면 온보딩 구성 파일을 만든 후 setup-org 명령어에 전달해야 합니다. 각 단계는 다음 섹션에 설명되어 있습니다.

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

온보딩 구성 파일 만들기

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

다음 예시를 복사하고 조직에 맞게 수정합니다.

# Specify the IP or DNS name of the Management Server.
IP1=MANAGEMENT_SERVER_IP_ADDRESS

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 구성에 대한 자세한 내용은 키 저장소 및 신뢰 저장소와 프라이빗 클라우드용 API에 대한 TLS 액세스 구성을 참조하세요. 여기에는 JAR 파일 생성 및 TLS/SSL 구성의 기타 측면에 대한 정보가 포함되어 있습니다.
가상 호스트 구성에 대한 자세한 내용은 프라이빗 클라우드용 API에 대한 TLS 액세스 구성을 참조하세요.
이름이 같은 두 조직을 만들 수는 없습니다. 이 경우 두 번째 만들기가 실패합니다.

setup-org 실행

온보딩 구성 파일을 만든 후 온보딩 프로세스를 실행하기 위해 setup-org 스크립트에 전달합니다. 관리 서버 노드에서 스크립트를 실행해야 합니다.

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

새 조직을 만듭니다.
환경을 만듭니다.
환경의 가상 호스트를 만듭니다.
지정된 사용자를 조직 관리자로 설정합니다. 다음 사항에 유의하세요.
- 기존 사용자를 사용하거나 조직 관리자를 위한 새 사용자를 만들 수 있습니다.
- 조직 관리자는 시스템 관리자와 동일해서는 안 됩니다.
조직을 '게이트웨이' 포드와 연결합니다. (이것은 기본값이며 변경할 수 없습니다.)
환경을 모든 메시지 프로세서와 연결합니다.
분석을 사용 설정합니다.

setup-org를 실행하려면 다음 단계를 따르세요.

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

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

관리 서버 노드에서 setup-org 스크립트를 실행하고 온보딩 구성 파일 만들기에 만든 구성 파일을 가리킵니다.
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
```
구성 파일은 'apigee' 사용자가 읽을 수 있어야 합니다.
조직을 성공적으로 온보딩했는지 확인합니다. 한 가지 방법은 브라우저에서 다음 URL을 요청하여 새 Edge UI에 로그인하는 것입니다.
```
http://IP_address:3001
```
여기서 IP_address는 새 Edge UI를 설치한 서버의 IP 주소입니다.

추가 확인 단계는 온보딩 확인을 참조하세요.
첫 번째 프록시를 만듭니다.

온보딩 확인

온보딩이 완료되면 관리 서버 노드에서 다음 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/org_name/deployments

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

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

설치 토폴로지에 표시된 대로 노드 2 에서 다음 명령어를 실행하여 PostgreSQL 데이터베이스 상태를 확인합니다.
```
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
```
명령어 프롬프트에서 다음 명령어를 입력하여 조직의 분석 표를 확인합니다.
```
\d analytics."org_name.env_name.fact"
```
다음 명령어를 사용하여 psql을 종료합니다.
```
\q
```
웹브라우저를 사용하여 새 Edge UI에 액세스합니다. 설치 끝에 관리 콘솔 URL을 이미 기록해 두었습니다.
1. 선호하는 브라우저를 실행하고 새 Edge UI의 URL을 입력합니다. 다음과 비슷한 모양입니다. 여기서 IP 주소는 노드 1 (설치 토폴로지에 표시됨) 또는 대체 구성을 위해 새 Edge UI를 설치한 노드의 IP 주소입니다.
```
http://192.168.56.111:3001
```
  3001은 새 Edge UI에서 사용하는 기본 포트 번호입니다.
  
  새 Edge UI를 호스팅하는 서버에서 직접 브라우저를 시작하는 경우 다음 형식의 URL을 사용할 수 있습니다.
```
http://localhost:3001
```
  참고: 포트 3001이 열려 있는지 확인합니다. Compute Engine과 같은 서비스를 사용하는 경우 브라우저를 사용하여 Apigee 서비스에 액세스할 수 있도록 방화벽 규칙을 수정해야 할 수 있습니다.
2. 콘솔 로그인 페이지에서 Apigee 시스템 관리자 사용자 이름/비밀번호를 지정합니다.
  참고: 설치 중에 설정한 전역 시스템 관리자 비밀번호입니다.
새 Apigee 사용자 계정에 가입하고 새 사용자 인증 정보를 사용하여 로그인합니다. 콘솔 로그인 페이지에서 로그인 버튼을 클릭합니다.
브라우저가 http://192.168.56.111:3001/edge 로 리디렉션되고 Apigee 관리자 인증 정보를 사용하여 로그인한 경우 만든 조직을 구성할 수 있는 대시보드가 열립니다.

첫 번째 프록시 만들기

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

다음과 같은 다른 리소스도 유용할 수 있습니다.

샘플 목록
자체 API 빌드 실험에서 사용할 수 있는 모의 대상 RESTful API