Trang này được dịch bởi Cloud Translation API.

Giới thiệu một tổ chức

Để tham gia một tổ chức, bạn phải tạo tệp cấu hình cho người mới tham gia rồi truyền tệp đó vào lệnh setup-org. Mỗi bước trong số này được mô tả trong phần theo dõi.

Để biết thông tin về cách sử dụng API quản lý để tham gia một tổ chức, hãy xem Tạo một tổ chức, và máy chủ ảo.

Tạo tệp cấu hình cho quy trình làm quen

Phần này bao gồm một tệp cấu hình mẫu để hướng dẫn ban đầu cho một tổ chức sử dụng setup-org.

Hãy sao chép ví dụ sau và chỉnh sửa nếu cần đối với tổ chức của bạn:

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.

Lưu ý:

Đối với VHOST_ALIAS, nếu bạn đã có bản ghi DNS mà bạn sẽ dùng để truy cập vào máy chủ ảo, hãy chỉ định máy chủ lưu trữ biệt hiệu và cổng không bắt buộc, ví dụ: "myapi.example.com". Nếu bạn chưa có DNS bản ghi, bạn có thể sử dụng địa chỉ IP của Bộ định tuyến.

Để biết thêm thông tin về cách định cấu hình máy chủ ảo, hãy xem phần Cài đặt thiết lập một máy chủ ảo.
Đối với cấu hình TLS/SSL, hãy xem phần Kho khoá và Kho tin cậy và Định cấu hình Quyền truy cập TLS vào API dành cho Đám mây riêng tư để biết thêm thông tin về cách tạo tệp JAR, và các khía cạnh khác của việc định cấu hình TLS/SSL.
Để biết thêm thông tin về cách định cấu hình máy chủ ảo, hãy xem Định cấu hình quyền truy cập TLS cho một API dành cho Đám mây riêng tư.
Bạn không thể tạo hai tổ chức có cùng một tên. Trong trường hợp đó, lần tạo thứ hai sẽ không thành công.

Thực thi tổ chức thiết lập

Sau khi tạo tệp cấu hình giới thiệu, bạn truyền tệp đó vào setup-org tập lệnh để thực hiện quy trình giới thiệu. Bạn phải chạy tập lệnh trên Máy chủ quản lý nút.

Khi bắt đầu tham gia một tổ chức, tập lệnh setup-org sẽ thực hiện những việc sau:

Tạo một tổ chức mới.
Tạo một môi trường.
Tạo máy chủ lưu trữ ảo cho môi trường.
Đặt người dùng được chỉ định làm quản trị viên tổ chức. Lưu ý:
- Bạn có thể sử dụng người dùng hiện có hoặc tạo người dùng mới cho quản trị viên của tổ chức.
- Quản trị viên tổ chức không được giống với quản trị viên hệ thống.
Liên kết tổ chức với "cổng vào" nhóm. (Đây là tuỳ chọn mặc định và không thể changed.)
Liên kết môi trường với tất cả(các) Trình xử lý thư.
Bật tính năng phân tích.

Cách thực thi setup-org:

Cài đặt apigee-provision trên nút Máy chủ quản lý:

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

Chạy tập lệnh setup-org trên nút Máy chủ quản lý và trỏ tập lệnh đó vào tệp cấu hình mà bạn đã tạo trong phần Tạo cấu hình giới thiệu tệp:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
```
Tệp cấu hình phải có thể đọc được bằng API "api" người dùng.
Xác minh rằng bạn đã tham gia thành công một tổ chức. Một cách để thực hiện việc này là ghi nhật ký vào giao diện người dùng bằng cách yêu cầu URL sau trong trình duyệt:
```
http://IP_address:9000/login
```
Trong đó IP_address là địa chỉ IP của máy chủ mà bạn đã cài đặt Edge Giao diện người dùng.

Để biết các bước xác minh khác, hãy xem bài viết Xác minh quy trình tham gia.
Tạo proxy đầu tiên!

Xác minh quy trình tham gia

Sau khi hoàn tất quy trình tham gia, hãy xác minh trạng thái của hệ thống bằng cách cấp những thông tin sau Các lệnh curl trên nút Máy chủ quản lý:

Kiểm tra trạng thái của người dùng và tổ chức trên Máy chủ quản lý bằng cách thực thi các thao tác sau các lệnh:

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

Kiểm tra số liệu phân tích bằng cách thực thi lệnh sau:

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

Kiểm tra trạng thái của cơ sở dữ liệu PostgreSQL bằng cách thực thi các lệnh sau trên Nút 2 (như được hiển thị trong lời xin lỗi về việc cài đặt):
```
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
```
Tại dấu nhắc lệnh, hãy nhập lệnh sau để xem bảng phân tích cho tổ chức:
```
\d analytics."org_name.env_name.fact"
```
Sử dụng lệnh sau để thoát khỏi psql:
```
\q
```
Truy cập vào giao diện người dùng Apigee Edge bằng trình duyệt web. Hãy nhớ rằng bạn đã ghi chú URL của bảng điều khiển quản lý ở cuối quá trình cài đặt.
1. Chạy trình duyệt mà bạn muốn sử dụng rồi nhập URL của giao diện người dùng Edge. Ứng dụng này trông giống với tiếp theo, trong đó địa chỉ IP là dành cho Nút 1 (như trong xin lỗi về việc cài đặt) hoặc bất kỳ nút nào mà bạn đã cài đặt giao diện người dùng cho các cấu hình thay thế:
```
http://192.168.56.111:9000/login
```
  9000 là số cổng mà giao diện người dùng sử dụng.
  
  Nếu đang khởi động trình duyệt ngay trên máy chủ lưu trữ giao diện người dùng Edge, thì bạn có thể sử dụng URL ở dạng:
```
http://localhost:9000/login
```
  Lưu ý: Đảm bảo rằng cổng 9000 đang mở. Nếu bạn bằng một dịch vụ như Google Cloud Engine, thì bạn có thể cần phải sửa đổi các quy tắc về tường lửa để để bạn có thể dùng các dịch vụ Apigee thông qua trình duyệt.
2. Trên trang đăng nhập bảng điều khiển, hãy chỉ định tên người dùng/mật khẩu của quản trị viên hệ thống Apigee.
  Lưu ý: Đây là quản trị viên hệ thống chung mà bạn đã đặt trong quá trình cài đặt.
Đăng ký một tài khoản người dùng Apigee mới và sử dụng thông tin đăng nhập của người dùng mới đó để đăng nhập. Trên trang đăng nhập bảng điều khiển, nhấp vào nút Đăng nhập.

Trình duyệt chuyển hướng đến http://192.168.56.111:9000/platform/#/org_name/ và mở trang tổng quan cho phép bạn định cấu hình tổ chức mà bạn đã tạo (nếu bạn đã ghi nhật ký khi sử dụng thông tin đăng nhập của quản trị viên Apigee).

Tạo proxy đầu tiên của bạn

Sau khi bạn tham gia một tổ chức mới và xác minh rằng quy trình tham gia thành công, giờ bạn có thể tạo proxy đầu tiên. Để biết thêm thông tin, hãy xem bài viết Tạo proxy API đầu tiên.

Các tài nguyên khác mà bạn có thể thấy hữu ích bao gồm: