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

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

sam init

此頁面提供 AWS Serverless Application Model 命令列介面的參考資訊 （AWS SAM CLI） sam init命令。

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

用量

$ sam init <options>

選項

--app-template TEXT

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

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

此參數僅適用於 AWS SAM CLI 0.30.0 版及更新版本。使用較早版本指定此參數會導致錯誤。

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

為您的應用程式啟用 Amazon CloudWatch Application Insights 監控。如需進一步了解，請參閱 使用 CloudWatch 應用程式洞察來監控您的 AWS SAM 無伺服器應用。

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

--architecture, -a [ x86_64 | arm64 ]

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

--base-image [ amazon/dotnet8-base | amazon/dotnet6-base | amazon/dotnetcore3.1-base | amazon/go1.x-base | amazon/java21-base | amazon/java17-base | amazon/java11-base | amazon/java8.al2-base | amazon/java8-base | amazon/nodejs20.x-base | amazon/nodejs18.x-base | amazon/nodejs16.x-base | | amazon/python3.12-base | amazon/python3.11-base | amazon/python3.10-base | amazon/python3.9-base | amazon/python3.8-base | amazon/ruby3.3-base | amazon/ruby3.2-base ]

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

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

--config-env TEXT

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

--config-file PATH

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

--debug

開啟偵錯記錄以列印偵錯訊息， AWS SAM CLI 會產生 和 以顯示時間戳記。

--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已指定 ，且未--app-template提供 --runtime、 和 --name，則需要此參數。

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

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

--name, -n TEXT

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

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

--no-input

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

--no-interactive

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

--output-dir, -o PATH

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

--package-type [ Zip | Image ]

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

--runtime, -r [ dotnet8 | dotnet6 | dotnetcore3.1 | go1.x | java21 | java17 | java11 | java8 | java8.al2 | nodejs20.x | nodejs18.x | nodejs16.x | python3.12 | python3.11 | python3.10 | python3.9 | python3.8 | ruby3.3 | ruby3.2 ]

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

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

--save-params

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

--tracing | --no-tracing

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

範例

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