Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào
tài liệu Apigee X. thông tin
Giao diện dòng lệnh (CLI) apigee-remote-service-cli giúp bạn cung cấp và quản lý Apigee Adapter for Envoy.
Lệnh liên kết
Liên kết sẽ liên kết một dịch vụ được triển khai vào lưới Istio với một sản phẩm API Apigee. CLI cho phép bạn liệt kê và xác minh các liên kết.
Liên kết danh sách
Liệt kê tất cả các sản phẩm API được liên kết với Dịch vụ từ xa.
Cách sử dụng
Đối với Edge Public Cloud:
apigee-remote-service-cli bindings list -o [organization] -e [environment] -u [username] -p [password]
Đối với Edge Private Cloud:
apigee-remote-service-cli bindings list -o [organization] -e [environment] -u [username] -p [password] -r [runtime]
Thông số
| Thông số | Loại | Mô tả |
|---|---|---|
-c, --config
|
Chuỗi | (Bắt buộc) Đường dẫn đến tệp cấu hình Dịch vụ từ xa của Apigee. Lưu ý: Cờ này cho phép bạn bỏ qua hầu hết các tham số lệnh khác, vì CLI có thể kéo trực tiếp các tham số đó từ tệp cấu hình. Xem phần Sử dụng lựa chọn --config.
|
-e, --env
|
Chuỗi | (Bắt buộc) Một môi trường trong tổ chức của bạn. |
-h, --help
|
Hiện thông tin trợ giúp về các tham số lệnh. | |
--insecure
|
Cho phép các kết nối máy chủ không an toàn khi sử dụng SSL | |
--legacy
|
Đặt cờ này nếu bạn đang sử dụng Apigee Edge Cloud. Thao tác này sẽ đặt URL quản lý và thời gian chạy cho Edge Cloud. | |
--mfa
|
Mã thông báo uỷ quyền đa yếu tố của Apigee (chỉ dùng với --legacy)
|
|
--opdk
|
Đặt cờ này nếu bạn đang sử dụng Apigee Edge cho Private Cloud. | |
-o, --org
|
Chuỗi | (Bắt buộc) Một tổ chức Apigee. Bạn phải là quản trị viên tổ chức. |
-p, --password
|
Chuỗi | (Chỉ bắt buộc đối với xác thực cơ bản) Mật khẩu Apigee của bạn. Bạn có thể chỉ định mật khẩu trong tệp .netrc (không bắt buộc). Nếu làm như vậy, bạn không cần cung cấp mật khẩu trên dòng lệnh. Xem thêm
Sử dụng .netrc cho thông tin xác thực.
|
-r, --runtime
|
Chuỗi | (Chỉ dành cho Đám mây riêng) Chỉ định URL thời gian chạy cho phiên bản Đám mây riêng của bạn. |
-t, --token
|
Chuỗi | (Chỉ bắt buộc đối với xác thực mã thông báo OAuth) Mã thông báo OAuth hoặc SAML mà bạn tạo từ thông tin tài khoản Apigee. Để biết thông tin về cách tạo mã thông báo, hãy xem bài viết Sử dụng get_token và Truy cập vào API quản lý bằng SAML. |
-u, --username
|
Chuỗi | (Chỉ bắt buộc đối với xác thực cơ bản) Tên người dùng Apigee (thường là địa chỉ email).
Bạn có thể chọn chỉ định tên người dùng trong tệp .netrc. Nếu làm như vậy, bạn không cần cung cấp tên người dùng trên dòng lệnh. Xem thêm Sử dụng .netrc cho thông tin đăng nhập.
|
-v, --verbose
|
(Không bắt buộc) Tạo đầu ra chi tiết. |
Ví dụ
apigee-remote-service-cli bindings list -o myorg -e test -u user@example.com -c config.yaml -p abc123
PI Products
============
Bound
-----
envoy-test:
Quota: 5 requests every 1 minute
Target bindings:
httpbin.org
Paths:
httpbin:
Quota: 5 requests every 1 minute
Target bindings:
httpbin.org
Paths:
/httpbin
/
Unbound
-------
product-1:
Quota: 100 requests every 1 hour
product-2:
Quota: 1000 requests every 1 month
product-3:
product-4:
Xác minh một liên kết
Xác minh rằng sản phẩm API liên kết được chỉ định và các ứng dụng nhà phát triển liên kết cũng có một sản phẩm dịch vụ từ xa được liên kết với chúng. Nếu bạn không chỉ định tên sản phẩm API, thì lệnh sẽ kiểm tra tất cả các sản phẩm được liên kết.
Cách sử dụng
Đối với Edge Public Cloud:
apigee-remote-service-cli bindings verify [product_name] -o [organization] -e [environment] -u [username] -p [password] -c [config]
Đối với Edge Private Cloud:
apigee-remote-service-cli bindings verify [product_name] -o [organization] -e [environment] -u [username] -p [password] -r [runtime] -c [config]
Trong đó, product_name là không bắt buộc. Nếu bạn không chỉ định tên sản phẩm, tất cả sản phẩm được liên kết sẽ được kiểm tra.
Thông số
| Thông số | Loại | Mô tả |
|---|---|---|
-c, --config
|
Chuỗi | (Bắt buộc) Đường dẫn đến tệp cấu hình Dịch vụ từ xa của Apigee. Lưu ý: Cờ này cho phép bạn bỏ qua hầu hết các tham số lệnh khác, vì CLI có thể kéo trực tiếp các tham số đó từ tệp cấu hình. Xem phần Sử dụng lựa chọn --config.
|
-e, --env
|
Chuỗi | (Bắt buộc) Một môi trường trong tổ chức của bạn. |
-h, --help
|
Hiện thông tin trợ giúp về các tham số lệnh. | |
--insecure
|
Cho phép các kết nối máy chủ không an toàn khi sử dụng SSL | |
--legacy
|
Đặt cờ này nếu bạn đang sử dụng Apigee Edge Cloud. Thao tác này sẽ đặt URL quản lý và thời gian chạy cho Edge Cloud. | |
--mfa
|
Mã thông báo uỷ quyền đa yếu tố của Apigee (chỉ dùng với --legacy)
|
|
--opdk
|
Đặt cờ này nếu bạn đang sử dụng Apigee Edge cho Private Cloud. | |
-o, --org
|
Chuỗi | (Bắt buộc) Một tổ chức Apigee. Bạn phải là quản trị viên tổ chức. |
-r, --runtime
|
Chuỗi | (Chỉ dành cho Đám mây riêng) Chỉ định URL thời gian chạy cho phiên bản Đám mây riêng của bạn. |
-t, --token
|
Chuỗi | (Chỉ bắt buộc đối với xác thực mã thông báo OAuth) Mã thông báo OAuth hoặc SAML mà bạn tạo từ thông tin tài khoản Apigee. Để biết thông tin về cách tạo mã thông báo, hãy xem bài viết Sử dụng get_token và Truy cập vào API quản lý bằng SAML. |
-v, --verbose
|
(Không bắt buộc) Tạo đầu ra chi tiết. |
Ví dụ
./apigee-remote-service-cli bindings verify my-product -o myorg -e test -u user@example.com -c config.yaml -p xxxxxx app my-app associated with product my-product is verified
Lệnh trợ giúp
Thông tin trợ giúp trực tuyến được cung cấp cho tất cả các lệnh apigee-remote-service-cli. Chỉ cần nhập:
apigee-remote-service-cli help
Để được trợ giúp về một lệnh bất kỳ, hãy nhập:
apigee-remote-service-cli [command] help
Ví dụ:
apigee-remote-service-cli provision help
Lệnh cấp phép
Lệnh apigee-remote-service-cli provision sẽ cài đặt một proxy trong tổ chức Apigee Edge của bạn, thiết lập một chứng chỉ và tạo thông tin đăng nhập mà bạn sẽ cần để định cấu hình Apigee Adapter for Envoy.
Cách sử dụng
Nếu bạn đang sử dụng Edge Public Cloud:
apigee-remote-service-cli provision -o $ORG -e $ENV -u $USERNAME -p $PASSWORD
Nếu bạn đang sử dụng Edge Private Cloud:
apigee-remote-service-cli provision --opdk -o $ORG -e $ENV -u $USERNAME --management $MGMT_SERVER_URL --runtime $RUNTIME_URL -p $PASSWORD
Thông số
| Thông số | Loại | Mô tả |
|---|---|---|
--analytics-sa
|
Chuỗi | Cờ này chỉ dùng được cho các bản cài đặt Apigee hybrid và Apigee trên Google Cloud.
Sử dụng cờ này để chỉ định đường dẫn đến tệp khoá tài khoản dịch vụ Google Cloud, trong đó tài khoản dịch vụ có vai trò |
-c, --config
|
Chuỗi | Đường dẫn đến tệp cấu hình Dịch vụ từ xa của Apigee. Xem thêm phần
Sử dụng lựa chọn --config.
|
-e, --environment
|
Chuỗi | (Bắt buộc) Một môi trường trong tổ chức của bạn. |
-f, --force-proxy-install
|
(Không bắt buộc) Buộc cài đặt lại proxy remote-service nếu proxy này đã được cài đặt trong tổ chức của bạn.
|
|
-h, --help
|
Hiện thông tin trợ giúp về các tham số lệnh. | |
-k, --key
|
Chuỗi | Chỉ định khoá được trả về từ lệnh apigee-remote-service-cli provision.
|
--legacy
|
Đặt cờ này nếu bạn đang sử dụng Apigee Edge Cloud. Thao tác này sẽ đặt URL quản lý và thời gian chạy cho Edge Cloud. | |
--mfa
|
Mã thông báo uỷ quyền đa yếu tố của Apigee (chỉ dùng với --legacy)
|
|
-m, --management
|
Chuỗi | (Bắt buộc nếu bạn đang sử dụng Apigee Private Cloud) URL cơ sở quản lý Apigee.
Mặc định: https://api.enterprise.apigee.com
|
-n, --namespace
|
Chuỗi | Phát cấu hình dưới dạng Envoy ConfigMap trong không gian tên đã chỉ định. Mặc định: apigee |
--opdk
|
Chuỗi | Apigee OPDK. |
-o, --organization
|
Chuỗi | (Bắt buộc) Tổ chức Apigee của bạn. Bạn phải là quản trị viên tổ chức. |
-p, --password
|
Chuỗi | (Chỉ bắt buộc đối với xác thực cơ bản) Mật khẩu Apigee của bạn. Bạn có thể chỉ định mật khẩu trong tệp .netrc (không bắt buộc). Nếu làm như vậy, bạn không cần cung cấp mật khẩu trên dòng lệnh. Xem thêm
Sử dụng .netrc cho thông tin xác thực.
|
--rotate-int
|
int | Nếu n > 0, hãy tạo khoá riêng tư mới và giữ lại n khoá công khai (chỉ dành cho chế độ kết hợp) |
-r, --runtime
|
Chuỗi | (Chỉ dành cho Đám mây riêng) Chỉ định URL thời gian chạy cho phiên bản Đám mây riêng của bạn. |
-s, --secret
|
Chuỗi | Chỉ định khoá bí mật được trả về từ lệnh apigee-remote-service-cli provision.
|
--strength
|
int | (Không bắt buộc) Chỉ định độ mạnh của hoạt động mã hoá cho chứng chỉ SSL được dùng trong việc cung cấp bộ chuyển đổi. Mặc định là 2048 |
-t, --token
|
Chuỗi | (Chỉ dành cho phiên bản kết hợp) Mã thông báo Apigee OAuth hoặc SAML. |
-u, --username
|
Chuỗi | (Chỉ bắt buộc đối với xác thực cơ bản) Tên người dùng Apigee (thường là địa chỉ email).
Bạn có thể chọn chỉ định tên người dùng trong tệp .netrc.
Xem thêm phần Sử dụng .netrc cho thông tin đăng nhập.
|
-v, --verbose
|
(Không bắt buộc) Tạo đầu ra chi tiết. | |
--virtual-hosts
|
Chuỗi | Ghi đè các máy chủ ảo mặc định là default,secure. Hãy sử dụng lựa chọn này nếu bạn đã chỉ định máy chủ ảo cho tổ chức-môi trường Edge ngoài các giá trị mặc định này.
Hãy xem tài liệu về Edge để tìm hiểu về máy chủ ảo.
|
--years
|
int | (Không bắt buộc) Số năm trước khi chứng chỉ SSL được dùng trong quá trình cung cấp hết hạn. Mặc định: 1 |
Ví dụ
Hãy nhớ ghi lại đầu ra của lệnh provision trong một tệp. Tệp này được dùng làm dữ liệu đầu vào cho các thao tác khác của Apigee Adapter for Envoy.
Ví dụ về Đám mây công cộng Edge:
apigee-remote-service-cli provision --legacy --mfa $MFA --username $USER --password $PASSWORD --organization $ORG --environment $ENV > config.yaml
Lệnh mẫu
Tạo các tệp cấu hình mẫu cho việc triển khai Envoy hoặc Istio gốc.
Cách sử dụng
apigee-remote-service-cli samples create [flags]
Mô tả
Lệnh này yêu cầu một tệp config.yaml hợp lệ được tạo thông qua quy trình cấp phép.
Theo mặc định, các tệp mẫu sẽ được xuất ra một thư mục có tên là ./samples. Lệnh này sẽ tạo thư mục này cho bạn.
Nếu bạn đang sử dụng Envoy gốc, lệnh này sẽ lấy máy chủ dịch vụ đích và tên mong muốn cho cụm của máy chủ đó. Thao tác này cũng thiết lập kết nối SSL tuỳ chỉnh từ proxy Envoy đến cụm dịch vụ từ xa nếu một thư mục chứa tls.key và tls.crt được cung cấp thông qua --tls.
Nếu bạn đang sử dụng Istio, trong đó proxy Envoy hoạt động như một sidecar, nếu mục tiêu không được chỉ định, thì ví dụ httpbin sẽ được tạo. Nếu không, bạn phải chịu trách nhiệm chuẩn bị các tệp cấu hình liên quan đến việc triển khai các dịch vụ mục tiêu.
Thông số
| Thông số | Loại | Mô tả |
|---|---|---|
-c, --config
|
Chuỗi | (Bắt buộc) Đường dẫn đến tệp cấu hình Dịch vụ từ xa của Apigee. Lưu ý: Cờ này cho phép bạn bỏ qua hầu hết các tham số lệnh khác, vì CLI có thể kéo trực tiếp các tham số đó từ tệp cấu hình. Xem phần Sử dụng lựa chọn --config.
|
-f, --force
|
Buộc ghi đè thư mục hiện có. | |
-h, --help
|
Hiện thông tin trợ giúp về các tham số lệnh. | |
--host
|
Máy chủ dịch vụ đích (mặc định là "httpbin.org") | |
-n, --name
|
Tên dịch vụ mục tiêu (mặc định là "httpbin") | |
--out
|
Thư mục để tạo các tệp cấu hình mẫu. Mặc định: ./samples
|
|
-t, --template
|
Tên mẫu. Nếu bạn đang triển khai Istio (chỉ dành cho mô hình kết hợp), hãy chọn một trong các lựa chọn Istio có sẵn. Sử dụng lựa chọn gốc cho việc triển khai Envoy gốc. Các lựa chọn hiện có là:
|
|
--tls
|
Thư mục để lưu trữ các tệp khoá và crt TLS. |
Ví dụ
apigee-remote-service-cli samples create -c ./config.yaml
Liệt kê các lựa chọn mẫu có sẵn
Liệt kê các lựa chọn có thể sử dụng với tham số --templates.
Cách sử dụng
apigee-remote-service-cli samples templates
Thông số
Không có.
Ví dụ
apigee-remote-service-cli samples templates
Supported templates (native is deprecated): envoy-1.14 envoy-1.15 envoy-1.16 istio-1.5 istio-1.6 istio-1.7 istio-1.8 native
Lệnh mã thông báo
Bạn có thể sử dụng mã thông báo JWT để thực hiện các lệnh gọi được xác thực đến proxy API thay vì sử dụng khoá API. Các lệnh mã thông báo cho phép bạn tạo, kiểm tra và xoay vòng mã thông báo JWT cho mục đích này.
Tạo mã thông báo JWT
Bạn có thể sử dụng mã thông báo JWT để thực hiện các lệnh gọi được xác thực đến đích dịch vụ từ xa. Xem thêm phần Sử dụng phương thức xác thực dựa trên JWT.Cách sử dụng
Đối với Edge Public Cloud:apigee-remote-service-cli token create -c [config_file] --id [consumer_key] --secret [consumer_secret] -o [org] -e [env]
apigee-remote-service-cli token create -c [config_file] --id [consumer_key] --secret [consumer_secret] -r [runtime] -o [org] -e [env]
Thông số
| Thông số | Loại | Mô tả |
|---|---|---|
-c, --config
|
Chuỗi | (Bắt buộc) Đường dẫn đến tệp cấu hình Dịch vụ từ xa của Apigee. Lưu ý: Cờ này cho phép bạn bỏ qua hầu hết các tham số lệnh khác, vì CLI có thể kéo trực tiếp các tham số đó từ tệp cấu hình. Xem phần Sử dụng lựa chọn --config.
|
-e, --env
|
Chuỗi | (Bắt buộc) Một môi trường trong tổ chức của bạn. |
-h, --help
|
Hiện thông tin trợ giúp về các tham số lệnh. | |
--insecure
|
Cho phép các kết nối máy chủ không an toàn khi sử dụng SSL. | |
-o, --org
|
Chuỗi | (Bắt buộc) Một tổ chức Apigee. Bạn phải là quản trị viên tổ chức. |
-r, --runtime
|
Chuỗi | (Chỉ dành cho Đám mây riêng) Chỉ định URL thời gian chạy cho phiên bản Đám mây riêng của bạn. |
-v, --verbose
|
(Không bắt buộc) Tạo đầu ra chi tiết. |
Ví dụ
apigee-remote-service-cli token create -o myorg -e test -i YUmlZAcBKNsTAelJqPZFl3sh58ObATX9 -s icTARgaKHqvUH1dq -c config.yaml
Đầu ra
Khi thành công, bạn sẽ thấy một mã thông báo JST có dạng như sau:eyJraWQiOiIxIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJhY2Nlc3NfdG9rZW4iOiJ0a2tlVzVKQTY2a0pZYTB4bFV1cVBsUW1BMU43IiwiYXVkIjoiaXN0aW8iLCJuYmYiOjE1MzAxMzg1OTEsImFwaV9wcm9kdWN0X2xpc3QiOlsiaXN0aW8tcHJvZHVjdCJdLCJhcHBsaWNhdGlvbl9uYW1lIjoiaXN0aW8tYXBwIiwiZGV2ZWxvcGVyX2VtYWlsIjoicFluZ2Zsb3lkQGdvb2dsZS5jb20iLCJpc3MiOiJodHRwczovL2FwaWdlZXNlYXJjaC10ZXN0LmFwaWdlZS5uZXQvaXN0aW8tYXV0aC90b2tlbiIsImV4cCI6MTUzMDEzOTQ5MSwiaWF0IjoxNTMwMTM4NTkxLCJqdGkiOiIxODgzMzViZi0wMmE4LTRjZGUsOGFkOS0yMWJmNDZjNmRjZDkiLCJjbGllbnRfaWQiOiJZVW1sWkFjQktOc1RBZWxKcVBZRmwzc2g1OE9iQVRYOSJ9.AL7pKSTmond-NSPRNNHVbIzTdAnZjOXcjQ-BbOJ_8lsQvF7PuiOUrGIhY5XTcJusisKgbCdtIxBl8Wq1EiQ_fKnUc3JYYOqzpTB5bGoFy0Yqbfu96dneuWyzgZnoQBkqwZkbQTIg7WNTGx1TJX-UTePvBPxAefiAbaEUcigX9tTsXPoRJZOTrm7IOeKpxpB_gQYkxQtV1_NbERxjTPyMbHdMWal9_xRVzSt7mpTGudMN9OR-VtQ1uXA67GOqhZWcOzq57qImOiCMbaoKnKUADevyWjX_VscN5ZZUtzQUQhTrmv8aR69-uVhMIPKp9juMyYKaYn2IsYZEeCWfhfV45Q
Kiểm tra mã thông báo JWT
Bạn có thể kiểm tra mã thông báo JWT bằng lệnh này. Xem thêm phần Kiểm tra mã thông báo.Cách sử dụng
Đối với Edge Public Cloud:apigee-remote-service-cli token inspect -o [organization] -e [environment] -f [token_file]
apigee-remote-service-cli token inspect -o [organization] -e [environment] -f [token_file] --runtime [host_alias]
Thông số
| Thông số | Loại | Mô tả |
|---|---|---|
-c, --config
|
Chuỗi | (Bắt buộc) Đường dẫn đến tệp cấu hình Dịch vụ từ xa của Apigee. Lưu ý: Cờ này cho phép bạn bỏ qua hầu hết các tham số lệnh khác, vì CLI có thể kéo trực tiếp các tham số đó từ tệp cấu hình. Xem phần Sử dụng lựa chọn --config.
|
-e, --env
|
Chuỗi | (Bắt buộc) Một môi trường trong tổ chức của bạn. |
-h, --help
|
Hiện thông tin trợ giúp về các tham số lệnh. | |
--insecure
|
Cho phép các kết nối máy chủ không an toàn khi sử dụng SSL. | |
-o, --org
|
Chuỗi | (Bắt buộc) Một tổ chức Apigee. Bạn phải là quản trị viên tổ chức. |
-r, --runtime
|
Chuỗi | (Chỉ dành cho Đám mây riêng) Chỉ định URL thời gian chạy cho phiên bản Đám mây riêng của bạn. |
-v, --verbose
|
(Không bắt buộc) Tạo đầu ra chi tiết. |
Ví dụ
apigee-remote-service-cli token inspect -c config.yaml <<< $TOKEN
Đầu ra
Khi thành công, bạn sẽ thấy kết quả tương tự như sau:
{
"aud": [
"remote-service-client"
],
"exp": 1591741549,
"iat": 1591740649,
"iss": "https://apigee-docs-test.apigee.net/remote-service/token",
"jti": "99325d2e-6440-4278-9f7f-b252a1a79e53",
"nbf": 1591740649,
"access_token": "VfzpXzBGAQ07po0bPMKY4JgQjus",
"api_product_list": [
"httpbin"
],
"application_name": "httpbin",
"client_id": "GYDGHy5TRpV8AejXCOlreP7dPVepA8H",
"developer_email": "user@example.com",
"scope": ""
}
verifying...
token ok.
Xoay vòng mã thông báo JWT
Vào một thời điểm nào đó sau khi tạo JWT ban đầu, bạn có thể cần thay đổi cặp khoá công khai/khoá riêng tư do Apigee Edge lưu trữ trong bản đồ khoá-giá trị (KVM) được mã hoá. Quá trình tạo cặp khoá mới này được gọi là xoay vòng khoá. Khi bạn xoay khoá, một cặp khoá riêng tư/công khai mới sẽ được tạo và lưu trữ trong KVM "istio" trong tổ chức/môi trường Apigee Edge của bạn. Ngoài ra, khoá công khai cũ vẫn được giữ lại cùng với giá trị mã nhận dạng khoá ban đầu.Cách sử dụng
Nếu bạn đang sử dụng Edge Public Cloud:apigee-remote-service-cli token rotate-cert -c [config_file] -o [organization] -e [environment] -k [provision_key] -s [provision_secret] --kid [new_key_id]
apigee-remote-service-cli token rotate-cert -o [organization] -e [environment] -u [username] -p [password] -k [provision_key] -s [provision_secret] --kid [new_key_id]
Thông số
| Thông số | Loại | Mô tả |
|---|---|---|
-c, --config
|
Chuỗi | (Bắt buộc) Đường dẫn đến tệp cấu hình Dịch vụ từ xa của Apigee. Lưu ý: Cờ này cho phép bạn bỏ qua hầu hết các tham số lệnh khác, vì CLI có thể kéo trực tiếp các tham số đó từ tệp cấu hình. Xem phần Sử dụng lựa chọn --config.
|
-e, --env
|
Chuỗi | (Bắt buộc) Một môi trường trong tổ chức của bạn. |
-h, --help
|
Hiện thông tin trợ giúp về các tham số lệnh. | |
--insecure
|
Cho phép các kết nối máy chủ không an toàn khi sử dụng SSL | |
--truncate
|
int | Số lượng chứng chỉ cần giữ trong jwks (mặc định là 2) |
-o, --org
|
Chuỗi | (Bắt buộc) Một tổ chức Apigee. Bạn phải là quản trị viên tổ chức. |
-r, --runtime
|
Chuỗi | (Chỉ dành cho Đám mây riêng) Chỉ định URL thời gian chạy cho phiên bản Đám mây riêng của bạn. |
-v, --verbose
|
(Không bắt buộc) Tạo đầu ra chi tiết. |
Ví dụ
apigee-remote-service-cli token rotate-cert -c config.yaml -o myorg -e test -k 2e238ffa15dc5ab6a1e97868e7581f6c60ddb8575478582c256d8b7e5b2677a8 -s 51058077223fa7b683c3bea845c5cca138340d1d5583922b6d465f9f918a4b08
Đầu ra
certificate successfully rotated
Sử dụng .netrc cho thông tin đăng nhập
apigee-remote-service-cli sẽ tự động chọn username và password (để xác thực cơ bản khi cần) từ tệp .netrc trong thư mục chính nếu bạn đang sử dụng Đám mây công khai Edge và có một mục cho máy api.enterprise.apigee.com. Nếu bạn đang sử dụng Apigee Private Cloud, giá trị máy sẽ giống với URL management của bạn (ví dụ: http://192.162.55.100).
Ví dụ: trên Edge Public Cloud:
machine api.enterprise.apigee.com login jdoe@google.com password abc123
machine http://192.162.55.100 login jdoe@google.com password abc123
Lệnh phiên bản
In phiên bản CLI.
apigee-remote-service-cli version
Sử dụng lựa chọn lệnh --config
Lựa chọn --config chỉ định vị trí của tệp cấu hình do lệnh provision tạo. Một lợi ích hữu ích của lựa chọn này là bạn có thể bỏ qua hầu hết các tham số lệnh khác mà CLI lấy từ tệp cấu hình.
Các lựa chọn này bao gồm:
- tổ chức
- môi trường
- thời gian chạy
- quản lý
- không bảo mật
- không gian tên
- cũ
- opdk
Ví dụ: bạn có thể thực thi lệnh provision như sau:
apigee-remote-service-cli provision --config='old-config.yaml' > new-config.yaml
Tệp cấu hình
Phần này trình bày một tệp cấu hình mẫu với tất cả các lựa chọn có sẵn.
global:
temp_dir: /tmp/apigee-istio
keep_alive_max_connection_age: 1m
api_address: :5000
metrics_address: :5001
tls:
cert_file: tls.crt
key_file: tls.key
tenant:
internal_api: https://istioservices.apigee.net/edgemicro
remote_service_api: https://org-test.apigee.net/remote-service
org_name: org
env_name: env
key: mykey
secret: mysecret
client_timeout: 30s
allow_unverified_ssl_cert: false
products:
refresh_rate: 2m
analytics:
legacy_endpoint: false
file_limit: 1024
send_channel_size: 10
collection_interval: 10s
fluentd_endpoint: apigee-udca-myorg-test.apigee.svc.cluster.local:20001
tls:
ca_file: /opt/apigee/tls/ca.crt
cert_file: /opt/apigee/tls/tls.crt
key_file: /opt/apigee/tls/tls.key
allow_unverified_ssl_cert: false
auth:
api_key_claim: claim
api_key_cache_duration: 30m
api_key_header: x-api-key
api_target_header: :authority
reject_unauthorized: true
jwks_poll_interval: 0s
jwt_provider_key: https://org-test.apigee.net/remote-service/token