Skip to content

fs/rails-base-graphql-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

API application template using Rails and GraphQL

Getting Started

Scripts

  • bin/setup - install required packages and gems locally and prepare DB

  • bin/server - to run server locally

  • bin/tests - runs RSpec tests

  • bin/quality - runs quality tools

  • bin/docker-setup - build Docker image and prepare DB

  • bin/docker-server - to run server locally via Docker

  • bin/docker-tests - runs RSpec tests via Docker

  • bin/docker-quality - runs quality tools via Docker

  • bin/docker-sync - install docker-sync library to speed up performance on Mac OSX

Staging Environments

GraphQL query base path

https://rails-base-graphql-api.herokuapp.com/graphql

Apps and extensions for GraphQL

  1. Electron-based wrapper around GraphQL GraphiQL
  2. Chrome extension Altair GraphQL Client

How to start working with GraphQL:

  1. Choose your favorite tool for working with GraphQL
  2. Create a request for signup to get access and refresh tokens
# query
mutation SignUp($input: SignupInput!) {
  signup(input: $input) {
    me {
      id
      email
    }
    accessToken
    refreshToken
  }
}

# query variables
{
  "input": {
	"email": "john.tolkien@example.com",
  	"password": "654321",
  	"firstName": "John",
  	"lastName": "Tolkien"
  }
}
  1. Use this token to send the following requests. Token sent to the "Authorization" in the header

Header example

Authorization: Bearer <token>

Bootstrap and run application

  1. Clone application repository
git clone git://github.com/fs/rails-base-graphql-api.git --origin rails-base-graphql-api [MY-NEW-PROJECT]

Create your new repo on GitHub and push master into it. Make sure master branch is tracking origin repo.

git remote add origin git@github.com:[MY-GITHUB-ACCOUNT]/[MY-NEW-PROJECT].git
git push -u origin master
  1. Run docker-sync setup script (optional, for Mac OSX users)
bin/docker-sync
  1. Run setup script
bin/setup

or if you'd like to use Docker:

bin/docker-setup
  1. Run test and quality suits to make sure all dependencies are satisfied and applications works correctly before making changes.
bin/tests
bin/quality

or with Docker:

bin/docker-tests
bin/docker-quality
  1. Run application
bin/server

or

bin/docker-server

Useful commands to work with Docker

Run rails c console:

docker-compose exec app bin/rails c

Connect to postgres:

docker-compose exec app bin/rails db # password: "password"

View Rails logs:

docker-compose logs app

Github registry

We use Github Packages to store docker images. To use them you need to create Personal Access Token with the appropriate scopes(read_packages - to download images, write_packages - to upload). Authenticate to GitHub Packages with docker using docker login command:

cat ~/TOKEN.txt | docker login https://docker.pkg.github.com -u USERNAME --password-stdin

where TOKEN.txt - file with personal access token and USERNAME - your GitHub username

After that you can download docker image with the docker pull command:

docker pull docker.pkg.github.com/fs/rails-base-graphql-api/final:TAG_NAME

where TAG_NAME - name of the branch

To upload docker image use docker push command:

docker push docker.pkg.github.com/fs/rails-base-graphql-api/final:TAG_NAME

More details about image uploading you can find at GitHup Packages docs

Semaphore CI

To use GitHub Packages on Semaphore CI you can store Personal Access Token as the secret. After that add it to your .semaphore.yml config:

secrets:
  - name: github-docker-secrets

About

Base Rails application for GraphQL API

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages