使用 AWS SAM 和 Go 建置 API

AWS SAM是透過基礎架構即程式碼（IAC）部署Web應用程式的絕佳方式。我最近嘗試在我的工作項目中使用它，但遇到了一個嚴峻的現實…

Go是AWS的醜小鴨 ?

AWS SAM文件中專門介紹Go的部分非常簡短且含糊不清，建議大量重複我們的原始碼！每個lambda函數都有一個go.mod、go.sum和實用函數?！

我寫這篇文章是為了像我一樣迷惘的你?‍?。讓我們一起解決這個問題！

這將是一個兩部分的系列：

1. 文件結構（本文）
2. SAM配置

Go運行時的上下文

目前，lambda的Go運行時不受支援。這意味著AWS lambda沒有特定選項來指定您的程式碼是用Go編寫的。相反，AWS提供2個通用運行時?：

• al2（Amazon Linux 2）
• al2023（Amazon Linux 2023）

這指的是lambda將要運作的作業系統。建議使用al2023，因為它更新，並且與AWS Graviton處理器相容，後者可以以更低的價格提供更好的性能。

無論如何，這些運行時要求我們提供一個可執行檔（通常命名為bootstrap），該檔將在每個lambda函數中執行。 因此，我們不是向lambda交付程式碼，而是交付我們之前用Go編譯的可執行檔。很簡單，對吧？

這也消除了像JS這樣的語言需要使用lambda層的必要性，因為所有常見的依賴項都將打包在已編譯的可執行檔中?。

問題

那麼，我們要如何建立該執行檔呢？ AWS建議我們每個lambda都應該儲存在一個資料夾中，以及它的go.mod和go.sum，他們提供的範本如下所示：

<code>.
├── hello-world/
│   ├── go.mod
│   ├── go.sum
│   └── main.go
├── events/
│   └── ...
├── samconfig.toml
└── template.yaml</code>

這是template.yaml中的函數定義

<code>  HelloWorldFunction:
    Type: AWS::Serverless::Function 
    Metadata:
      BuildMethod: go1.x
    Properties:
      CodeUri: hello-world/
      Handler: bootstrap
      Runtime: provided.al2023
      Architectures:
        - x86_64
      Events:
        CatchAll:
          Type: Api
          Properties:
            Path: /hello
            Method: GET</code>

如果我們查看Lambda定義，我們會了解到：

1. BuildMethod: go1.x 我們使用AWS內建的Go建構器來為我們建立執行檔
2. CodeUri: hello-world/ lambda程式碼將專門儲存在這個目錄中。
3. Handler: bootstrap 執行檔的名稱將是bootstrap
4. Runtime: provided.al2023 這將是運行時。

你看到問題了嗎？目前我們需要第二個lambda，我們必須創建一個帶有自己go.mod、go.sum和依賴項的新目錄，如果我們想在兩個lambda之間共享一個實用函數怎麼辦？太糟糕了?！你必須將相同的檔案複製到新的lambda資料夾中。留下一個看起來像這樣的文件結構：

<code>.
├── function1/
│   ├── go.mod
│   ├── go.sum
│   ├── main.go
│   └── SHAREDFUNC.go
├── function2/
│   ├── go.mod
│   ├── go.sum
│   ├── main.go
│   └── SHAREDFUNC.go
├── events/
│   └── ...
├── samconfig.toml
└── template.yaml</code>

這太糟糕了?！ 有很多重複的程式碼！ 並且隨著我們添加的lambda越多，它會變得更糟。一定有更好的方法！

解決方案

由於我想透過所有lambda共享go.mod、go.sum和實用程式程式碼，我想出了這個結構：

<code>.
├── hello-world/
│   ├── go.mod
│   ├── go.sum
│   └── main.go
├── events/
│   └── ...
├── samconfig.toml
└── template.yaml</code>

1. 我將所有公用程式碼分解到internal/資料夾中，
2. 將go.mod和go.sum檔放在根目錄中
3. 將所有lambda入口點移到/cmd（在Go中存在這種約定，每當專案產生多個可執行檔時，入口點都放在cmd目錄中）

現在我只需要通知AWS SAM這個新的結構?！我只是透過調整CodeUri和Handler的值找到了解決方案。

秘密?

似乎如果你

• 將go.mod和go.sum移到根資料夾
• 將CodeUri設定為函數入口點所在的任何資料夾。

SAM將自動偵測它並使用根依賴項和internal/程式碼進行建構? ? ?

<code>  HelloWorldFunction:
    Type: AWS::Serverless::Function 
    Metadata:
      BuildMethod: go1.x
    Properties:
      CodeUri: hello-world/
      Handler: bootstrap
      Runtime: provided.al2023
      Architectures:
        - x86_64
      Events:
        CatchAll:
          Type: Api
          Properties:
            Path: /hello
            Method: GET</code>

可以更好嗎？

是的✨，我們將在下一篇文章中討論更多自訂Go編譯的方法！

以上是使用 AWS SAM 和 Go 建置 API的詳細內容。更多資訊請關注PHP中文網其他相關文章！