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

Edge for Private Cloud v4.19.01

Để giới thiệu cho một tổ chức, bạn phải tạo một tệp cấu hình giới thiệu, sau đó chuyển tệp đó vào lệnh setup-org. Mỗi bước được mô tả cụ thể trong các phần tiếp theo.

Để biết thông tin về cách sử dụng API quản lý để tham gia vào một tổ chức, hãy xem phần Tạo tổ chức, môi trường 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 để giới thiệu một tổ chức bằng 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ẽ 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 về cách định cấu hình máy chủ ảo, hãy xem bài viết Thiết lập 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 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ủ lưu trữ ảo, hãy xem phần Định cấu hình quyền truy cập TLS vào API cho đám mây riêng.
• Bạn không thể tạo hai tổ chức có cùng một tên. Trong trường hợp đó, lệnh 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 giới thiệu, bạn sẽ truyền tệp đó vào tập lệnh setup-org để thực hiện quy trình giới thiệu. Bạn phải chạy tập lệnh trên nút Máy chủ quản lý.

Khi giới thiệu 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 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 nhóm "cổng". (Đây là giá trị mặc định và không thể thay đổi.)
• Liên kết môi trường với tất cả(các) Trình 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 đó đến tệp cấu hình mà bạn đã tạo trong phần Tạo tệp cấu hình giới thiệu:

   /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 đã giới thiệu thành công một tổ chức. 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 đây trên một 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 thêm các bước xác minh, hãy xem bài viết 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 trên nút Máy chủ quản lý:

1. Kiểm tra trạng thái 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 hình 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 khỏi 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ý khi hoàn tất 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. Tệp này có dạng tương tự như sau, trong đó địa chỉ IP là dành cho Nút 1 (như trong cấu trú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 trực tiếp 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 vào bảng điều khiển, hãy chỉ định tên người dùng/mật khẩu quản trị hệ thống Apigee.
5. Đăng ký tài khoản người dùng Apigee mới và sử dụng thông tin xác thực người dùng mới để đăng nhập. Trên trang đăng nhập vào bảng điều khiển, hãy nhấp vào nút Đăng nhập.

   Trình duyệt sẽ 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 quản trị viên Apigee).

Tạo proxy đầu tiên

Sau khi giới thiệu một tổ chức mới và xác minh rằng quy trình giới thiệu đã thành công, 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 mẫu
• API RESTful mục tiêu mô phỏng mà bạn có thể sử dụng trong các thử nghiệm tạo API của riêng mình