1. Packages
  2. AWS
  3. How-to Guides
  4. AWS Golang Lambda With API Gateway
AWS v6.63.0 published on Wednesday, Dec 4, 2024 by Pulumi

AWS Golang Lambda With API Gateway

aws logo
AWS v6.63.0 published on Wednesday, Dec 4, 2024 by Pulumi

    View Code Deploy this example with Pulumi

    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
      
    aws logo
    AWS v6.63.0 published on Wednesday, Dec 4, 2024 by Pulumi