您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊
apigee-remote-service-cli
指令列介面 (CLI) 可協助您佈建及管理 Envoy 適用的 Apigee Adapter。
繫結指令
繫結會將部署至 Istio 網格的服務與 Apigee API 產品建立關聯。您可透過 CLI 建立、移除、列出及驗證繫結。
新增繫結
將遠端服務目標繫結新增至 API 產品。
使用方式
邊緣公用雲端:
apigee-remote-service-cli bindings add [service_name] [product_name] -o [organization] -e [environment] -u [username] -p [password] -c [config]
適用於 Edge Private Cloud:
apigee-remote-service-cli bindings add [service_name] [product_name] -o [organization] -e [environment] -u [username] -p [password] -r [runtime] -c [config]
地點:
target_name
是要繫結至產品的遠端服務目標名稱。product_name
是要繫結服務的產品名稱。
旗幟
參數 | 類型 | 說明 |
---|---|---|
-c, --config
|
字串 | (必要) Apigee 遠端服務設定檔的路徑。 提示:這個標記可讓您省略大部分的其他指令參數,因為 CLI 可直接從設定檔提取這些參數。請參閱「 使用 --config 選項」一節。 |
-e, --env
|
字串 | (必要) 機構中的環境。 |
-h, --help
|
顯示指令參數的說明。 | |
--insecure
|
使用 SSL 時允許不安全的伺服器連線 | |
--legacy
|
如果您使用的是 Apigee Edge Cloud,請設定這個標記。用來設定 Edge Cloud 的管理和執行階段網址。 | |
--mfa
|
Apigee 多重授權權杖 (僅限 --legacy 使用) |
|
--opdk
|
如果您使用的是私有雲的 Apigee Edge,請設定這個旗標。 | |
-o, --org
|
字串 | (必要) Apigee 機構。您必須是機構組織管理員。 |
-p, --password
|
字串 | (只有基本驗證才需要) 您的 Apigee 密碼。您可以視需要在 .netrc 檔案中指定密碼。如果您這樣做,就不需要在指令列中提供密碼。另請參閱針對憑證使用 .netrc。 |
-r, --runtime
|
字串 | (僅限 Private Cloud) 指定 Private Cloud 執行個體的執行階段網址。 |
-t, --token
|
字串 | (僅限 OAuth 權杖驗證的必要) 您透過 Apigee 帳戶資訊產生的 OAuth 或 SAML 權杖。如要瞭解如何產生權杖,請參閱使用 get_token 和透過 SAML 存取 management API。 |
-u, --username
|
字串 | (只有基本驗證才需要) 您的 Apigee 使用者名稱 (通常是電子郵件地址)。
您可以視需要在 .netrc 檔案中指定使用者名稱。如果您這麼做,就不需要在指令列中提供使用者名稱。另請參閱針對憑證使用 .netrc。 |
-v, --verbose
|
(選用) 產生詳細輸出。 |
範例
./apigee-remote-service-cli bindings add httpbin.org envoy-test -o myorg -e test -u user@example.com -c config.yaml -p xxxxxx product envoy-test is now bound to: httpbin.org
列出繫結
列出繫結至遠端服務的所有 API 產品。
使用方式
邊緣公用雲端:
apigee-remote-service-cli bindings list -o [organization] -e [environment] -u [username] -p [password]
適用於 Edge Private Cloud:
apigee-remote-service-cli bindings list -o [organization] -e [environment] -u [username] -p [password] -r [runtime]
參數
參數 | 類型 | 說明 |
---|---|---|
-c, --config
|
字串 | (必要) Apigee 遠端服務設定檔的路徑。 提示:這個標記可讓您省略大部分的其他指令參數,因為 CLI 可直接從設定檔提取這些參數。請參閱「 使用 --config 選項」。 |
-e, --env
|
字串 | (必要) 機構中的環境。 |
-h, --help
|
顯示指令參數的說明。 | |
--insecure
|
使用 SSL 時允許不安全的伺服器連線 | |
--legacy
|
如果您使用的是 Apigee Edge Cloud,請設定這個標記。用來設定 Edge Cloud 的管理和執行階段網址。 | |
--mfa
|
Apigee 多重授權權杖 (僅限 --legacy 使用) |
|
--opdk
|
如果您使用的是私有雲的 Apigee Edge,請設定這個旗標。 | |
-o, --org
|
字串 | (必要) Apigee 機構。您必須是機構組織管理員。 |
-p, --password
|
字串 | (只有基本驗證才需要) 您的 Apigee 密碼。您可以視需要在 .netrc 檔案中指定密碼。如果您這樣做,就不需要在指令列中提供密碼。另請參閱針對憑證使用 .netrc。 |
-r, --runtime
|
字串 | (僅限 Private Cloud) 指定 Private Cloud 執行個體的執行階段網址。 |
-t, --token
|
字串 | (僅限 OAuth 權杖驗證的必要) 您透過 Apigee 帳戶資訊產生的 OAuth 或 SAML 權杖。如要瞭解如何產生權杖,請參閱使用 get_token 和透過 SAML 存取 management API。 |
-u, --username
|
字串 | (只有基本驗證才需要) 您的 Apigee 使用者名稱 (通常是電子郵件地址)。
您可以視需要在 .netrc 檔案中指定使用者名稱。如果您這麼做,就不需要在指令列中提供使用者名稱。另請參閱針對憑證使用 .netrc。 |
-v, --verbose
|
(選用) 產生詳細輸出。 |
範例
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:
移除繫結
從 API 產品中移除 Remote Service for Envoy 繫結。
使用方式
邊緣公用雲端:
apigee-remote-service-cli bindings remove [service_name] [product_name] -o [organization] -e [environment] -u [username] -p [password] -c [config]
適用於 Edge Private Cloud:
apigee-remote-service-cli bindings remove [service_name] [product_name] -o [organization] -e [environment] -u [username] -p [password] -r [runtime] -c [config]
地點:
target_name
是要與產品解除繫結的遠端服務目標名稱。product_name
是要將目標解除繫結的產品名稱。
參數
參數 | 類型 | 說明 |
---|---|---|
-c, --config
|
字串 | (必要) Apigee 遠端服務設定檔的路徑。 提示:這個標記可讓您省略大部分的其他指令參數,因為 CLI 可直接從設定檔提取這些參數。請參閱「 使用 --config 選項」一節。 |
-e, --env
|
字串 | (必要) 機構中的環境。 |
-h, --help
|
顯示指令參數的說明。 | |
--insecure
|
使用 SSL 時允許不安全的伺服器連線 | |
--legacy
|
如果您使用的是 Apigee Edge Cloud,請設定這個標記。用來設定 Edge Cloud 的管理和執行階段網址。 | |
--mfa
|
Apigee 多重授權權杖 (僅限 --legacy 使用) |
|
--opdk
|
如果您使用的是私有雲的 Apigee Edge,請設定這個旗標。 | |
-o, --org
|
字串 | (必要) Apigee 機構。您必須是機構組織管理員。 |
-p, --password
|
字串 | (只有基本驗證才需要) 您的 Apigee 密碼。您可以視需要在 .netrc 檔案中指定密碼。如果您這樣做,就不需要在指令列中提供密碼。另請參閱針對憑證使用 .netrc。 |
-r, --runtime
|
字串 | (僅限 Private Cloud) 指定 Private Cloud 執行個體的執行階段網址。 |
-t, --token
|
字串 | (僅限 OAuth 權杖驗證的必要) 您透過 Apigee 帳戶資訊產生的 OAuth 或 SAML 權杖。如要瞭解如何產生權杖,請參閱使用 get_token 和透過 SAML 存取 management API。 |
-u, --username
|
字串 | (只有基本驗證才需要) 您的 Apigee 使用者名稱 (通常是電子郵件地址)。
您可以視需要在 .netrc 檔案中指定使用者名稱。如果您這麼做,就不需要在指令列中提供使用者名稱。另請參閱針對憑證使用 .netrc。 |
-v, --verbose
|
(選用) 產生詳細輸出。 |
範例
./apigee-remote-service-cli bindings remove httpbin.org envoy-test -o myorg -e test -u user@example.com -c config.yaml -p xxxxxx product envoy-test is no longer bound to: httpbin.org
驗證繫結
請確認指定的繫結 API 產品及其相關聯的開發人員應用程式也有相關聯的遠端服務產品。如未指定 API 產品名稱,則指令會檢查所有繫結的產品。
使用方式
邊緣公用雲端:
apigee-remote-service-cli bindings verify [product_name] -o [organization] -e [environment] -u [username] -p [password] -c [config]
適用於 Edge Private Cloud:
apigee-remote-service-cli bindings verify [product_name] -o [organization] -e [environment] -u [username] -p [password] -r [runtime] -c [config]
這裡的 product_name 為選填屬性。如果未指定產品名稱,則繫結的所有產品都會經過檢查。
參數
參數 | 類型 | 說明 |
---|---|---|
-c, --config
|
字串 | (必要) Apigee 遠端服務設定檔的路徑。 提示:這個標記可讓您省略大部分的其他指令參數,因為 CLI 可直接從設定檔提取這些參數。請參閱「 使用 --config 選項」一節。 |
-e, --env
|
字串 | (必要) 機構中的環境。 |
-h, --help
|
顯示指令參數的說明。 | |
--insecure
|
使用 SSL 時允許不安全的伺服器連線 | |
--legacy
|
如果您使用的是 Apigee Edge Cloud,請設定這個標記。用來設定 Edge Cloud 的管理和執行階段網址。 | |
--mfa
|
Apigee 多重授權權杖 (僅限 --legacy 使用) |
|
--opdk
|
如果您使用的是私有雲的 Apigee Edge,請設定這個旗標。 | |
-o, --org
|
字串 | (必要) Apigee 機構。您必須是機構組織管理員。 |
-r, --runtime
|
字串 | (僅限 Private Cloud) 指定 Private Cloud 執行個體的執行階段網址。 |
-t, --token
|
字串 | (僅限 OAuth 權杖驗證的必要) 您透過 Apigee 帳戶資訊產生的 OAuth 或 SAML 權杖。如要瞭解如何產生權杖,請參閱「使用 get_token」和「透過 SAML 存取 Management API」這兩篇文章。 |
-v, --verbose
|
(選用) 產生詳細輸出。 |
範例
./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
說明指令
所有 apigee-remote-service-cli
指令皆提供線上說明。只要輸入:
apigee-remote-service-cli help
如需取得任何指令的相關說明,請輸入:
apigee-remote-service-cli [command] help
例如:
apigee-remote-service-cli provision help
佈建指令
apigee-remote-service-cli provision
指令會在您的 Apigee Edge 機構中安裝 Proxy、設定憑證,並產生設定 Apigee Adapter for Envoy 所需的憑證。
使用方式
如果您使用的是 Edge Public Cloud:
apigee-remote-service-cli provision -o $ORG -e $ENV -u $USERNAME -p $PASSWORD
如果您使用的是 Edge Private Cloud:
apigee-remote-service-cli provision --opdk -o $ORG -e $ENV -u $USERNAME --management $MGMT_SERVER_URL --runtime $RUNTIME_URL -p $PASSWORD
參數
參數 | 類型 | 說明 |
---|---|---|
-c, --config
|
字串 | Apigee 遠端服務設定檔的路徑。另請參閱
使用 --config 選項。 |
-e, --environment
|
字串 | (必要) 機構中的環境。 |
-f, --force-proxy-install
|
(選用) 如果貴機構中已安裝 remote-service Proxy,則強制重新安裝。
|
|
-h, --help
|
顯示指令參數的說明。 | |
-k, --key
|
字串 | 指定 apigee-remote-service-cli provision 指令傳回的金鑰。 |
--legacy
|
如果您使用的是 Apigee Edge Cloud,請設定這個標記。用來設定 Edge Cloud 的管理和執行階段網址。 | |
--mfa
|
Apigee 多重授權權杖 (僅限 --legacy 使用) |
|
-m, --management
|
字串 | (如果您使用的是 Apigee Private Cloud,此為必填屬性) 您的 Apigee 管理基礎網址。預設值:https://api.enterprise.apigee.com |
-n, --namespace
|
字串 | 在指定命名空間中,以 Envoy ConfigMap 的形式發出設定。預設:apigee |
--opdk
|
字串 | Apigee OPDK。 |
-o, --organization
|
字串 | (必要) 您的 Apigee 機構。您必須是機構組織管理員。 |
-p, --password
|
字串 | (只有基本驗證才需要) 您的 Apigee 密碼。您可以視需要在 .netrc 檔案中指定密碼。如果您這樣做,就不需要在指令列中提供密碼。另請參閱針對憑證使用 .netrc。 |
--rotate-int
|
int | 如果 n > 0,請產生新的私密金鑰並保留 n 個公開金鑰 (僅限混合型) |
-r, --runtime
|
字串 | (僅限 Private Cloud) 指定 Private Cloud 執行個體的執行階段網址。 |
-s, --secret
|
字串 | 指定 apigee-remote-service-cli provision 指令傳回的密鑰。 |
--strength
|
int | (選用) 指定佈建轉接器時使用的 SSL 憑證加密強度。預設 2048 |
-t, --token
|
字串 | (僅限混合型) Apigee OAuth 或 SAML 權杖。 |
-u, --username
|
字串 | (只有基本驗證才需要) 您的 Apigee 使用者名稱 (通常是電子郵件地址)。
您可以視需要在 .netrc 檔案中指定使用者名稱。
另請參閱針對憑證使用 .netrc。 |
-v, --verbose
|
(選用) 產生詳細輸出。 | |
--virtual-hosts
|
字串 | 覆寫預設的虛擬主機 default,secure 。如果您替 Edge 機構環境指定並非上述預設值的虛擬主機,請使用這個選項。如需虛擬主機相關資訊,請參閱 Edge 說明文件。 |
--years
|
int | (選用) 佈建作業中使用的 SSL 憑證過期時間。預設值:1 |
範例
請務必在檔案中擷取 provision
指令的輸出內容,該檔案會做為其他 Apigee Adapter for Envoy 作業的輸入內容。
Edge Public Cloud 範例:
apigee-remote-service-cli provision --legacy --mfa $MFA --username $USER --password $PASSWORD --organization $ORG --environment $ENV > config.yaml
範例指令
建立原生 Envoy 或 Istio 部署作業的範例設定檔。
使用方式
apigee-remote-service-cli samples create [flags]
說明
這個指令需要透過佈建產生的有效 config.yaml
檔案。根據預設,範例檔案會輸出至名為 ./samples
的目錄。這個指令會為您建立這個目錄。
如果您使用的是原生 Envoy,指令會取得目標服務主機及其叢集要使用的名稱。如果透過 --tls
提供包含 tls.key
和 tls.crt
的資料夾,系統也會設定從 Envoy Proxy 傳送至遠端服務叢集的自訂 SSL 連線。
如果您使用 Istio,並將 Envoy Proxy 當做補充資訊,如未指定目標,系統會產生 httpbin
範例。否則,您須負責準備與目標服務部署作業相關的設定檔。
參數
參數 | 類型 | 說明 |
---|---|---|
-c, --config
|
字串 | (必要) Apigee 遠端服務設定檔的路徑。 提示:這個標記可讓您省略大部分的其他指令參數,因為 CLI 可直接從設定檔提取這些參數。請參閱「 使用 --config 選項」一節。 |
-f, --force
|
強制覆寫現有目錄。 | |
-h, --help
|
顯示指令參數的說明。 | |
--host
|
目標服務主機 (預設為「httpbin.org」) | |
-n, --name
|
目標服務名稱 (預設為「httpbin」) | |
--out
|
要建立範例設定檔的目錄。預設值:./samples |
|
-t, --template
|
範本名稱。如果您要執行 Istio 部署 (僅限混合型),請選取其中一個可用的 Istio 選項。針對原生 Envoy 部署使用原生選項。可用選項包括:
|
|
--tls
|
用來儲存 TLS 金鑰和 crt 檔案的目錄。 |
範例
apigee-remote-service-cli samples create -c ./config.yaml
權杖指令
您可以使用 JWT 權杖來建立通過驗證的 API Proxy 呼叫,而不使用 API 金鑰。權杖指令可讓您建立、檢查及輪替 JWT 權杖,以便達到這個目的。
建立 JWT 權杖
您可以使用 JWT 憑證,對遠端服務目標發出經過驗證的 API Proxy 呼叫。另請參閱使用 JWT 式驗證一文。使用方式
如為 Edge Public Cloud:apigee-remote-service-cli token create -c [config_file] --id [consumer_key] --secret [consumer_secret] -o [org] -e [env]如為 Edge Private Cloud:
apigee-remote-service-cli token create -c [config_file] --id [consumer_key] --secret [consumer_secret] -r [runtime] -o [org] -e [env]
參數
參數 | 類型 | 說明 |
---|---|---|
-c, --config
|
字串 | (必要) Apigee 遠端服務設定檔的路徑。 提示:這個標記可讓您省略大部分的其他指令參數,因為 CLI 可直接從設定檔提取這些參數。請參閱「 使用 --config 選項」一節。 |
-e, --env
|
字串 | (必要) 機構中的環境。 |
-h, --help
|
顯示指令參數的說明。 | |
--insecure
|
使用 SSL 時,允許不安全的伺服器連線。 | |
-o, --org
|
字串 | (必要) Apigee 機構。您必須是機構組織管理員。 |
-r, --runtime
|
字串 | (僅限 Private Cloud) 指定 Private Cloud 執行個體的執行階段網址。 |
-v, --verbose
|
(選用) 產生詳細輸出。 |
範例
apigee-remote-service-cli token create -o myorg -e test -i YUmlZAcBKNsTAelJqPZFl3sh58ObATX9 -s icTARgaKHqvUH1dq -c config.yaml
輸出結果
成功後,您會看到類似以下的 JST 權杖輸出內容:eyJraWQiOiIxIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJhY2Nlc3NfdG9rZW4iOiJ0a2tlVzVKQTY2a0pZYTB4bFV1cVBsUW1BMU43IiwiYXVkIjoiaXN0aW8iLCJuYmYiOjE1MzAxMzg1OTEsImFwaV9wcm9kdWN0X2xpc3QiOlsiaXN0aW8tcHJvZHVjdCJdLCJhcHBsaWNhdGlvbl9uYW1lIjoiaXN0aW8tYXBwIiwiZGV2ZWxvcGVyX2VtYWlsIjoicFluZ2Zsb3lkQGdvb2dsZS5jb20iLCJpc3MiOiJodHRwczovL2FwaWdlZXNlYXJjaC10ZXN0LmFwaWdlZS5uZXQvaXN0aW8tYXV0aC90b2tlbiIsImV4cCI6MTUzMDEzOTQ5MSwiaWF0IjoxNTMwMTM4NTkxLCJqdGkiOiIxODgzMzViZi0wMmE4LTRjZGUsOGFkOS0yMWJmNDZjNmRjZDkiLCJjbGllbnRfaWQiOiJZVW1sWkFjQktOc1RBZWxKcVBZRmwzc2g1OE9iQVRYOSJ9.AL7pKSTmond-NSPRNNHVbIzTdAnZjOXcjQ-BbOJ_8lsQvF7PuiOUrGIhY5XTcJusisKgbCdtIxBl8Wq1EiQ_fKnUc3JYYOqzpTB5bGoFy0Yqbfu96dneuWyzgZnoQBkqwZkbQTIg7WNTGx1TJX-UTePvBPxAefiAbaEUcigX9tTsXPoRJZOTrm7IOeKpxpB_gQYkxQtV1_NbERxjTPyMbHdMWal9_xRVzSt7mpTGudMN9OR-VtQ1uXA67GOqhZWcOzq57qImOiCMbaoKnKUADevyWjX_VscN5ZZUtzQUQhTrmv8aR69-uVhMIPKp9juMyYKaYn2IsYZEeCWfhfV45Q
檢查 JWT 權杖
您可以使用這個指令檢查 JWT 權杖。另請參閱「檢查權杖」。使用方式
如為 Edge Public Cloud:apigee-remote-service-cli token inspect -o [organization] -e [environment] -f [token_file]如為 Edge Private Cloud:
apigee-remote-service-cli token inspect -o [organization] -e [environment] -f [token_file] --runtime [host_alias]
參數
參數 | 類型 | 說明 |
---|---|---|
-c, --config
|
字串 | (必要) Apigee 遠端服務設定檔的路徑。 提示:這個標記可讓您省略大部分的其他指令參數,因為 CLI 可直接從設定檔提取這些參數。請參閱「 使用 --config 選項」一節。 |
-e, --env
|
字串 | (必要) 機構中的環境。 |
-h, --help
|
顯示指令參數的說明。 | |
--insecure
|
使用 SSL 時,允許不安全的伺服器連線。 | |
-o, --org
|
字串 | (必要) Apigee 機構。您必須是機構組織管理員。 |
-r, --runtime
|
字串 | (僅限 Private Cloud) 指定 Private Cloud 執行個體的執行階段網址。 |
-v, --verbose
|
(選用) 產生詳細輸出。 |
範例
apigee-remote-service-cli token inspect -c config.yaml <<< $TOKEN
輸出結果
成功後,畫面會顯示類似以下的輸出內容:{ "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.
輪替 JWT 權杖
初次產生 JWT 後,有時可能需要變更 Apigee Edge 儲存在其加密鍵/值對應 (KVM) 中的公開/私密金鑰組。這個產生新金鑰組的程序稱為金鑰輪替。輪替金鑰時,系統會產生新的私密/公開金鑰組,並儲存在 Apigee Edge 機構/環境中的「istio」KVM 中。此外,系統會保留舊的公開金鑰和原始的金鑰 ID 值。使用方式
如果您使用 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]如果您使用的是 Edge Private Cloud:
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]
參數
參數 | 類型 | 說明 |
---|---|---|
-c, --config
|
字串 | (必要) Apigee 遠端服務設定檔的路徑。 提示:這個標記可讓您省略大部分的其他指令參數,因為 CLI 可直接從設定檔提取這些參數。請參閱「 使用 --config 選項」一節。 |
-e, --env
|
字串 | (必要) 機構中的環境。 |
-h, --help
|
顯示指令參數的說明。 | |
--insecure
|
使用 SSL 時允許不安全的伺服器連線 | |
--truncate
|
int | 要保留的憑證數量 (預設值 2) |
-o, --org
|
字串 | (必要) Apigee 機構。您必須是機構組織管理員。 |
-r, --runtime
|
字串 | (僅限 Private Cloud) 指定 Private Cloud 執行個體的執行階段網址。 |
-v, --verbose
|
(選用) 產生詳細輸出。 |
範例
apigee-remote-service-cli token rotate-cert -c config.yaml -o myorg -e test -k 2e238ffa15dc5ab6a1e97868e7581f6c60ddb8575478582c256d8b7e5b2677a8 -s 51058077223fa7b683c3bea845c5cca138340d1d5583922b6d465f9f918a4b08
輸出結果
certificate successfully rotated
使用 .netrc 提供憑證
如果您位於 Edge Public Cloud 且機器api.enterprise.apigee.com
有項目,則 apigee-remote-service-cli
會從主目錄的 .netrc
檔案自動從主目錄挑選 username
和 password
(在需要進行基本驗證)。如果您使用 Apigee 私有雲,機器值會與 management
網址相同 (例如:http://192.162.55.100
)。
例如,在 Edge Public Cloud 中:
machine api.enterprise.apigee.com login jdoe@google.com password abc123例如,在 Edge Private Cloud 上:
machine http://192.162.55.100 login jdoe@google.com password abc123
版本指令
列印 CLI 版本。
apigee-remote-service-cli version
使用 --config
指令選項
--config
選項會指定由 provision
指令產生的設定檔位置。這個選項的一大優點在於,可讓您略過大多數其他指令參數,後者是 CLI 從設定檔提取而來。這些選項包括:
- 機構
- 環境
- 執行階段
- 管理
- 不安全
- 命名空間
- 舊版
- 蛇夫座
舉例來說,您可以執行 provision
指令,如下所示:
apigee-remote-service-cli provision --config='old-config.yaml' > new-config.yaml
設定檔
本節提供範例設定檔,其中包含所有可用的選項。
global: temp_dir: /tmp/apigee-istio keep_alive_max_connection_age: 10m 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