a0viedo / nodezoo-system

A preconfigured set of scripts to run nodezoo via fuge

nodezoo-system

• Lead: Dean McDonnell
• Sponsor: nearForm

This repo contains all the required config to spin up a Nodezoo system. The included services represents a production level micro-services system and includes monitoring and user management. Follow the instructions below to set up the system on your machine.

Nodezoo is a search engine for node modules. It is an example of a real-world service built using Node.js micro-services. Each micro-service is published in its own github repository along with all of the necessary config to run the system locally or live . The codebase is intended to be used as an example, and as a starting point for your own projects.

Installation Guide

1. Install fuge

To make use of this repo you need to have fuge installed, you can do this via npm,

npm install -g fuge

Note: Fuge 0.6.1 or later is required

2. Install Docker

You need the ability to run docker and for it to be active in your session to run this system. Please see Docker's instructions for more detail on how to install it for your system. To test if docker is available for fuge to make use of, type the following into your terminal,

docker ps -a

If you are prompted with an error saying cannot connect to docker daemon, run the following command:

docker-machine start default

If this command doesn't return a TLS connection issue you are good to go otherwise the following command should connect Docker to your session,

eval $(docker-machine env default)

Try the docker command above again, you should now see some form of output and not the original TLS error.

Running this system causes containers to be created and ran via docker. If you need to stop and/or remove docker containers, the commands are as follows

docker stop $(docker ps -a)
docker rm $(docker ps -a)

3. Get the System

Each dependent repo will be cloned automatically, to get started clone this repo locally,

git clone https://github.com/nodezoo/nodezoo-system

4. Install your dependencies

In the ./nodezoo-system folder run,

npm install

5. Build the system

Copy the ./sample.env file to ./system.env and edit the environment variables as needed.

In the ./nodezoo-system folder run,

fuge build fuge/system.yml

6. Insert GitHub token

For the GitHub service to work you must create the file system.env in the fuge/env directory and copy the entire contents of sample.env to it. You then insert your GitHub personal access token into system.env.

7. Start the infrastructure

In the ./nodezoo-system folder, in a second terminal window run,

docker-compose -f fuge/infrastructure.yml up

8. Start the system

In the ./nodezoo-system folder run,

fuge shell fuge/system.yml

Note: You must run infrastructure using infrastructure.yml before running the system.

Note: The Nodezoo web app is available at 8000.

Contributing

The NodeZoo org encourages open and safe participation.

• Code of Conduct

If you feel you can help in any way, be it with documentation, examples, extra testing, or new features please get in touch.

License

Copyright (c) 2016, Dean McDonnell and other contributors. Licensed under MIT.