https://github.com/WonderPanda/nestjs-microservice-architecture

A reference architecture for building microservices with Nest
https://github.com/WonderPanda/nestjs-microservice-architecture

graphql microservice nestjs node typescript

Last synced: about 1 month ago
JSON representation

A reference architecture for building microservices with Nest

• Host: GitHub
• URL: https://github.com/WonderPanda/nestjs-microservice-architecture
• Owner: WonderPanda
• Created: 2018-09-12T17:30:53.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2019-03-25T20:38:34.000Z (almost 6 years ago)
• Last Synced: 2024-12-01T07:45:05.578Z (about 1 month ago)
• Topics: graphql, microservice, nestjs, node, typescript
• Language: TypeScript
• Homepage:
• Size: 202 KB
• Stars: 198
• Watchers: 8
• Forks: 31
• Open Issues: 6
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        


  



[travis-image]: https://api.travis-ci.org/nestjs/nest.svg?branch=master

[travis-url]: https://travis-ci.org/nestjs/nest

[linux-image]: https://img.shields.io/travis/nestjs/nest/master.svg?label=linux

[linux-url]: https://travis-ci.org/nestjs/nest

  
A progressive Node.js framework for building efficient and scalable server-side applications, heavily inspired by Angular.

    




















  

  



  


# Nestjs Microservice Architecture

## Project Goals

This project aims to demonstrate a real world example application of a microservice architecture leveraging best of class Node and Typescript tooling.

## Running the Project

### Docker

Docker is awesome.

Just use `docker-compose up -d` at the root of the repository. Once the services are running you the API can be viewed at

`localhost:4200/graphql`

If you'd prefer to only run the backend data services (currently Redis and RabbitMQ) so you can hack on the Nest services, just use the data only compose file.

`docker-compose -f docker-compose.data-only.yml up -d`

### Locally

Make sure that you've copied over the `.env.example` file for each service into `.env` so that the services can be configured properly.

### Making changes to Services

If you've made a change to a service and want to redeploy it with docker compose without bringing down the other services,

just use `docker-compose up -d --no-deps --build ` where serviceName is one of the named services from the

docker-compose.yml file.

## GraphQL

GraphQL is a query language for your API, and a server-side runtime for executing queries by using a type system you define for your data. GraphQL isn't tied to any specific database or storage engine and is instead backed by your existing code and data.

This project uses GraphQL as the glue between microservices and is therefore agnostic to the datastores used be the individual services.

An example query that can be executed in the playground at `http://localhost:4200/graphql` is

```

{

  getCatalogItems {

    id

    name

    description

    price

  }

}

```