Edge for Private Cloud v4.19.01
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.
Để tìm hiể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
Management Server đóng vai trò quan trọng trong việc tập hợp tất cả các thành phần khác với nhau trong quá trình cài đặt Edge Private Cloud tại chỗ. Bạn có thể kiểm tra trạng thái của người dùng, tổ chức và triển khai trên Máy chủ quản lý bằng cách phát hành 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 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ý Máy chủ quản lý tại
/opt/apigee/var/log/apigee/management-serverđể xem có lỗi nào không. - Hãy thực hiện lệnh gọi với Management Server (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 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 sử dụng để tham chiếu máy chủ đó trong proxy API.
- 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 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ủ lưu trữ ả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 gửi yêu cầu qua một máy chủ ảo, hãy chỉ định một tên miền khớp với bí danh máy chủ lưu trữ của một 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ữ có chứa bí danh máy chủ lưu trữ.
Ví dụ: nếu bạn đã tạo một máy chủ lưu trữ ả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 đến một API thông qua máy chủ lưu trữ ảo đó có thể sử dụng một trong các biểu mẫu sau:
- Nếu bạn có một 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 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ủ.
Các tuỳ chọn khi bạn không có mục nhập DNS cho máy chủ ảo
Một lựa chọn khi bạn không có mục nhập DNS là đặt bí danh 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 tạo một lệnh curl ở dạng bên dưới:
curl http://routerIP:9001/proxy-base-path/resource-path
Bạn nên chọn tuỳ chọn này vì nó 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'
Bạn cũng có thể 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