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ý để tham gia 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 quy trình giới thiệu

Phần này bao gồm một tệp cấu hình mẫu để tích hợp 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:

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

Lưu ý rằng:

  • Đối với VHOST_ALIAS, nếu bạn đã có một 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ó thể là cổng, 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 thông tin về cấu hình TLS/SSL, hãy xem phần Keystore và Truststore cũng như Định cấu hình quyền truy cập TLS vào API cho Đám mây riêng để 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 phần Định cấu hình quyền truy cập TLS vào một API cho Đám mây riêng.
  • 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 trù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à 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 Edge mới bằng cách yêu cầu URL sau trong trình duyệt: 
    http://IP_address:3001

    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 New 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 thiết lập ban đầu, 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 Edge mới 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 mới. 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 Edge mới cho các cấu hình thay thế: 
      http://192.168.56.111:3001

      3001 là số cổng mặc định mà Giao diện người dùng Edge mới 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 New Edge, thì bạn có thể sử dụng một URL có dạng: 

      http://localhost:3001
    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 quản trị viên 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 đăng nhập 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:3001/edge 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: