appcfg.sh 指令列參數

appcfg.sh 工具可執行各種應用程式管理工作,包括部署應用程式以及更新資料儲存庫索引appcfg 工具包含在 App Engine SDK 中,您可以在 App Engine Java 8 SDK 下載並安裝。

用法:appcfg.sh [options] <action> [<app-dir>] [<argument>]

<app-dir> 必須是包含 WAR 檔案的目錄。詳情請參閱部署您的應用程式

動作必須是以下其中之一:
help:顯示特定動作的說明訊息。
download_app:下載以前上傳的應用程式版本。
request_logs:以 Apache 通用記錄格式寫下要求記錄。
rollback:復原正在進行的更新。
start_module_version:啟動特定的模組版本。
stop_module_version:停止特定的模組版本。
update:建立或更新應用程式版本。
update_indexes:更新應用程式索引。
update_cron:更新應用程式 cron 工作。
update_queues:更新應用程式工作佇列定義。
update_dispatch:更新應用程式調度設定。
update_dos:更新應用程式 DoS 保護設定。
version:顯示版本資訊。
set_default_version:設定預設的提供版本。
cron_info:顯示每個 Cron 工作接下來數次執行的時間。
resource_limits_info:顯示資源限制。
vacuum_indexes:從應用程式中刪除未使用的索引。
backends list:列出目前已設定的後端。
backends update:更新特定的後端或所有後端。
backends rollback:復原之前正在進行的更新。
backends start:啟動特定的後端。
backends stop:停止特定的後端。
backends delete:刪除特定的後端。
backends configure:設定特定的後端。
list_versions:列出目前已上傳的版本。
delete_version:刪除特定的版本。

使用 'help <action>' 取得詳細說明。

選項:

-s SERVER, --server=SERVER
要連接的伺服器。
-e EMAIL, --email=EMAIL
要使用的使用者名稱,若省略則會提示。
-H HOST, --host=HOST
覆寫所有和 RPC 一起發送的 Host 標頭。
-p PROXYHOST[:PORT], --proxy=PROXYHOST[:PORT]
經由指定的 proxy 伺服器代理的要求。如果還設定了 --proxy_https,則僅代理 HTTP,否則將同時代理 HTTP 和 HTTPS。
--proxy_https=PROXYHOST[:PORT]
經由指定的 proxy 伺服器代理的 HTTPS 要求。
--no_cookies
不將存取憑證儲存到磁碟,或從磁碟載入存取憑證。
--sdk_root=root
覆寫 SDK 所在的位置。
--passin
一律從 stdin 讀取登入密碼。
-A APP_ID, --application=PROJECT_ID
指定專案 ID。
-M MODULE, --module=SERVICENAME
覆寫來自 appengine-web.xmlapp.yaml 檔案的服務名稱 (之前稱為「模組」)。
-V VERSION, --version=VERSION
覆寫來自 appengine-web.xmlapp.yaml 的 (主要) 版本。
--oauth2
忽略 (OAuth2 為預設值)。
--noisy
記錄更多有關於工具正在執行操作的資訊。
--enable_jar_splitting
將大型 jar 檔案 (> 10M) 拆分成較小的片段。
--jar_splitting_excludes=SUFFIXES
設定 --enable-jar-splitting 後,與逗號分隔的 SUFFIXES 清單相符的檔案,將會被排除在所有 jar 檔案之外。
--disable_jar_jsps
不封存從 JSP 產生的類別。
--enable_jar_classes
對 WEB-INF/類別的內容進行封存。
--delete_jsps
編譯後刪除 JSP 來源檔案。
--retain_upload_dir
不刪除上傳時使用的暫時性 (測試環境) 目錄。
--compile_encoding
編譯 JSP 時使用的字元編碼。
-n NUM_DAYS, --num_days=NUM_DAYS
要取得的記錄資料天數。截止點為世界標準時間的午夜。使用 0 可取得所有可用的記錄檔。預設值為 1。
--severity=SEVERITY
要取得的應用程式層級記錄檔訊息嚴重性。範圍為 0 (DEBUG) 至 4 (CRITICAL)。如果省略,僅會傳回要求記錄檔。
--include_all
包含記錄檔訊息的所有內容。
-a, --append
附加至現有的檔案。
-n NUM_RUNS, --num_runs=NUM_RUNS
要計算的已排程執行時間數量。
-f, --force
強制刪除索引且不提示。
--no_usage_reporting
停用使用情形報告。
--use_google_application_default_credentials
使用 https://developers.google.com/identity/protocols/application-default-credentials 中所述的 Google 應用程式預設憑證。
--service_account_json_key_file=path
服務帳戶憑證登入的服務帳戶 json 金鑰檔案的位置 (cloud SDK 使用 ~/.config/gcloud/application_default_credentials.json)。

測試環境設定的 appcfg 指令列替代做法

指令列測試環境選項包含以下內容:

  • --enable_jar_splitting
  • --jar_splitting_excludes=SUFFIXES
  • --disable_jar_jsps
  • --enable_jar_classes
  • --delete_jsps

建議您考慮在應用程式設定檔中進行測試環境設定,而不要使用這些指令列選項。這表示您只要設定一次即可,不必在每次部署時都指定設定。

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Java 8 適用的 App Engine 標準環境