Edge for Private Cloud v4.18.05
Sử dụng tập lệnh setup-org
để thực hiện quy trình làm quen. Bạn phải chạy tập lệnh trên nút Máy chủ quản lý.
Cách giới thiệu cho một tổ chức:
- 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ý:/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. Để biết ví dụ về tệp cấu hình, hãy xem phần Tệp cấu hình giới thiệu.
- 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.
- Tạo proxy đầu tiên!
Tệp cấu hình giới thiệu
Để thực hiện cấu hình ngầm bằng tập lệnh setup-org
, hãy truyền tệp cấu hình bằng tuỳ chọn -f
, như trong ví dụ sau:
/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
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
.
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 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.
Sao chép ví dụ sau và chỉnh sửa nếu cần để giới thiệu 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 ý:
- Đố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 để 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 nội dung Đị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ệnh tạo thứ hai sẽ không thành công.
Để biết thêm thông tin về cách sử dụng API quản lý để giới thiệu một tổ chức, hãy xem phần Tạo tổ chức, môi trường và máy chủ ảo.
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ý:
- 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
- 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ơ sở dữ liệu PostgreSQL bằng cách thực thi các lệnh sau trên Nút 2 (như hiển thị trong cấu trú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 của bạn:
\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 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.
- 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
- 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.
- 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ế:
- Đă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.
Sau đây là một số tài nguyên khác có thể hữu ích cho bạn: