diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..e15f11c --- /dev/null +++ b/Dockerfile @@ -0,0 +1,27 @@ +FROM ubuntu +MAINTAINER Jeffery Russell + +# install all dependencies +RUN apt-get update && \ + apt-get upgrade -y && \ + apt-get install -y build-essential && \ + apt-get install -y sudo curl && \ + curl -sL https://deb.nodesource.com/setup_13.x | sudo -E bash - && \ + apt-get install -y nodejs && \ + apt-get update && \ + apt-get clean + +# Create a working directory for the container +RUN mkdir /github-graphs + +# copy files from the directory of the Dockerfile to the docker container +COPY /server /github-graphs/server +COPY README.md /github-graphs/ +COPY LICENSE /github-graphs/ + +# setup working directory to the default in the container +WORKDIR /github-graphs/server + +# Install dependencies and start the program at RUN +RUN npm install +ENTRYPOINT ["node", "server.js"] diff --git a/README.md b/README.md index 7e527f6..77a9824 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,7 @@ If you are lucky, you can find the site live [here](https://github-graphs.com/). ![javascript](./doc/javaScript.jpg) -## Native Deployment +## Deployment The easiest way to get started with Github-Graphs is to fork this repository and follow the instructions below. @@ -25,13 +25,13 @@ and follow the instructions below. The objective of creating an app under your github account is to access an endpoint through the GitHub API and obtain credentials to set your environment -file. For directives on how to create a new OAuth app, consult the corresponding +file. For more information on how to create a new OAuth app, consult the corresponding Github developer documentation [here](https://developer.github.com/apps/building-oauth-apps/creating-an-oauth-app/). #### Create a .env file -Setup your environment credentials by creating a `.env file` inside the folder -`/server` with the code below filled in. +After forking this repository, run the command `cd server/`. Inside that folder, +setup your environment credentials by creating a `.env file` with the code below filled in. ``` CLIENT_ID = @@ -40,34 +40,60 @@ SESSION_SECRET = PORT = ``` +The creation of your OAuth app and the .env file are required steps, +irrespective of your desired deployment environment. For specific directions, +continue by following the steps specified below. + +### Deployment on the local machine + #### Install dependencies Dependencies are installed using `npm`. Therefore, please install the package manager before proceeding. If you already have `npm` installed, run the command below inside -`/server` in order to install the dependencies in the package directory. +`server/` in order to install the dependencies in the package directory. ```bash npm install ``` -#### Activate GitHub-Graphs +#### Explore GitHub-Graphs -Inside `/server`, run the following command to start the program, and in your +Inside `server/`, run the following command to start the program, and in your browser, check `localhost:8000` to visualize your Github network. ```bash node server.js ``` +### Deployment in a Docker container + +Github-graphs can also be deployed inside a docker container and displayed in +your browser through port mapping. To get started run the following commands +inside your forked repository. + +``` + docker build -t graph-app . + docker run -d --name github-graphs -p : graph-app +``` + +If you are willing to read the debugging statement on the CLI, do not add `-d` to the `docker run` statement. + +At this step, you can now visualize Github graphs at `localhost:`. + + ## Contributing -We are very open to new contributors. If you want to contribute to this project, and don't know where to start, look at the [open issues](https://github.com/jrtechs/github-graphs/issues). Once you know what you want to work on, comment on the issue and file a pull request. +We are very open to new contributors. If you want to contribute to this project, +and don't know where to start, look at the [open issues](https://github.com/jrtechs/github-graphs/issues). +Once you know what you want to work on, comment on the issue and file a pull request. ## API Reference `GET https://github-graphs.com/api/friends/` -Fetches `https://api.github.com/users//followers` [(GitHub Reference)](https://developer.github.com/v3/users/followers/#list-followers-of-a-user) and `https://api.github.com/users//following` [(GitHub Reference)](https://developer.github.com/v3/users/followers/#list-users-followed-by-another-user) to generate an array of users following `` and that `` follows each with values `login` and `avatar_url`. +Fetches `https://api.github.com/users//followers` [(GitHub Reference)](https://developer.github.com/v3/users/followers/#list-followers-of-a-user) +and `https://api.github.com/users//following` [(GitHub Reference)](https://developer.github.com/v3/users/followers/#list-users-followed-by-another-user) +to generate an array of users following `` and that `` follows each with values `login` and `avatar_url`. Example result: @@ -115,7 +141,8 @@ Example result: `GET https://github-graphs.com/api/org/users/` -Fetches `https://api.github.com/orgs//members` [(GitHub Reference)](https://developer.github.com/v3/orgs/members/#members-list) to generate an array of users that are in `` each with values `login` and `avatar_url`. +Fetches `https://api.github.com/orgs//members` [(GitHub Reference)](https://developer.github.com/v3/orgs/members/#members-list) +to generate an array of users that are in `` each with values `login` and `avatar_url`. Example result: @@ -132,7 +159,8 @@ Example result: `GET https://github-graphs.com/api/org/repositories/` -Fetches `https://api.github.com/orgs//repos` [(GitHub Reference)](https://developer.github.com/v3/repos/#list-organization-repositories) to return an array of repositories `` owns. +Fetches `https://api.github.com/orgs//repos` [(GitHub Reference)](https://developer.github.com/v3/repos/#list-organization-repositories) +to return an array of repositories `` owns. Example result: