Edge cho Private Cloud phiên bản 4.17.05
Để định cấu hình Edge sau khi cài đặt, bạn hãy sử dụng kết hợp các tệp .properties và các tiện ích của Edge. Cho ví dụ: để định cấu hình TLS/SSL trên giao diện người dùng Edge, bạn hãy chỉnh sửa các tệp .properties để đặt các giá trị cần thiết các thuộc tính. Các thay đổi đối với tệp .properties yêu cầu bạn phải khởi động lại thành phần Edge bị ảnh hưởng.
Apigee dùng để chỉ kỹ thuật chỉnh sửa tệp .properties dưới dạng mã có config. Về cơ bản, mã có cấu hình là một công cụ tra cứu khoá/giá trị dựa trên các chế độ cài đặt trong tệp .properties. Trong mã với config, các khoá này được gọi là mã thông báo. Do đó, để định cấu hình Edge, bạn đặt mã thông báo trong tệp .properties.
Mã có cấu hình cho phép các thành phần Edge đặt các giá trị mặc định được vận chuyển cùng với sản phẩm, hãy cho phép nhóm cài đặt ghi đè các cài đặt đó dựa trên cấu trúc liên kết cài đặt, rồi cho phép khách hàng ghi đè mọi tài sản mà họ chọn.
Nếu bạn coi đây là một hệ thống phân cấp, thì cài đặt được sắp xếp như sau với các chế độ cài đặt có mức độ ưu tiên cao nhất để ghi đè mọi chế độ cài đặt của nhóm cài đặt hoặc Apigee:
- Khách hàng
- Trình cài đặt
- Apigee
Cách sử dụng tệp .properties
Là khách hàng, bạn chỉ có thể sửa đổi tệp .properties trong /opt/apigee/customer/application thư mục. Mỗi thành phần có tệp .properties riêng trong thư mục đó. Ví dụ: router.properties và management-server.properties.
- Tạo tệp trong trình chỉnh sửa như bất kỳ người dùng nào.
- Chọn chủ sở hữu tệp là apigee:apigee hoặc nếu bạn đã thay đổi người dùng chạy dịch vụ Edge từ người dùng apigee, hãy băm tệp cho người dùng đang chạy dịch vụ Edge.
Để đặt thuộc tính cho một thành phần, hãy chỉnh sửa tệp .properties tương ứng để đặt mã thông báo, sau đó khởi động lại thành phần:
> /opt/apigee/apigee-service/bin/apigee-service component restart
Ví dụ: sau khi chỉnh sửa router.properties, hãy khởi động lại Bộ định tuyến:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
Khi bạn nâng cấp Edge, các tệp .properties trong /opt/apigee/customer/application đã được đọc. Điều đó có nghĩa là khi nâng cấp, mọi tài sản mà bạn đã đặt trên thành phần.
Vị trí của tệp .properties
Có 3 thư mục cấp cao nhất cho các tệp .properties của Edge thành phần: chủ sở hữu cài đặt và khách hàng. Vị trí mặc định được hiển thị trong các vị trí sau bảng:
Cảnh báo: Khách hàng Edge chỉ có thể sửa đổi tệp .properties trong /opt/apigee/customer. Khi bạn có thể xem các tệp trong thư mục thành phần và cài đặt, không sửa đổi bất kỳ tệp nào.
|
Chủ sở hữu |
Thư mục gốc của mã thông báo mặc định |
|---|---|
|
Thành phần |
/opt/apigee/<prefix>-<component>/conf ở đâu /<prefix>-<component> xác định thành phần, chẳng hạn như bộ định tuyến cạnh hoặc apigee-cassandra. |
|
Cài đặt |
/opt/apigee/token |
|
Khách hàng |
/opt/apigee/customer |
Xác định giá trị hiện tại của mã thông báo
Trước khi đặt mã thông báo trong tệp .properties cho thành phần này, trước tiên, bạn có thể xác định giá trị hiện tại của tham số đó bằng lệnh sau:
> /opt/apigee/apigee-service/bin/apigee-service comp configure -search token
trong đó comp là tên của thành phần và token là mã thông báo cần kiểm tra.
Lệnh này sẽ tìm kiếm hệ phân cấp các tệp .properties để xác định giá trị hiện tại của mã thông báo.
Ví dụ: để kiểm tra giá trị hiện tại của mã thông báo conf_http_HTTPRequest.line.limit cho Bộ định tuyến:
> /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit
Bạn sẽ thấy kết quả trong biểu mẫu:
Found key conf_http_HTTPRequest.line.limit, with value, 4k, in /opt/apigee/edge-router/token/default.properties
Đặt mã thông báo trong tệp .properties
Cách ghi đè giá trị của một mã thông báo:
- Chỉnh sửa tệp .properties cho phần tử để đặt giá trị mã thông báo. Nếu tệp không tồn tại, hãy tạo tệp đó.
- Khởi động lại thành phần.
- Kiểm tra giá trị của mã thông báo.
Ví dụ: để đặt giới hạn dòng yêu cầu cho Bộ định tuyến cạnh:
- Chỉnh sửa thuộc tính /opt/apigee/customer/application/router.properties
để đặt mã thông báo conf_http_HTTPRequest.line.limit:
conf_http_HTTPRequest.line.limit=8k - Khởi động lại Edge Router:
> /opt/apigee/apigee-service/bin/apigee-service khởi động lại bộ định tuyến cạnh - Kiểm tra giá trị của mã thông báo:
> /opt/apigee/apigee-service/bin/apigee-service cấu hình bộ định tuyến cạnh -search conf_http_HTTPRequest.line.limit
Đặt mã thông báo nhận nhiều giá trị
Một số mã thông báo lấy danh sách giá trị được phân tách bằng dấu phẩy. Ví dụ: mã thông báo conf_security_rbac.restricted.resources sẽ lấy danh sách URI bị hạn chế để chỉ quản trị viên hệ thống mới có thể gọi chúng. Để xem giá trị của conf_security_rbac.restricted.resources:
> cd /opt/apigee/edge-management-server > grep -ri "conf_security_rbac.restricted.resources" *
Kết quả đầu ra chứa các nội dung sau:
token/default.properties:conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status
Để đặt mã thông báo lấy danh sách giá trị, hãy thêm mọi giá trị mới vào giá trị hiện tại của mã thông báo trong tệp .properties. Do đó, để thêm URI /myuri/* vào conf_security_rbac.restricted.resources, chỉnh sửa thuộc tính /opt/apigee/customer/application/management-server.properties như minh hoạ dưới đây:
conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status,/myuri/*
Tìm mã thông báo
Trong hầu hết các trường hợp, mã thông báo bạn cần đặt đều được xác định trong hướng dẫn này. Tuy nhiên, nếu bạn cần để xác định mã thông báo dùng để ghi đè một thuộc tính, hãy thực hiện lệnh grep trong thư mục source của thành phần.
Ví dụ: nếu biết rằng trong bản phát hành Edge trước, bạn đã đặt thuộc tính session.maxAge và muốn biết thuộc tính dùng để đặt mã, sau đó grep cho tài sản trong thư mục /opt/apigee/edge-ui/source:
> grep -ri "session.maxAge" /opt/apigee/edge-ui/source
Bạn sẽ thấy kết quả trong biểu mẫu:
/opt/apigee/edge-ui/source/conf/application.conf:session.maxAge={T}conf_application_session.maxage{/T}
Chuỗi giữa các thẻ {T}{/T} là mã thông báo mà bạn đặt vào tệp .properties.
Đặt một mã thông báo đang được nhận xét bị loại
Một số mã thông báo được nhận xét trong tệp cấu hình Edge. Nếu bạn cố đặt một mã thông báo bị nhận xét, chế độ cài đặt này sẽ bị bỏ qua.
Để đặt mã thông báo được nhận xét, bạn sử dụng cú pháp đặc biệt trong biểu mẫu:
conf/file.extension+propertyName=propertyValue
Ví dụ: bạn muốn đặt thuộc tính có tên HTTPClient.proxy.host trên Thông báo Bộ xử lý. Sau đó, bạn grep để để xác định mã thông báo của thuộc tính đó:
> cd /opt/apigee/edge-message-processor > grep -ri "HTTPClient.proxy.host" *
Lệnh grep trả về kết quả sẽ ở dạng có chứa giá trị mã thông báo. Hãy lưu ý cách nhận xét tên thuộc tính, được biểu thị bằng tiền tố # trên tên cơ sở lưu trú:
source/conf/http.properties:#HTTPClient.proxy.host={T}conf_http_HTTPClient.proxy.host{/T}
token/default.properties:conf_http_HTTPClient.proxy.host=
conf/http.properties:#HTTPClient.proxy.host=
Để đặt thuộc tính, hãy chỉnh sửa /opt/apigee/customer/application/message-processor.properties để đặt thuộc tính này là:
conf/http.properties+HTTPClient.proxy.host=myhost.name.com
Hãy lưu ý cách tên cơ sở lưu trú có tiền tố là conf/http.properties+, vị trí và tên của tệp cấu hình chứa thuộc tính theo sau là dấu "+".
Sau khi bạn khởi động lại Trình xử lý thư, hãy kiểm tra tệp /opt/apigee/edge-message-processor/conf/http.properties:
> cat /opt/apigee/edge-message-processor/conf/http.properties
Vào cuối tệp, bạn sẽ thấy thuộc tính được đặt ở dạng:
conf/http.properties:HTTPClient.proxy.host=myhost.name.com