https://github.com/liamross/appsync-terraform-go-example
An example Terraform configuration to launch an AppSync service with a Go Lambda data source
https://github.com/liamross/appsync-terraform-go-example
Last synced: 5 months ago
JSON representation
An example Terraform configuration to launch an AppSync service with a Go Lambda data source
- Host: GitHub
- URL: https://github.com/liamross/appsync-terraform-go-example
- Owner: liamross
- Created: 2020-12-13T18:12:23.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2020-12-15T00:09:21.000Z (over 5 years ago)
- Last Synced: 2024-06-19T02:08:10.376Z (almost 2 years ago)
- Language: HCL
- Homepage:
- Size: 8.79 KB
- Stars: 8
- Watchers: 4
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AppSync Terraform Go example
An example [Terraform](https://www.terraform.io/) configuration to launch an [AWS AppSync](https://aws.amazon.com/appsync/) service with a [Go](https://golang.org/) Lambda data source.
This repo is the complete code example from a blog post I wrote called [Easy AWS AppSync with Terraform](https://elopmental.dev/easy-appsync-with-terraform/).
> Note: the Makefile may only run on macOS/linux, if you are on Windows you may
> need to build the Go lambda function another way.
### About the contents of this repo:
- Lambda functions are in the `/functions` directory
- Apache Velocity resolver templates are inside the `/resolvers` directory
- The GraphQL schema is in `schema.graphql`
- All Terraform config is within the following 3 files:
- `variables.tf` has variables used throughout the rest of the config
- `iam.tf` contains AWS IAM roles and policies
- `main.tf` contains the code for generating all other required services
### Before publishing:
1. [Download Terraform](https://www.terraform.io/downloads.html)
1. Have an existing local AWS credentials profile (this is required so Terraform has the permissions to publish your AWS service)
1. Have Go installed (required to run commands to build the Go lambda function)
1. Open `variables.tf` and set them to whatever you want
> Note: if you want your state to persist, remove the line from `.gitignore` that says `*.tfstate`. This state is essential to keep track of your AWS resources in order to successfully update or destroy them.
### To publish:
Warning: this will fall within the free tier for AWS, however if you have had your account for longer than 1 year you may be charged a small amount for executing AppSync queries since the free tier for AppSync is only 12 months. If you still want to deploy it, the cost should be minimal (cents, not dollars).
1. Run `terraform init` to initialize terraform and fetch all the resources
1. Run `make build` to build the Go lambda function binary
1. Run `terraform plan` to view the diff and all the created resources
1. Run `terraform apply` to publish (it will prompt you to type "yes" to confirm)
> Once this is done you can view your [AppSync console](https://console.aws.amazon.com/appsync/home) and run queries to test that the Lambda data source is working!
### To destroy
1. Run `terraform destroy` to remove all AWS services (it will prompt for "yes" again)