search
HomeBackend DevelopmentGolangBuilding an API with AWS SAM and Go

Building an API with AWS SAM and Go

AWS SAM is a great way to deploy web applications via Infrastructure as Code (IAC). I recently tried to use it in my work project and ran into a stark reality...

Go is the ugly duckling of AWS?

The section of the AWS SAM documentation dedicated to Go is very short and vague, recommending repeating our source code extensively ! Every lambda function has a go.mod, go.sum, and utility functions?!

I write this article for you who are as confused as me?‍?. Let's solve this problem together!

This will be a two-part series:

  1. File structure (this article)
  2. SAM Configuration

Go runtime context

Currently, lambda is not supported in the Go runtime. This means that AWS lambda has no specific option to specify that your code is written in Go. Instead, AWS offers 2 common runtimes?:

  • al2 (Amazon Linux 2)
  • al2023 (Amazon Linux 2023)

This refers to the operating system the lambda will run on. It is recommended to use al2023 as it is newer and compatible with AWS Graviton processors which offer better performance at a lower price.

Anyway, these runtimes require us to provide an executable file (usually named bootstrap) that will be executed within each lambda function. So, instead of delivering code to a lambda, we deliver an executable that we previously compiled with Go. Pretty simple, right?

This also eliminates the need for a lambda layer for languages ​​like JS, as all common dependencies will be packaged in the compiled executable.

Question

So, how do we build this executable? AWS recommends that each of our lambdas should be stored in a folder, along with its go.mod and go.sum, and the template they provide looks like this:

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

This is the function definition in 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>

If we look at the Lambda definition, we learn:

  1. BuildMethod: go1.x We use AWS’s built-in Go builder to build the executable for us
  2. CodeUri: hello-world/ lambda code will be stored exclusively in this directory.
  3. Handler: bootstrap The name of the executable will be bootstrap
  4. Runtime: provided.al2023 This will be the runtime.

Do you see the problem? Currently we need a second lambda, we have to create a new directory with its own go.mod, go.sum and dependencies, what if we want to share a utility function between the two lambdas ? Too bad?! You have to copy the same files into the new lambda folder. This leaves a file structure that looks like this:

This is so bad?!
<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>
There is a lot of duplicate code!

And it gets worse the more lambdas we add. There must be a better way!

Solution

Since I want to share go.mod, go.sum and utility code through all lambdas, I came up with this structure:

<code>.
├── hello-world/
│   ├── go.mod
│   ├── go.sum
│   └── main.go
├── events/
│   └── ...
├── samconfig.toml
└── template.yaml</code>
  1. I broke all the public code into the internal/ folder,
  2. Place go.mod and go.sum files in the root directory
  3. Move all lambda entry points to /cmd (there is a convention in Go that whenever a project produces multiple executables, the entry points are placed in the cmd directory)

Now I just need to notify AWS SAM of this new structure?! I found the solution just by adjusting the values ​​of CodeUri and Handler.

Secret?

It seems that if you

  • Move go.mod and go.sum to the root folder
  • Set CodeUri to whatever folder the function entry point is.

SAM will automatically detect it and build with root dependencies and internal/code? ? ?

<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>

Can it be better?

Yes✨, we will discuss more ways to customize Go compilation in the next article!

The above is the detailed content of Building an API with AWS SAM and Go. For more information, please follow other related articles on the PHP Chinese website!

Statement
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn
Choosing Between Golang and Python: The Right Fit for Your ProjectChoosing Between Golang and Python: The Right Fit for Your ProjectApr 19, 2025 am 12:21 AM

Golangisidealforperformance-criticalapplicationsandconcurrentprogramming,whilePythonexcelsindatascience,rapidprototyping,andversatility.1)Forhigh-performanceneeds,chooseGolangduetoitsefficiencyandconcurrencyfeatures.2)Fordata-drivenprojects,Pythonisp

Golang: Concurrency and Performance in ActionGolang: Concurrency and Performance in ActionApr 19, 2025 am 12:20 AM

Golang achieves efficient concurrency through goroutine and channel: 1.goroutine is a lightweight thread, started with the go keyword; 2.channel is used for secure communication between goroutines to avoid race conditions; 3. The usage example shows basic and advanced usage; 4. Common errors include deadlocks and data competition, which can be detected by gorun-race; 5. Performance optimization suggests reducing the use of channel, reasonably setting the number of goroutines, and using sync.Pool to manage memory.

Golang vs. Python: Which Language Should You Learn?Golang vs. Python: Which Language Should You Learn?Apr 19, 2025 am 12:20 AM

Golang is more suitable for system programming and high concurrency applications, while Python is more suitable for data science and rapid development. 1) Golang is developed by Google, statically typing, emphasizing simplicity and efficiency, and is suitable for high concurrency scenarios. 2) Python is created by Guidovan Rossum, dynamically typed, concise syntax, wide application, suitable for beginners and data processing.

Golang vs. Python: Performance and ScalabilityGolang vs. Python: Performance and ScalabilityApr 19, 2025 am 12:18 AM

Golang is better than Python in terms of performance and scalability. 1) Golang's compilation-type characteristics and efficient concurrency model make it perform well in high concurrency scenarios. 2) Python, as an interpreted language, executes slowly, but can optimize performance through tools such as Cython.

Golang vs. Other Languages: A ComparisonGolang vs. Other Languages: A ComparisonApr 19, 2025 am 12:11 AM

Go language has unique advantages in concurrent programming, performance, learning curve, etc.: 1. Concurrent programming is realized through goroutine and channel, which is lightweight and efficient. 2. The compilation speed is fast and the operation performance is close to that of C language. 3. The grammar is concise, the learning curve is smooth, and the ecosystem is rich.

Golang and Python: Understanding the DifferencesGolang and Python: Understanding the DifferencesApr 18, 2025 am 12:21 AM

The main differences between Golang and Python are concurrency models, type systems, performance and execution speed. 1. Golang uses the CSP model, which is suitable for high concurrent tasks; Python relies on multi-threading and GIL, which is suitable for I/O-intensive tasks. 2. Golang is a static type, and Python is a dynamic type. 3. Golang compiled language execution speed is fast, and Python interpreted language development is fast.

Golang vs. C  : Assessing the Speed DifferenceGolang vs. C : Assessing the Speed DifferenceApr 18, 2025 am 12:20 AM

Golang is usually slower than C, but Golang has more advantages in concurrent programming and development efficiency: 1) Golang's garbage collection and concurrency model makes it perform well in high concurrency scenarios; 2) C obtains higher performance through manual memory management and hardware optimization, but has higher development complexity.

Golang: A Key Language for Cloud Computing and DevOpsGolang: A Key Language for Cloud Computing and DevOpsApr 18, 2025 am 12:18 AM

Golang is widely used in cloud computing and DevOps, and its advantages lie in simplicity, efficiency and concurrent programming capabilities. 1) In cloud computing, Golang efficiently handles concurrent requests through goroutine and channel mechanisms. 2) In DevOps, Golang's fast compilation and cross-platform features make it the first choice for automation tools.

See all articles

Hot AI Tools

Undresser.AI Undress

Undresser.AI Undress

AI-powered app for creating realistic nude photos

AI Clothes Remover

AI Clothes Remover

Online AI tool for removing clothes from photos.

Undress AI Tool

Undress AI Tool

Undress images for free

Clothoff.io

Clothoff.io

AI clothes remover

AI Hentai Generator

AI Hentai Generator

Generate AI Hentai for free.

Hot Tools

SecLists

SecLists

SecLists is the ultimate security tester's companion. It is a collection of various types of lists that are frequently used during security assessments, all in one place. SecLists helps make security testing more efficient and productive by conveniently providing all the lists a security tester might need. List types include usernames, passwords, URLs, fuzzing payloads, sensitive data patterns, web shells, and more. The tester can simply pull this repository onto a new test machine and he will have access to every type of list he needs.

EditPlus Chinese cracked version

EditPlus Chinese cracked version

Small size, syntax highlighting, does not support code prompt function

Zend Studio 13.0.1

Zend Studio 13.0.1

Powerful PHP integrated development environment

SublimeText3 English version

SublimeText3 English version

Recommended: Win version, supports code prompts!

PhpStorm Mac version

PhpStorm Mac version

The latest (2018.2.1) professional PHP integrated development tool