Phần này trình bày các hoạt động quản trị, chẳng hạn như tạo, quản lý và xoá các tổ chức, môi trường và máy chủ ảo Apigee trong quá trình cài đặt Apigee Edge để cài đặt đám mây riêng tư.
Để biết giới thiệu về tổ chức, môi trường và máy chủ ảo, hãy xem bài viết Giới thiệu về hành tinh, khu vực, nhóm, tổ chức, môi trường và máy chủ ảo.
Kiểm tra trạng thái của người dùng, tổ chức và môi trường
Máy chủ quản lý đóng vai trò quan trọng trong việc liên kết tất cả thành phần khác trong quá trình cài đặt Đám mây riêng tư của Edge tại cơ sở. Bạn có thể kiểm tra trạng thái của người dùng, tổ chức và quá trình triển khai trên Máy chủ quản lý bằng cách phát các lệnh curl sau:
curl -u adminEmail:admin_passwd http://localhost:8080/v1/userscurl -u adminEmail:admin_passwd http://localhost:8080/v1/organizationscurl -u adminEmail;:admin_passwd http://localhost:8080/v1/organizations/orgname/deployments
Hệ thống phải hiển thị trạng thái HTTP 200 cho tất cả lệnh gọi. Nếu những trường hợp này không thành công, hãy làm như sau:
- Hãy kiểm tra nhật ký Máy chủ quản lý tại
/opt/apigee/var/log/apigee/management-serverđể xem có lỗi nào không. - Thực hiện lệnh gọi với Máy chủ quản lý để kiểm tra xem máy chủ có đang hoạt động đúng cách hay không.
- Xoá máy chủ khỏi ELB rồi khởi động lại Máy chủ quản lý:
/opt/apigee/bin/apigee-service management-server restart
Giới thiệu về cách sử dụng tệp cấu hình
Các lệnh hiển thị bên dưới sẽ lấy tệp cấu hình làm dữ liệu đầu vào. Ví dụ: bạn truyền tệp cấu hình đến lệnh setup-org để xác định tất cả thuộc tính của tổ chức, bao gồm cả môi trường và máy chủ ảo.
Để có tệp cấu hình đầy đủ và thông tin về các thuộc tính mà bạn có thể thiết lập trong tệp cấu hình, hãy xem phần Giới thiệu một tổ chức.
Giới thiệu về cách thiết lập máy chủ ảo
Máy chủ ảo trên Edge xác định các miền và cổng Bộ định tuyến Edge mà trên đó proxy API hiển thị, và theo tiện ích là URL mà các ứng dụng dùng để truy cập proxy API. Máy chủ ảo cũng xác định xem proxy API được truy cập bằng giao thức HTTP hay giao thức HTTPS đã mã hoá.
Sử dụng các tập lệnh và lệnh gọi API được hiển thị bên dưới để tạo máy chủ ảo. Khi tạo máy chủ ảo, bạn phải chỉ định thông tin sau:
- Tên của máy chủ ảo mà bạn dùng để tham chiếu đến máy chủ đó trong các proxy API của mình.
- Cổng trên Bộ định tuyến cho máy chủ ảo. Thông thường, các cổng này bắt đầu từ 9001 và tăng thêm một lần đối với mỗi máy chủ ảo mới.
- Bí danh máy chủ lưu trữ của máy chủ ảo. Thường là tên DNS của máy chủ ảo.
Bộ định tuyến cạnh so sánh tiêu đề Máy chủ của yêu cầu đến với danh sách bí danh của máy chủ trong quá trình xác định proxy API xử lý yêu cầu. Khi gửi yêu cầu thông qua một máy chủ ảo, hãy chỉ định một tên miền khớp với bí danh của máy chủ ảo hoặc chỉ định địa chỉ IP của Bộ định tuyến và tiêu đề của Máy chủ lưu trữ chứa bí danh của máy chủ.
Ví dụ: nếu bạn đã tạo một máy chủ ảo có bí danh máy chủ là myapis.apigee.net trên cổng 9001, thì hãy thực thi yêu cầu curl tới một API thông qua máy chủ ảo đó, có thể dùng một trong các biểu mẫu sau:
- Nếu bạn có mục DNS cho myapis.apigee.net:
curl http://myapis.apigee.net:9001/proxy-base-path/resource-path
- Nếu bạn không có mục DNS cho myapis.apigee.net, hãy làm như sau:
curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'
Ở dạng thứ hai, bạn chỉ định địa chỉ IP của Bộ định tuyến và truyền bí danh của máy chủ lưu trữ trong tiêu đề Host (Máy chủ).
Các tuỳ chọn khi bạn không có mục nhập DNS cho máy chủ ảo
Khi bạn không có mục nhập DNS, một lựa chọn là đặt bí danh của máy chủ thành địa chỉ IP của Bộ định tuyến và cổng của máy chủ ảo, dưới dạng routerIP:port. Ví dụ:
192.168.1.31:9001
Sau đó, bạn thực hiện lệnh curl trong biểu mẫu bên dưới:
curl http://routerIP:9001/proxy-base-path/resource-path
Tuỳ chọn này được ưu tiên vì hoạt động hiệu quả với giao diện người dùng Edge.
Nếu bạn có nhiều Bộ định tuyến, hãy thêm bí danh của máy chủ cho mỗi Bộ định tuyến, chỉ định địa chỉ IP của từng Bộ định tuyến và cổng của máy chủ ảo.
Ngoài ra, bạn có thể đặt bí danh của máy chủ lưu trữ thành một giá trị, chẳng hạn như temp.hostalias.com. Sau đó, bạn phải truyền tiêu đề Host vào mọi yêu cầu:
curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'Host: temp.hostalias.com'
Hoặc thêm bí danh của máy chủ lưu trữ vào tệp /etc/hosts. Ví dụ: thêm dòng này vào /etc/hosts:
192.168.1.31 temp.hostalias.com
Sau đó, bạn có thể gửi yêu cầu như thể bạn có mục nhập DNS:
curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path