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

使用 .zip 封存檔部署 Ruby Lambda 函數

AWS Lambda 函數的程式碼包含一個 .rb 檔案，其中包含函數的處理常式程式碼，以及程式碼所依賴的任何其他相依性 （gems）。若要將此函數程式碼部署到 Lambda，您可以使用部署套件。此套件可以是 .zip 封存檔或容器映像。如需搭配 Ruby 使用容器映像的詳細資訊，請參閱使用容器映像部署 Ruby Lambda 函數。

若要建立 .zip 封存檔的部署套件，您可以使用命令列工具的內建 .zip 封存檔公用程式，或任何其他 .zip 檔案公用程式 (例如 7zip)。以下各節顯示的範例假設您在 Linux 或 MacOS 環境中使用命令列 zip 工具。若要在 Windows 中使用相同命令，您可以安裝適用於 Linux 的 Windows 子系統，以取得 Ubuntu 和 Bash 的 Windows 整合版本。

請注意，Lambda 使用POSIX檔案許可，因此您可能需要在建立 .zip 檔案封存之前設定部署套件資料夾的許可。

以下各節中的範例命令使用 Bundler 公用程式，將相依項新增至部署套件。若要安裝 bundler，請執行下列命令。

gem install bundler

Ruby 中的相依項

對於使用 Ruby 執行期的 Lambda 函數，相依項可以是任何 Ruby gem。使用 .zip 封存部署函數時，您可以使用函數程式碼將這些相依項新增至 .zip 檔案，或使用 Lambda 層。 圖層是單獨的 .zip 檔案，可以包含其他程式碼和內容。若要進一步了解如何使用 Lambda 層，請參閱 使用層管理 Lambda 相依性。

Ruby 執行期包含 AWS SDK for Ruby。如果您的函數使用 SDK，則不需要將其與程式碼綁定。不過，若要維持相依性的完整控制，或使用特定版本的 SDK，您可以將其新增至函數的部署套件。您可以在 .zip SDK檔案中包含 ，或使用 Lambda 層新增。.zip 檔案或 Lambda 層中的相依項優先於執行期中包含的版本。若要了解您的執行期版本中包含哪些SDK版本的 for Ruby，請參閱 包含執行期的SDK版本。

在 AWS  共同責任模式下，您負責管理函數部署套件中的任何相依項。這包括套用更新和安全性修補程式。若要更新函數部署套件中的相依項，請先建立新的 .zip 檔案，然後將其上傳至 Lambda。如需詳細資訊，請參閱 建立含相依項的 .zip 部署套件 和 使用 .zip 檔案建立及更新 Ruby Lambda 函數。

建立不含相依項的 .zip 部署套件

如果您的函數程式碼沒有相依項，則 .zip 檔案只會包含具有函數處理常式程式碼的 .rb 檔案。使用您慣用的 zip 公用程式建立 .zip 檔案，並將 .rb 檔案放在根目錄下。如果 .rb 檔案不在 .zip 檔案的根目錄下，則 Lambda 將無法執行您的程式碼。

若要了解如何部署 .zip 檔案以建立新的 Lambda 函數或更新現有函數，請參閱使用 .zip 檔案建立及更新 Ruby Lambda 函數。

建立含相依項的 .zip 部署套件

如果您的函數程式碼相依於其他 Ruby gem，則您可以使用函數程式碼將這些相依項新增至 .zip 檔案，或使用 Lambda 層。本節中的指示說明如何在 .zip 部署套件中包含相依項。如需如何在層中包含相依項的指示，請參閱為相依項建立 Ruby 層。

假設函數程式碼儲存在專案目錄中名為 lambda_function.rb 的檔案中。下列範例CLI命令會建立名為 的 .zip 檔案，my_deployment_package.zip其中包含您的函數程式碼及其相依性。

為相依項建立 Ruby 層

本節中的指示說明如何在層中包含相依項。如需如何在部署套件中包含相依項的指示，請參閱建立含相依項的 .zip 部署套件。

將層新增至函數時，Lambda 會將層內容載入該執行環境的 /opt 目錄。在每一次 Lambda 執行期中，PATH 變數已包含 /opt 目錄中的特定資料夾路徑。為確保PATH變數擷取您的層內容，您的 layer .zip 檔案應該在以下資料夾路徑中具有其相依性：

例如，您的層 .zip 檔案結構可能如下所示：

json.zip
└ ruby/gems/2.7.0/
               | build_info
               | cache
               | doc
               | extensions
               | gems
               | └ json-2.1.0
               └ specifications
                 └ json-2.1.0.gemspec

此外，Lambda 會自動偵測 /opt/lib 目錄中的程式庫，以及 /opt/bin 目錄中的二進位檔案。若要確保 Lambda 正確找到您的層內容，您也可以建立結構如下的層：

custom-layer.zip
└ lib
    | lib_1
    | lib_2
└ bin
    | bin_1
    | bin_2

封裝層之後，請參閱在 Lambda 中建立和刪除層及為函數新增層，完成層設定。

建立含原生程式庫的 .zip 部署套件

諸如 nokogiri、nio4r 和 mysql 等許多常見 Ruby gem 包含用 C 語言編寫的原生延伸模組。將包含 C 程式碼的程式庫新增至部署套件時，必須正確建置套件，以確保其與 Lambda 執行環境相容。

對於生產應用程式，我們建議您使用 AWS Serverless Application Model （） 建置和部署程式碼AWS SAM。 AWS SAM 使用 sam build --use-container選項，在類似 Lambda 的 Docker 容器中建置函數。若要進一步了解如何使用 AWS SAM 來部署函數程式碼，請參閱 AWS SAM 開發人員指南 中的建置應用程式。

若要建立包含具有原生擴充功能的寶石的 .zip 部署套件，而不需使用 AWS SAM，您也可以使用容器，在與 Lambda Ruby 執行期環境相同的環境中綁定相依項目。若要完成這些步驟，必須在建置電腦上安裝 Docker。若要進一步了解如何安裝 Docker，請參閱 Install Docker Engine。

使用 .zip 檔案建立及更新 Ruby Lambda 函數

建立 .zip 部署套件之後，您可以使用它建立新的 Lambda 函數或更新現有函數。您可以使用 Lambda 主控台、 AWS Command Line Interface和 Lambda 部署 .zip 套件API。您也可以使用 AWS Serverless Application Model  (AWS SAM) 和  AWS CloudFormation 建立並更新 Lambda 函數。

Lambda 的 .zip 部署套件大小上限為 250 MB (解壓縮)。請注意，此限制適用於您上傳的所有檔案 (包括任何 Lambda 層) 的大小總和。

Lambda 執行時間需有許可才能讀取部署套裝服務中的檔案。在 Linux 許可八進位符號中，Lambda 需要 644 個不可執行檔案的許可 （rw-r--r--），以及 755 個目錄和可執行檔案的許可 （rwxr-xr-x）。

在 Linux 和 MacOS 中，使用 chmod 命令變更部署套件中檔案和目錄的檔案許可。例如，若要提供可執行檔正確的許可，請執行下列命令。

chmod 755 <filepath>

若要在 Windows 中變更檔案許可，請參閱 Microsoft Windows 文件的 Set, View, Change, or Remove Permissions on an Object。

透過主控台使用 .zip 檔案建立及更新函數

若要建立新函數，您必須先在主控台中建立函數，然後上傳您的 .zip 封存檔。若要更新現有函數，請開啟函數的頁面，然後按照同樣的程序新增更新後的 .zip 檔案。

如果您的 .zip 檔案小於 50 MB，您可以透過直接從本機電腦上傳檔案來建立或更新函數。若 .zip 檔案大於 50 MB，您必須先將套件上傳至 Amazon S3 儲存貯體。如需如何使用 將檔案上傳至 Amazon S3 儲存貯體的指示 AWS Management Console，請參閱 Amazon S3 入門。若要使用 上傳檔案 AWS CLI，請參閱 AWS CLI 使用者指南 中的移動物件。

使用主控台程式碼編輯器更新 .zip 檔案函數

對於某些具有 .zip 部署套件的函數，您可以使用 Lambda 主控台的內建程式碼編輯器直接更新函數程式碼。若要使用此功能，您的函數必須符合下列條件：

具有容器映像部署套件之函數的函數程式碼無法直接在主控台中編輯。

使用 使用 .zip 檔案建立和更新函數 AWS CLI

您可以使用 AWS CLI 建立新函數，或使用 .zip 檔案更新現有函數。使用 create-function 和 update-function-code 命令來部署 .zip 套件。如果您的 .zip 檔案小於 50 MB，則可以從本機建置電腦的檔案位置上傳 .zip 套件。若檔案較大，則必須先從 Amazon S3 儲存貯體上傳 .zip 套件。如需如何使用 將檔案上傳至 Amazon S3 儲存貯體的指示 AWS CLI，請參閱 AWS CLI 使用者指南 中的移動物件。

若要使用具有 的 .zip 檔案建立新的函數 AWS CLI，您必須指定以下內容：

您也必須指定 .zip 檔案的位置。如果您的 .zip 檔案位於本機建置電腦上的資料夾中，請使用 --zip-file 選項來指定檔案路徑，如下列範例命令所示。

aws lambda create-function --function-name myFunction \
--runtime ruby3.2 --handler lambda_function.lambda_handler \
--role arn:aws:iam::111122223333:role/service-role/my-lambda-role \
--zip-file fileb://myFunction.zip

若要在 Amazon S3 儲存貯體中指定 .zip 檔案的位置，請使用如下列範例命令所示的 --code 選項。您只需針對版本控制的物件使用 S3ObjectVersion 參數。

aws lambda create-function --function-name myFunction \
--runtime ruby3.2 --handler lambda_function.lambda_handler \
--role arn:aws:iam::111122223333:role/service-role/my-lambda-role \
--code S3Bucket=amzn-s3-demo-bucket,S3Key=myFileName.zip,S3ObjectVersion=myObjectVersion

若要使用 更新現有函數CLI，您可以使用 --function-name 參數指定函數的名稱。您也必須指定要用來更新函數程式碼的 .zip 檔案的位置。如果您的 .zip 檔案位於本機建置電腦上的資料夾中，請使用 --zip-file 選項來指定檔案路徑，如下列範例命令所示。

aws lambda update-function-code --function-name myFunction \
--zip-file fileb://myFunction.zip

若要在 Amazon S3 儲存貯體中指定 .zip 檔案的位置，請使用如下列範例命令所示的 --s3-bucket 和 --s3-key 選項。您只需針對版本控制的物件使用 --s3-object-version 參數。

aws lambda update-function-code --function-name myFunction \
--s3-bucket amzn-s3-demo-bucket --s3-key myFileName.zip --s3-object-version myObject Version

使用 Lambda 使用 .zip 檔案建立和更新函數 API

若要使用 .zip 檔案封存建立和更新函數，請使用下列API操作：

使用 .zip 檔案建立和更新函數 AWS SAM

AWS Serverless Application Model （AWS SAM） 是一種工具組，可協助簡化在 上建置和執行無伺服器應用程式的程序 AWS。您可以在 YAML或 JSON 範本中定義應用程式的資源，並使用 AWS SAM 命令列界面 （AWS SAM CLI） 來建置、封裝和部署應用程式。當您從 AWS SAM 範本建置 Lambda 函數時， AWS SAM 會自動使用函數程式碼和您指定的任何相依性建立 .zip 部署套件或容器映像。若要進一步了解如何使用 AWS SAM 建置和部署 Lambda 函數，請參閱 AWS Serverless Application Model 開發人員指南 中的入門 AWS SAM。

您也可以使用 AWS SAM 來使用現有的 .zip 檔案封存來建立 Lambda 函數。若要使用 建立 Lambda 函數 AWS SAM，您可以將 .zip 檔案儲存在 Amazon S3 儲存貯體或建置機器的本機資料夾中。如需如何使用 將檔案上傳至 Amazon S3 儲存貯體的指示 AWS CLI，請參閱 AWS CLI 使用者指南 中的移動物件。

在 AWS SAM 範本中，AWS::Serverless::Function資源會指定您的 Lambda 函數。在本資源中設定下列屬性，以使用 .zip 封存檔建立函數：

使用 AWS SAM時，如果您的 .zip 檔案大於 50MB則不需要先將其上傳至 Amazon S3 儲存貯體。 AWS SAM 可以從本機建置機器的位置上傳 .zip 套件，最大允許大小為 250MB （解壓縮）。

若要進一步了解如何在 中使用 .zip 檔案部署函數 AWS SAM，請參閱 AWS SAM 開發人員指南 中的 AWS：：Serverless：：Function。

使用 .zip 檔案建立和更新函數 AWS CloudFormation

您可以使用 AWS CloudFormation 來使用 .zip 檔案封存建立 Lambda 函數。若要使用 .zip 檔案建立 Lambda 函數，您必須先將檔案上傳至 Amazon S3 儲存貯體。如需如何使用 將檔案上傳至 Amazon S3 儲存貯體的指示 AWS CLI，請參閱 使用者指南中的移動物件。 AWS CLI

在 AWS CloudFormation 範本中，AWS::Lambda::Function資源會指定您的 Lambda 函數。在本資源中設定下列屬性，以使用 .zip 封存檔建立函數：

AWS CloudFormation 產生的 .zip 檔案不得超過 4MB 。若要進一步了解如何在 中使用 .zip 檔案部署函數 AWS CloudFormation，請參閱 AWS CloudFormation 使用者指南 中的 AWS：：Lambda：：Function。