Edge cho đám mây riêng tư phiên bản 4.16.05
Để định cấu hình Edge sau khi cài đặt, bạn sử dụng kết hợp các tệp .properties và tiện ích Edge. Ví dụ: để định cấu hình TLS/SSL trên giao diện người dùng Edge, bạn chỉnh sửa các tệp .properties để đặt các thuộc tính cần thiết. Khi thay đổi tệp .properties, bạn phải khởi động lại thành phần Edge chịu ảnh hưởng.
Apigee gọi kỹ thuật chỉnh sửa tệp .properties là mã có cấu hình. 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 chế độ cài đặt trong các tệp .properties. Trong mã có cấu hình, các khoá được gọi là mã thông báo. Do đó, để định cấu hình Edge, bạn cầ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 giá trị mặc định được cung cấp cùng với sản phẩm, cho phép nhóm cài đặt ghi đè các chế độ cài đặt đó dựa trên cấu trúc liên kết cài đặt, sau đó cho phép khách hàng ghi đè bất kỳ thuộc tính nào họ chọn.
Nếu bạn coi đây là một hệ phân cấp, thì các chế độ cài đặt sẽ được sắp xếp như sau, trong đó chế độ cài đặt của khách hàng 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 các tệp .properties trong thư mục /<inst_root>/apigee/customer/application. 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 với tư cách là người dùng bất kỳ.
- Chown chủ sở hữu của tệp thành apigee:apigee hoặc nếu bạn đã thay đổi người dùng đang chạy dịch vụ Edge từ người dùng apigee, hãy chown 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:
> /<inst_root>/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:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
Khi bạn nâng cấp Edge, các tệp .properties trong thư mục /<inst_root>/apigee/customer/application sẽ được đọc. Điều này có nghĩa là quá trình nâng cấp sẽ giữ lại mọi thuộc tính 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 cho các thành phần Edge: chủ sở hữu cài đặt và khách hàng. Vị trí mặc định được trình bày trong bảng sau:
Cảnh báo: Khách hàng của Edge chỉ có thể sửa đổi các tệp .properties trong /<inst_root>/apigee/customer. Mặc dù bạn có thể xem các tệp trong thư mục thành phần và thư mục cài đặt, nhưng đừ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 |
<inst_root>/apigee/<prefix>-<component>/conf trong đó /<prefix>-<component> xác định thành phần, chẳng hạn như edge-router hoặc apigee-cassandra. |
|
Cài đặt |
<inst_root>/apigee/token |
|
Khách hàng |
<inst_root>/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, trước tiên, bạn có thể xác định giá trị hiện tại của mã thông báo đó bằng cách sử dụng lệnh sau:
> /<inst_dir>/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 tìm kiếm hệ phân cấp của 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_router_HTTP.request.line.limit cho Bộ định tuyến, hãy làm như sau:
> /<inst_dir>/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_router_HTTP.request.line.limit
Bạn sẽ thấy kết quả ở dạng:
Found key conf_router_HTTP.request.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ã thông báo:
- Chỉnh sửa tệp .properties cho thành phần để đặ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.
- Hãy kiểm tra giá trị mã thông báo.
Ví dụ: để đặt giới hạn dòng yêu cầu cho Bộ định tuyến biên, hãy làm như sau:
- Chỉnh sửa tệp /<inst_root>/apigee/customer/application/router.properties để đặt mã thông báo conf_router_HTTP.request.line.limit:
conf_router_HTTP.request.line.limit=8k - Khởi động lại Bộ định tuyến Edge:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart - Kiểm tra giá trị của mã thông báo:
> /<inst_dir>/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_router_HTTP.request.line.limit
Đặt mã thông báo nhận nhiều giá trị
Một số mã thông báo nhận 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 lấy danh sách các URI bị hạn chế để chỉ quản trị viên hệ thống mới có thể gọi các URI đó. Cách xem giá trị của conf_security_rbac.restricted.resources:
> cd /<inst_root>/apigee/edge-management-server > grep -ri "conf_security_rbac.restricted.resources" *
Kết quả chứa những thông tin 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, hãy chỉnh sửa tệp /<inst_root>/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/*
Đang 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 được xác định trong hướng dẫn này. Tuy nhiên, nếu 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 bạn biết rằng trong một bản phát hành trước của Edge, bạn đã đặt thuộc tính session.maxAge và muốn biết giá trị mã thông báo dùng để đặt thuộc tính đó, thì hãy grep cho thuộc tính đó trong thư mục /<inst_root>/apigee/edge-ui/source:
> grep -ri "session.maxAge" /<inst_root>/apigee/edge-ui/source
Bạn sẽ thấy kết quả ở dạng:
/<inst_root>/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 trong tệp .properties.
Đặt mã thông báo hiện đang được đánh dấu là nội dung nhận xét
Một số mã thông báo bị đánh dấu là nội dung nhận xét trong tệp cấu hình Edge. Nếu bạn cố gắng đặt một mã thông báo được đánh dấu là nội dung nhận xét, thì chế độ cài đặt này sẽ bị bỏ qua.
Để đặt mã thông báo được đánh dấu là nội dung nhận xét, bạn sử dụng cú pháp đặc biệt, ở dạng:
conf/file.extension+propertyName=propertyValue
Ví dụ: bạn muốn đặt thuộc tính có tên là HTTPClient.proxy.host trên Bộ xử lý thông báo. Sau đó, bạn grep cho thuộc tính để 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ả ở dạng bao gồm giá trị mã thông báo. Hãy lưu ý cách tên thuộc tính được đánh dấu là nội dung nhận xét, như được biểu thị bằng tiền tố # trên tên thuộc tính:
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 thành:
conf/http.properties+HTTPClient.proxy.host=myhost.name.com
Lưu ý cách tên thuộc tính được thêm tiền tố 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 Bộ xử lý thông báo, hãy kiểm tra tệp /opt/apigee/edge-message-processor/conf/http.properties:
> cat /opt/apigee/edge-message-processor/conf/http.properties
Ở cuối tệp, bạn sẽ thấy tập hợp thuộc tính, ở dạng:
conf/http.properties:HTTPClient.proxy.host=yhost.name.com