開始使用 的 Terraform 支援 AWS SAM CLI

1. 安裝或升級 AWS SAM CLI

   若要檢查是否已安裝 AWS SAM CLI，請執行下列動作：

   $ sam --version

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

   如需安裝 AWS SAM CLI 及其所有先決條件的說明，請參閱 安裝 AWS SAM CLI。

2. 安裝 Terraform

   若要檢查您是否Terraform已安裝 ，請執行下列動作：

   $ terraform -version

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

3. 安裝 Docker 進行本機測試

   需要 AWS SAM CLIDocker進行本機測試。若要安裝 Docker，請參閱 安裝 Docker 以搭配 使用 AWS SAM CLI。

定義sam metadata資源

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

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

3. 使用 depends_on引數指定null_resource包含 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
       ]
   }

使用 sam 建置建置

1. 從包含Terraform根模組的目錄中，執行下列動作：

   $ sam build --hook-name terraform

2. 若要建置特定的 Lambda 函數或 layer，請執行下列動作

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

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

使用容器建置

1. 建立Dockerfile包含 Terraform、 Python和 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. 使用 AWS SAM CLI--use-container和 --build-image選項執行 sam build命令。

   以下是範例：

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

產生本機計劃檔案

1. 設定 API 字符 – 字符類型將取決於您的存取層級。若要進一步了解，請參閱 Terraform Cloud 文件中的 API 權杖。

2. 設定您的 API 字符環境變數 – 以下是命令列中的範例：

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

3. 取得您的執行 ID – 從 Terraform Cloud主控台，找到您要搭配 使用的Terraform執行 ID AWS SAM CLI。

   執行 ID 位於您執行的 breadcrumb 路徑中。

   

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