sam package

命 AWS Serverless Application Model 令列介面 (AWS SAM CLI) 封裝 AWS SAM 應用程式。

此命令會建立程式碼和相依性的.zip檔案，並將檔案上傳到 Amazon Simple Storage Service (Amazon S3)。 AWS SAM 為 Amazon S3 中存放的所有檔案啟用加密功能。接著會傳回 AWS SAM 範本的副本，將本機成品的參考取代為命令上傳成品的 Amazon S3 位置。

依預設，當您使用此命令時， AWS SAMCLI會假設您目前的工作目錄是專案的根目錄。 AWS SAMCLI第一個嘗試尋找使用sam build命令建置的範本檔案，位於.aws-sam子資料夾中，並命名為template.yaml。接下來， AWS SAMCLI會嘗試尋找名為template.yaml或目前工作目錄template.yml中的樣板檔案。如果您指定--template選項， AWS SAMCLI則會覆寫預設行為，而且只會封裝該 AWS SAM 範本及其指向的本機資源。

注意

sam deploy現在會以隱含方式執行的sam package功能。您可以直接使用sam deploy命令來封裝和部署應用程式。

用量

$ sam package <arguments> <options>

引數

資源 ID

要封裝的 Lambda 函數識別碼。

此為選用引數。如果您的應用程式包含單一 Lambda 函數， AWS SAM CLI 將會封裝它。如果您的應用程式包含多個函數，請提供函數的 ID 以封裝單一函數。

有效值：資源的邏輯 ID 或資源 ARN。

選項

--config-env TEXT

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

--config-file PATH

包含要使用的預設參數值的組態檔案的路徑和檔案名稱。默認值是項目目錄的根目錄中的「samconfig.toml」。如需關於組態檔案的詳細資訊，請參閱 AWS SAMCLI配置文件。

--debug

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

--force-upload

覆寫 Amazon S3 儲存貯體中的現有檔案。指定此旗標以上傳成品，即使它們符合 Amazon S3 儲存貯體中的現有成品。

--help

顯示此訊息並結束。

--image-repository TEXT

Amazon Elastic Container Registry (Amazon ECR) 存儲庫的 URI，此命令可以在其中上傳您的函數的映像。對於使用Image封裝類型宣告的函數是必要的。

--kms-key-id TEXT

用於加密 Amazon S3 儲存貯體中靜態成品的 AWS Key Management Service (AWS KMS) 金鑰識別碼。如果未指定此選項，則 AWS SAM 使用 Amazon S3 受管加密金鑰。

--metadata

(選擇性) 要附加至範本中參照之所有人工因素的中繼資料對映。

--no-progressbar

將成品上傳到 Amazon S3 時，請勿顯示進度列。

--output-template-file PATH

指令寫入封裝範本的檔案路徑。如果您未指定路徑，命令會將範本寫入標準輸出。

--profile TEXT

從您的認證檔案取得 AWS 認證的特定設定檔。

--region TEXT

要部署的 AWS 區域。例如 us-east-1。

--resolve-s3

自動建立用於包裝的 Amazon S3 儲存貯體。如果同時指定--s3-bucket和--resolve-s3選項，則會導致錯誤。

--s3-bucket TEXT

此命令會上傳您的成品的 Amazon S3 儲存貯體的名稱。如果您的成品大於 51,200 個位元組，則需要使用--s3-bucket或--resolve-s3選項。如果同時指定--s3-bucket和--resolve-s3選項，則會導致錯誤。

--s3-prefix TEXT

新增至上傳至 Amazon S3 儲存貯體的成品名稱的前置詞。前置詞名稱是 Amazon S3 儲存貯體的路徑名稱 (資料夾名稱)。這僅適用於使用Zip包類型聲明的函數。

--save-params

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

--signing-profiles LIST

(選擇性) 用來簽署部署套件的簽署設定檔清單。此參數會取得索引鍵值配對的清單，其中索引鍵是要簽署的函數或層的名稱，而該值是簽署設定檔，其中選用的設定檔擁有者以分隔。:例如 FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner。

--template-file, --template, -t PATH

AWS SAM 樣板所在的路徑和檔案名稱。

注意

如果您指定此選項，則只會 AWS SAM 封裝範本及其指向的本機資源。

--use-json

為 AWS CloudFormation 範本輸出 JSON。依預設會使用 YAML。