Skip to content

A GraphQL server build on top of Apollo + Prisma 2. This project is configured to deploy to AWS using AWS CDK.

Notifications You must be signed in to change notification settings

t18n/prisma2-graphql-aws-cdk

Repository files navigation

PRISMA 2 + Apollo 2 + GraphQL with AWS CDK

If you would like to use this project only for testing purpose, rememember to run cdk destroy --profile profile-name to delete the stack afterwards to prevent any unexpected charge. This project is not fully optimized for production

Prerequisites

Getting started

  1. Prepare
  • Run git clone git@github.com:turbothinh/prisma2-graphql-aws-cdk.git
  • Run one-liner command to install yarn cd prisma2-graphql-aws-cdk && yarn && cd cdk yarn && cd ../
  • Note: All cdk commands must be run inside cdk folder

  • Install 2 AWS profiles with command aws configure --profile <profile-name>, profile name can be replaced as you wish, for e.g.
    • 1 programming profile has full IAM permission
    • 1 programming profile to be assigned to custom policy
  • Create a local database and add connection string to .env.development file
  1. Seed database
  • Run yarn env:dev && yarn db:migrate
  • Run yarn db:seed:dev
  • Run yarn generate:photon:dev
  • Run yarn start:dev
  • Open localhost:4000 on browser

Deployment

  • Run yarn build:cdk
  • Go inside cdk folder and run PROFILE=<your-configured-aws-profile> aws:cdk:deploy
  • Go to AWS Console -> CloudFormation to see deployed stack

Removing stack

  • Go inside cdk folder
  • Run cdk destroy --profile <your-configured-aws-profile>
  • Note: AWS CloudFormation sometimes fails to delete resources as they are dependent on the others, I see it happens a lot with RDS and its Subnet. If this causes CloudFormation stack DELETE_FAIL status, try deleting it manually in AWS Console -> RDS -> Database

Development;

  1. Resources

  2. Deploying to Lambda Function

  1. Connect to Database Inside VPC using Bastion server

    • Documentation

    • Find instance id of your Bastian host: AWS Console -> EC2 -> Instances -> Instance ID

    • Prepare ssh public key locally

    • Locate region and availability zone of the Bastian host, then upload SSH key

      aws ec2-instance-connect send-ssh-public-key --region eu-west-2 --instance-id i-0d390c831797b24f2 --availability-zone eu-west-2a --instance-os-user <your-aws-profile> --ssh-public-key file://~/.ssh/id_rsa.pub --profile <your-aws-profile>
    • After uploading, you have 60s to connect to the Bastion via SSH. Find the Public DNS of the Bastion AWS Console -> EC2 -> Instances -> Publish DNS. Afterwards, use username ec2-user to connect via ssh.

      ssh ec2-user@<bastion-public-dns-address>
      

Architecture

Architecture diagram

Bastion is a great way to access resource inside VPC. I initially take that approach to access the database. However, I realized that it would add complexity and cost to the stack. Fortunately, AWS comes with Security Group, which allows you to define what IP can access your resource. I believe Security Group approach is way more handy and flexible. Therefore, feel free to remove the Bastion host from the stack. Remember to update your Database security group with your IP to enable access from host machine.

About

A GraphQL server build on top of Apollo + Prisma 2. This project is configured to deploy to AWS using AWS CDK.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published