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

Để tham gia một tổ chức, bạn phải tạo một tệp cấu hình tham gia rồi chuyển tệp đó vào lệnh setup-org. Từng bước được mô tả trong các phần tiếp theo.

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

Tạo tệp cấu hình tham gia

Phần này bao gồm một tệp cấu hình mẫu để thiết lập ban đầu cho một tổ chức có setup-org.

Sao chép ví dụ sau và chỉnh sửa nếu cần cho 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 ý rằng:

• Đố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 bí danh máy chủ và cổng (không bắt buộc), ví dụ: "myapi.example.com". Nếu chưa có bản ghi DNS, 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 Thiết lập máy chủ ảo.

• Để biết 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 một API 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 bài viết Định cấu hình quyền truy cập TLS vào một API cho đám mây riêng tư.
• Bạn không thể tạo hai tổ chức có cùng tên. Trong trường hợp đó, lần tạo thứ hai sẽ không thành công.

Thực thi setup-org

Sau khi tạo tệp cấu hình tham gia, bạn sẽ chuyển tệp đó đến tập lệnh setup-org để thực hiện quy trình tham gia. Bạn phải chạy tập lệnh trên nút Máy chủ quản lý.

Khi 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ột máy chủ ả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 tổ chức.
  • Quản trị viên tổ chức không được là quản trị viên hệ thống.
• Liên kết tổ chức với nhóm "cổng". (Đây là chế độ mặc định và không thể thay đổi.)
• Liên kết môi trường với tất cả Bộ xử lý thông báo.
• Bật tính năng phân tích.

Cách thực thi setup-org:

1. 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

2. 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 tệp cấu hình tham gia:

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

   Người dùng "apigee" phải đọc được tệp cấu hình.

3. Xác minh rằng bạn đã hoàn tất quy trình làm quen cho một tổ chức. Một cách để thực hiện việc này là đăng nhập 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 giao diện người dùng Edge.

   Để biết các bước xác minh khác, hãy xem phần Xác minh quy trình làm quen.

4. Tạo proxy đầu tiên!

Xác minh quy trình làm quen

Sau khi hoàn tất quy trình làm quen, hãy xác minh trạng thái của hệ thống bằng cách đưa ra các lệnh curl sau đây trên nút Máy chủ quản lý:

1. 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 lệnh sau:

   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. 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

3. Kiểm tra trạng thái cơ sở dữ liệu PostgreSQL bằng cách thực thi các lệnh sau trên Nút 2 (như trong cấu trúc liên kết 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 của bạn:

   \d analytics."org_name.env_name.fact"

   Sử dụng lệnh sau để thoát psql:

   \q

4. 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 lại 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 bạn muốn dùng rồi nhập URL của giao diện người dùng Edge. Nó có dạng tương tự như sau, trong đó địa chỉ IP là của Nút 1 (như trong cấu trúc liên kết 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

   2. Trên trang đăng nhập của 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.
5. Đă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 của bảng điều khiển, hãy nhấp vào nút Sign In (Đăng nhập).

   Trình duyệt chuyển hướng đến http://192.168.56.111:9000/platform/#/org_name/ và mở một 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 đăng nhập bằng thông tin đăng nhập của quản trị viên Apigee).

Tạo proxy đầu tiên

Sau khi đã làm quen với một tổ chức mới và xác minh rằng quy trình làm quen đã thành công, giờ đây, 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:

• Danh sách đoạn nhạc
• API RESTful mục tiêu mô phỏng mà bạn có thể sử dụng trong các thử nghiệm xây dựng API của riêng mình