開始使用Terraform支援 AWS SAMCLI

1. 安裝或升級 AWS SAMCLI

   要檢查是否已 AWS SAMCLI安裝，請運行以下命令：

   $ sam --version

   如果 AWS SAMCLI已安裝，輸出將顯示版本。若要升級至最新版本，請參閱升級 AWS SAMCLI。

   如需有關安裝 AWS SAMCLI及其所有先決條件的指示，請參閱安裝 AWS SAMCLI。

2. 安裝 Terraform

   要檢查是否已Terraform安裝，請運行以下命令：

   $ terraform -version

   若要安裝Terraform，請參閱Terraform在Terraform登錄中安裝。

3. 安裝進Docker行本地測試

   本地測試Docker的 AWS SAMCLI要求。若要安裝Docker，請參閱安裝泊塢視窗以搭配使用 AWS SAMCLI。

若要定義資sam metadata源

1. 為資源命名，sam_metadata_以將資源識別為sam metadata資源。

2. 在資源triggers區塊內定義 Lambda 成品屬性。

3. 使用null_resourcedepends_on引數指定包含 Lambda 建置邏輯的內容。

   以下是範例範本：

   resource "null_resource" "sam_metadata_..." {
     triggers = {
       resource_name = resource_name
       resource_type = resource_type
       original_source_code = original_source_code
       built_output_path = built_output_path
     }
     depends_on = [
       null_resource.build_lambda_function # ref to your build logic
     ]
   }

   以下是範例sam metadata資源：

   resource "null_resource" "sam_metadata_aws_lambda_function_publish_book_review" {
       triggers = {
           resource_name = "aws_lambda_function.publish_book_review"
           resource_type = "ZIP_LAMBDA_FUNCTION"
           original_source_code = "${local.lambda_src_path}"
           built_output_path = "${local.building_path}/${local.lambda_code_filename}"
       }
       depends_on = [
           null_resource.build_lambda_function
       ]
   }

要建立與山姆構建

1. 從包含Terraform根模塊的目錄中，運行以下命令：

   $ sam build --hook-name terraform

2. 若要建立特定的 Lambda 函數或層，請執行下列命令

   $ sam build --hook-name terraform lambda-resource-id

   Lambda 資源識別碼可以是 Lambda 函數名稱或完整Terraform資源地址，例如aws_lambda_function.list_books或module.list_book_function.aws_lambda_function.this[0]。

若要使用容器建置

1. 建立Dockerfile包含TerraformPython、和Make工具的。您也應該包含您的 Lambda 函數執行階段。

   下面是一個例子Dockerfile：

   FROM public.ecr.aws/amazonlinux/amazonlinux:2
   
   RUN yum -y update \
       && yum install -y unzip tar gzip bzip2-devel ed gcc gcc-c++ gcc-gfortran \
       less libcurl-devel openssl openssl-devel readline-devel xz-devel \
       zlib-devel glibc-static libcxx libcxx-devel llvm-toolset-7 zlib-static \
       && rm -rf /var/cache/yum
   
   RUN yum -y install make \
       && yum -y install zip
   
   RUN yum install -y yum-utils \
       && yum-config-manager --add-repo https://rpm.releases.hashicorp.com/AmazonLinux/hashicorp.repo \
       && yum -y install terraform \
       && terraform --version
   
   # AWS Lambda Builders
   RUN amazon-linux-extras enable python3.8
   RUN yum clean metadata && yum -y install python3.8
   RUN curl -L get-pip.io | python3.8
   RUN pip3 install aws-lambda-builders
   RUN ln -s /usr/bin/python3.8 /usr/bin/python3
   RUN python3 --version
   
   VOLUME /project
   WORKDIR /project
   
   ENTRYPOINT ["sh"]

2. 用docker build來建立您的Docker映像檔。

   以下是範例：

   $ docker build --tag terraform-build:v1 <path-to-directory-containing-Dockerfile>

3. 使用--use-container和--build-image選項執行 AWS SAMCLIsam build命令。

   以下是範例：

   $ sam build --use-container --build-image terraform-build:v1

產生本端平面檔的步驟

1. 配置令API牌 — 令牌的類型將取決於您的訪問級別。若要進一步了解，請參閱Terraform Cloud文件中的 APIToken。

2. 設定 API Token 環境變數 — 以下是命令列中的範例：

   $ export TOKEN="<api-token-value>"

3. 取得您的執行 ID — 從Terraform Cloud主控台，找出您要與之搭配使用的Terraform執行 ID AWS SAMCLI。

   執行 ID 位於執行階段的階層連結路徑中。

   

4. 獲取計劃文件 — 使用API令牌獲取本地計劃文件。以下是命令列中的範例：

   curl \
      --header "Authorization: Bearer $TOKEN" \
      --header "Content-Type: application/vnd.api+json" \
      --location \
      https://app.terraform.io/api/v2/runs/<run ID>/plan/json-output \
      > custom_plan.json