AWS Classic

v4.30.0 published on Tuesday, Nov 30, 2021 by Pulumi

AWS Golang Lambda With API Gateway

View Code

This example creates a lambda that does a simple ToUpper on the path input of an API request and returns it.

Deploying the App

To deploy your infrastructure, follow the below steps.

Prerequisites

  1. Install Pulumi
  2. Configure AWS Credentials
  3. Clone aws-go-lambda

Steps

After cloning this repo, run these commands from the working directory:

  1. Build the handler:

    • For developers on Linux and macOS:

      make build
      
             
      
    • For developers on Windows:

      • Get the build-lambda-zip tool:

        set GO111MODULE=on
        go.exe get -u github.com/aws/aws-lambda-go/cmd/build-lambda-zip
        
               
        
      • Use the tool from your GOPATH:

        set GOOS=linux
        set GOARCH=amd64
        set CGO_ENABLED=0
        go build -o handler\handler handler\handler.go
        %USERPROFILE%\Go\bin\build-lambda-zip.exe -o handler\handler.zip handler\handler
        
               
        
        
  2. Create a new Pulumi stack, which is an isolated deployment target for this example:

    pulumi stack init
    

    ``

  3. Set the required configuration variables for this program:

    $ pulumi config set aws:region us-west-2
    

    ``

  4. Execute the Pulumi program to create our lambda:

    $ pulumi up                              
    Previewing update (dev):
        Type                           Name               Plan       
    +   pulumi:pulumi:Stack            go-lambda-dev      create     
    +   ├─ aws:apigateway:RestApi      UpperCaseGateway   create     
    +   ├─ aws:iam:Role                task-exec-role     create     
    +   ├─ aws:apigateway:Resource     UpperAPI           create     
    +   ├─ aws:iam:RolePolicy          lambda-log-policy  create     
    +   ├─ aws:apigateway:Method       AnyMethod          create     
    +   ├─ aws:lambda:Function         basicLambda        create     
    +   ├─ aws:lambda:Permission       APIPermission      create     
    +   ├─ aws:apigateway:Integration  LambdaIntegration  create     
    +   └─ aws:apigateway:Deployment   APIDeployment      create     
       
    Resources:
        + 10 to create
    
    Do you want to perform this update? yes
    Updating (dev):
        Type                           Name               Status      
    +   pulumi:pulumi:Stack            go-lambda-dev      created     
    +   ├─ aws:apigateway:RestApi      UpperCaseGateway   created     
    +   ├─ aws:iam:Role                task-exec-role     created     
    +   ├─ aws:apigateway:Resource     UpperAPI           created     
    +   ├─ aws:iam:RolePolicy          lambda-log-policy  created     
    +   ├─ aws:apigateway:Method       AnyMethod          created     
    +   ├─ aws:lambda:Function         basicLambda        created     
    +   ├─ aws:apigateway:Integration  LambdaIntegration  created     
    +   ├─ aws:lambda:Permission       APIPermission      created     
    +   └─ aws:apigateway:Deployment   APIDeployment      created     
       
    Outputs:
        invocation URL: "https://<gateway-id>.execute-api.us-west-2.amazonaws.com/prod/{message}"
    
    Resources:
        + 10 created
    
    Duration: 29s
    

    ``

  5. Call our lambda function from the cli:

    curl https://<gateway-id>.execute-api.us-west-2.amazonaws.com/prod/helloworld   
    HELLOWORLD% 
    

    ``

  6. From there, feel free to experiment. Simply making edits, rebuilding your handler, and running pulumi up will update your lambda.

  7. Afterwards, destroy your stack and remove it:

    pulumi destroy --yes
    pulumi stack rm --yes
    

    ``