Edge cho Private Cloud phiên bản 4.17.05
Dùng lệnh setup-org để thực hiện quy trình tham gia. Bạn phải chạy lệnh trên nút Máy chủ quản lý.
Trong quá trình thiết lập ban đầu, tập lệnh:
- Tạo tổ chức.
- Đặt người dùng được chỉ định làm quản trị viên tổ chức.
- Người dùng này phải khác với người dùng quản trị viên hệ thống. Tức là không sử dụng quản trị viên hệ thống người dùng với tư cách là người dùng quản trị viên của tổ chức.
- Bạn có thể chỉ định người dùng hiện có cho quản trị viên tổ chức hoặc định cấu hình tập lệnh để tạo người dùng mới.
- Liên kết tổ chức với một nhóm, theo mặc định, tổ chức đó sẽ liên kết với "kênh" nhóm.
- Tạo môi trường.
- Tạo máy chủ ảo cho môi trường.
- 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.
Tệp cấu hình để giới thiệu
Truyền tệp cấu hình vào lệnh setup-org. Gọi lệnh setup-org rồi chỉ định tuỳ chọn -f, bao gồm đường dẫn đến tệp cấu hình ẩn:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
Yêu cầu duy nhất đối với việc cài đặt dưới nền chương trình là tệp cấu hình phải có thể truy cập được hoặc có thể đọc được bằng API người dùng.
Dưới đây là ví dụ về một tệp cấu hình ở chế độ im lặng. Hãy chỉnh sửa nếu cần các yêu cầu:
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=adminPassword # 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 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 # 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 không
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 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à Truststores và Định cấu hình quyền truy cập TLS vào một 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 đị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ư.
Quy trình tham gia
- Cài đặt apigee-provision trên
nút Máy chủ quản lý:
> /opt/apigee/apigee-service/bin/apigee-service apigee- đãi cài đặt - Chạy lệnh trên nút Máy chủ quản lý:
> /opt/apigee/apigee-service/bin/apigee-service apigee-and_cung cấp cho setup-org -f configFile
Tệp cấu hình phải truy cập được hoặc có thể đọc được bằng API người dùng.
Xác minh việc giới thiệu
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 phát hành CURL sau đây 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 đưa ra những thông tin sau
Các lệnh CURL:
> cuộn tròn <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/<orgname>/deployments - Nếu bạn đã bật tính năng phân tích, hãy dùng lệnh sau:
> cuộn tròn <adminEmail>:<admin Passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provisioning/axstatus - Bạn cũng có thể kiểm tra trạng thái của cơ sở dữ liệu PostgreSQL bằng cách chạy lệnh sau trên
Máy 2 bắt đầu psql:
> 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:
apigee=# : \d analytics."<orgname>.prod.fact"
Sử dụng lệnh sau để thoát khỏi psql:
apigee=# \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 bảng điều khiển quản lý ở cuối quá trình cài đặt.
- 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à của Máy 1 hoặc cho bất kỳ máy nào bạn đã cài đặt
giao diện người dùng bật đối với 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 bạn 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
Lưu ý: Hãy đảm bảo rằng cổng 9000 đang mở. - 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à mật khẩu quản trị viên hệ thống chung mà bạn đã đặt trong quá trình cài đặt. Ngoài ra, bạn có thể:
- 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à của Máy 1 hoặc cho bất kỳ máy nào bạn đã cài đặt
giao diện người dùng bật đối với các cấu hình thay thế:
- Đă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.
- Nhấp vào Đăng nhập, trình duyệt sẽ chuyển hướng đến:
http://192.168.56.111:9000/platform/#/<orgname>/
và mở một trang tổng quan cho phép bạn định cấu hình tổ chức đã tạo trước đó (nếu đã đăng nhập bằng thông tin đăng nhập của quản trị viên Apigee). - Nếu mới sử dụng Edge, bạn hiện có thể tạo proxy API đầu tiên. Để biết thêm thông tin,
hãy xem bài viết Tạo proxy API đầu tiên.
Ngoài ra, hãy xem các phần về mẫu, bao gồm Danh sách mẫu và mục tiêu mô phỏng Các API RESTful mà bạn có thể sử dụng trong thử nghiệm xây dựng API của riêng mình tại Mock Target API (API Mục tiêu mô phỏng).
- Nhấp vào Đăng nhập, trình duyệt sẽ chuyển hướng đến: