sam init - AWS Serverless Application Model
用量選項範例

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

sam init

此頁面提供 AWS Serverless Application Model Command Line Interface (AWS SAMCLI) sam init命令的參考資訊。

sam init 命令提供初始化新無伺服器應用程式的選項。

用量

$ sam init <options>

選項

--app-template TEXT

您要使用之受管應用程式範本的識別符。如果您不確定，請針對互動式工作流程呼叫 ，sam init而不使用選項。

如果指定 --location 且未提供 --no-interactive ，則需要此參數。

此參數僅適用於 0.30.0 版和更新 AWS SAMCLI版本。使用舊版指定此參數會導致錯誤。

--application-insights | --no-application-insights

為您的應用程式啟用 Amazon CloudWatch Application Insights 監控。如需詳細資訊，請參閱 使用 CloudWatch Application Insights 監控無 AWS SAM 伺服器應用程式。

預設選項為 --no-application-insights。

--architecture, -a [ x86_64 | arm64 ]

應用程式 Lambda 函數的指示集架構。指定 x86_64或 之一arm64。

--base-image [ amazon/dotnet8-base | amazon/dotnet6-base | amazon/java21-base | amazon/java17-base | amazon/java11-base | amazon/nodejs22.x-base | amazon/nodejs20.x-base | amazon/nodejs18.x-base | amazon/nodejs16.x-base | amazon/python3.13-base | amazon/python3.12-base | amazon/python3.11-base | amazon/python3.10-base | amazon/python3.9-base | amazon/python3.8-base | amazon/ruby3.4-base | amazon/ruby3.3-base | amazon/ruby3.2-base ]

您應用程式的基礎映像。此選項僅適用於套件類型為 時Image。

如果指定 --no-interactive 、--package-type指定為 ，且未指定 Image，則此參數--location為必要。

--config-env TEXT

環境名稱，指定組態檔案中要使用的預設參數值。預設值為「預設值」。如需關於組態檔案的詳細資訊，請參閱 AWS SAMCLI 組態檔案。

--config-file PATH

組態檔案的路徑和檔案名稱，其中包含要使用的預設參數值。預設值為專案目錄根目錄中的 "samconfig.toml"。如需關於組態檔案的詳細資訊，請參閱 AWS SAMCLI 組態檔案。

--debug

開啟偵錯記錄以列印 AWS SAMCLI產生的偵錯訊息，並顯示時間戳記。

--dependency-manager, -d [ gradle | mod | maven | bundler | npm | cli-package | pip ]

Lambda 執行時間的相依性管理員。

--extra-content

覆寫範本cookiecutter.json組態中的任何自訂參數，例如 {"customParam1": "customValue1", "customParam2":"customValue2"}。

--help, -h

顯示此訊息並結束。

--location, -l TEXT

範本或應用程式位置 (Git、Mercurial、HTTP/HTTPS、.zip 檔案、路徑）。

如果已--no-interactive指定 ，且未提供 --runtime、 和 --name，則此參數--app-template為必要。

對於 Git 儲存庫，您必須使用儲存庫根的位置。

對於本機路徑，範本必須是 .zip 檔案或 Cookiecutter 格式。

--name, -n TEXT

要產生為目錄的專案名稱。

如果指定 --location 且未提供 --no-interactive ，則需要此參數。

--no-input

停用 Cookiecutter 提示，並接受範本組態中定義的 vcf 預設值。

--no-interactive

停用啟動參數的互動式提示，如果缺少任何必要的值，則失敗。

--output-dir, -o PATH

輸出初始化應用程式的位置。

--package-type [ Zip | Image ]

範例應用程式的套件類型。 Zip會建立 .zip 檔案封存，並Image建立容器映像。

--runtime, -r [ dotnet8 | dotnet6 | java21 | java17 | java11 | nodejs22.x | nodejs20.x | nodejs18.x | nodejs16.x | python3.13 | python3.12 | python3.11 | python3.10 | python3.9 | python3.8 | ruby3.4 | ruby3.3 | ruby3.2 ]

應用程式的 Lambda 執行時間。此選項僅適用於套件類型為 時Zip。

如果指定 --no-interactive 、--package-type指定為 ，且未指定 Zip，則此參數--location為必要。

--save-params

將您在命令列提供的參數儲存至 AWS SAM 組態檔案。

--tracing | --no-tracing

為您的 Lambda 函數啟用 AWS X-Ray 追蹤。

範例

如需使用 sam init子命令的詳細範例和深入演練，請參閱 在 中建立您的應用程式 AWS SAM。