Phần này trình bày nhiều 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 cho đám mây riêng tư.
Để biết thông tin 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 kết hợp tất cả các thành phần khác trong một
bản cài đặt tại chỗ của Edge Private Cloud. Bạn có thể kiểm tra trạng thái của người dùng, tổ chức và hoạt động 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/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 bước này không thành công, hãy làm như sau:
- Kiểm tra nhật ký máy chủ 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. - Thực hiện lệnh gọi đến Máy chủ quản lý để kiểm tra xem máy chủ 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 restart
Giới thiệu về cách sử dụng tệp cấu hình
Các lệnh dưới đây 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.
Để xem tệp cấu hình hoàn chỉnh 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 Đăng ký 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à proxy API được hiển thị, và theo đó, URL mà các ứng dụng dùng để truy cập vào 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 bằng giao thức HTTPS đã mã hoá.
Sử dụng các tập lệnh và lệnh gọi API dưới đây để tạo máy chủ ả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ủ lưu trữ ảo mà bạn dùng để tham chiếu đến máy chủ lưu trữ đó 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ủ lưu trữ của máy chủ lưu trữ ảo. Thường là tên DNS của máy chủ ảo.
Bộ định tuyến biên 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ủ để xác định proxy API xử lý yêu cầu. Khi đưa ra yêu cầu thông qua một máy chủ lưu trữ ảo, hãy chỉ định 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ữ 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ì việc 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 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 lựa chọn khi bạn không có mục DNS cho máy chủ ảo
Một lựa chọn khi bạn không có mục 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 theo biểu mẫu bên dưới:
curl http://routerIP:9001/proxy-base-path/resource-path
Bạn nên chọn phương á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 Bộ định tuyến, hãy thêm một bí danh máy chủ lưu trữ cho mỗi Bộ định tuyến, chỉ định địa chỉ IP của mỗi Bộ đị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ủ 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 DNS:
curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path