Edge for Private Cloud v. 4.17.09
Phần này trình bày nhiều thao tác 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 một lượt cài đặt Apigee Edge cho Private Cloud.
Để biết thông tin giới thiệu về tổ chức, môi trường và máy chủ lưu trữ ả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ủ lưu trữ ảo.
Kiểm tra trạng thái 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 kết hợp tất cả các thành phần khác trong quá trình cài đặt trên máy của Edge Private Cloud. Bạn có thể kiểm tra trạng thái người dùng, tổ chức và triển khai trên Máy chủ quản lý bằng cách đưa ra các lệnh CURL 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/<orgname>/deployments
Hệ thống sẽ hiển thị trạng thái HTTP 200 cho tất cả các lệnh gọi. Nếu các cách này không hiệu quả, hãy làm như sau:
- Kiểm tra nhật ký của Máy chủ quản lý tại /opt/apigee/var/log/apigee/management-server để xem có lỗi nào không.
- Gọi đến Máy chủ quản lý để kiểm tra xem máy chủ này có 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 khởi động lại
Giới thiệu về cách sử dụng tệp cấu hình
Các lệnh bên dưới lấy tệp cấu hình làm dữ liệu đầu vào. Ví dụ: bạn truyền một tệp cấu hình đến lệnh setup-org để xác định tất cả các thuộc tính của tổ chức, bao gồm cả môi trường và máy chủ ảo.
Để biết tệp cấu hình đầy đủ và thông tin về các thuộc tính mà bạn có thể đặt trong tệp cấu hình, hãy xem phần Giới thiệu về 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 Trình định tuyến Edge mà proxy API hiển thị, đồng thời mở rộng URL mà ứng dụng sử dụng để truy cập proxy API. Máy chủ ảo cũng xác định xem bạn truy cập vào proxy API 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 hiển thị bên dưới để tạo máy chủ lưu trữ ảo. Khi tạo máy chủ ảo, bạn phải chỉ định những 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 proxy API.
- Cổng trên Bộ định tuyến dành 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 cổng cho mỗi máy chủ ảo mới.
- Bí danh máy chủ 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 máy chủ trong quá trình xác định proxy API xử lý yêu cầu. Khi đưa ra yêu cầu thông qua máy chủ lưu trữ ảo, hãy chỉ định tên miền khớp với bí danh máy chủ của máy chủ lưu trữ ảo hoặc chỉ định địa chỉ IP của Bộ định tuyến và tiêu đề Máy chủ lưu trữ chứa bí danh 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ì yêu cầu cURL đến API thông qua máy chủ ảo đó có thể sử dụng một trong các biểu mẫu sau:
- Nếu bạn có mục nhập 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 nhập DNS cho myapis.apigee.net:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: myapis.apigee.net'
Trong biểu mẫu thứ hai, bạn chỉ định địa chỉ IP của Bộ định tuyến và truyền bí danh máy chủ trong tiêu đề máy chủ.
Lưu ý: Lệnh curl, hầu hết trình duyệt và nhiều tiện ích khác sẽ tự động thêm tiêu đề máy chủ lưu trữ vào miền trong yêu cầu, vì vậy, bạn có thể sử dụng lệnh curl ở dạng:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}
Các tuỳ chọn khi bạn không có mục nhập DNS cho máy chủ ảo
Khi không có mục nhập DNS, bạn có thể đặt bí danh máy chủ lưu trữ 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
Khi bạn tạo một lệnh curl ở dạng bên dưới:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}
Tuỳ chọn này được ưa dùng vì hoạt động tốt với giao diện người dùng Edge.
Nếu bạn có nhiều Trình định tuyến, hãy thêm bí danh máy chủ lưu trữ cho mỗi Trình định tuyến, chỉ định địa chỉ IP của từng Trình định tuyến và cổng của máy chủ lưu trữ ảo.
Ngoài ra, bạn có thể đặt bí danh 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 trên 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 máy chủ 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ột mục nhập DNS:
curl -v http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}