Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sbstjn/appsync-resolvers-example
Example project for AppSync, GraphQL, and AWS Lambda resolvers using Go.
https://github.com/sbstjn/appsync-resolvers-example
appsync appsync-resolvers aws example go golang graphql lambda resolvers
Last synced: 3 months ago
JSON representation
Example project for AppSync, GraphQL, and AWS Lambda resolvers using Go.
- Host: GitHub
- URL: https://github.com/sbstjn/appsync-resolvers-example
- Owner: sbstjn
- License: mit
- Created: 2018-06-05T06:01:12.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2018-09-18T17:42:06.000Z (over 5 years ago)
- Last Synced: 2024-01-14T08:08:24.761Z (4 months ago)
- Topics: appsync, appsync-resolvers, aws, example, go, golang, graphql, lambda, resolvers
- Language: Go
- Homepage: https://sbstjn.com/serverless-graphql-with-appsync-and-lambda.html
- Size: 166 KB
- Stars: 62
- Watchers: 2
- Forks: 14
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Lists
- awesome-aws-appsync - Serverless Application Model and custom resolver using Lamda with Go
README
# AWS AppSync Resolvers w/ CloudFormation, Lambda & SAM
[](https://github.com/sbstjn/appsync-resolvers-example/blob/master/LICENSE.md)
[](https://sbstjn.com/serverless-graphql-with-appsync-and-lambda.html)
[](https://github.com/sbstjn/appsync-resolvers)
Fully working GraphQL API example project using [appsync-resolvers] for AWS AppSync and *ready to be deployed* with CloudFormation using the [Serverless Application Model]. Includes AWS Lambda functions for custom `Query` and `Field` resolvers written in Go. You only need the `aws` CLI application and no other third-party frameworks! 🎉
See [Serverless GraphQL with AWS AppSync and Lambda](https://sbstjn.com/serverless-graphql-with-appsync-and-lambda.html) on [sbstjn.com](https://sbstjn.com) for a detailed guide how to set up and configure this project. Or just run `make configure build package deploy` and you are ready to go …
## Schema
```graphql
type Person {
id: Int!
name: String!
age: Int!
friends: [Person!]!
}
type Query {
people: [Person!]!
person(id: Int): Person!
}
schema {
query: Query
}
```
## Configuration
The `Makefile` contains all tasks to set up the CloudFormation stack.
```bash
# Install Go dependencies
$ > make install
# Create S3 Bucket to store deploy artifacts
$ > make configure
# Build go binary for AWS Lambda
$ > make build
# Create deployable artifact
$ > make package
# Deploy CloudFormation stack
$ > make deploy
```
## Usage
```bash
# Show CloudFormation stack output
$ > make outputs
[
{
"OutputKey": "APIKey",
"OutputValue": "da2-jlewwo38ojcrfasc3dpaxqgxcc",
"Description": "API Key"
},
{
"OutputKey": "GraphQL",
"OutputValue": "https://3mhugdjvrzeclk5ssrc7qzjpxn.appsync-api.eu-west-1.amazonaws.com/graphql",
"Description": "GraphQL URL"
}
]
```
### Send GraphQL Requests
#### Request list of all people
```bash
$ > curl \
-XPOST https://3mhugdjvrzeclk5ssrc7qzjpxn.appsync-api.eu-west-1.amazonaws.com/graphql \
-H "Content-Type:application/graphql" \
-H "x-api-key:da2-jlewwo38ojcrfasc3dpaxqgxcc" \
-d '{ "query": "query { people { name } }" }' | jq
```
```json
{
"data": {
"people": [
{
"name": "Frank Ocean"
},
{
"name": "Paul Gascoigne"
},
{
"name": "Uwe Seeler"
}
]
}
}
```
#### Request specific person
```bash
$ > curl \
-XPOST https://3mhugdjvrzeclk5ssrc7qzjpxn.appsync-api.eu-west-1.amazonaws.com/graphql \
-H "Content-Type:application/graphql" \
-H "x-api-key:da2-jlewwo38ojcrfasc3dpaxqgxcc" \
-d '{ "query": "query { person(id: 2) { name friends { name } } }" }' | jq
```
```json
{
"data": {
"person": {
"name": "Paul Gascoigne",
"friends": [
{
"name": "Frank Ocean"
}
]
}
}
}
```
## License
Feel free to use the code, it's released using the [MIT license](LICENSE.md).
## Contribution
You are welcome to contribute to this project! 😘
To make sure you have a pleasant experience, please read the [code of conduct](CODE_OF_CONDUCT.md). It outlines core values and beliefs and will make working together a happier experience.
[appsync-resolvers]: https://github.com/sbstjn/appsync-resolvers
[Serverless Application Model]: https://github.com/awslabs/serverless-application-model