upperroomtechnology/docker-img-rabbitmq repository overview

⁠UpperRoom DevOps

This respository provides all devops tools for UpperRoom application.

⁠Third-party Accounts

⁠Digital Ocean

We are using

• Dashboard: Digital Ocean console⁠
• Login credentials: Shared from Lastpass

⁠Docker Hub

• Dashboard: Docker Hub⁠
• Login credentials: Shared from Lastpass

⁠AWS

We are using

• Dashboard: AWS Console⁠
• Superuser: [email protected]⁠
• Password: Shared from Lastpass

⁠Rancher

We are using

• Dashboard: Rancher⁠
• Superuser: admin
• Password: Shared from Lastpass

⁠Requirements

---

• Docker⁠

  • An open platform for distributed applications for developers and sysadmins.

• Docker Compose⁠

  • Compose is a tool for defining and running multi-container Docker applications.

• Docker Hub⁠

  • Docker Hub is a cloud-based registry service which allows you to link to code repositories, build your images and test them, stores manually pushed images, and links to Docker Cloud so you can deploy images to your hosts. It provides a centralized resource for container image discovery, distribution and change management, user and team collaboration, and workflow automation throughout the development pipeline.
  • Image Repositories: Find, manage, and push and pull images
  • Automated Builds

• Rancher⁠

  • Rancher is a complete, open source platform for deploying and managing containers in production. It includes commercially-supported distributions of Kubernetes, Mesos, and Docker Swarm, making it easy to run containerized applications on any infrastructure.
  • Rancher makes running Docker on any infrastructure simple and scalable.

⁠Scripts

---

⁠Build scripts

⁠bin/build.sh

• Builds all docker images specified in docker-compose.xml.
  • upperroomtechnology/app-api:develop
  • upperroomtechnology/postgres:develop
  • upperroomtechnology/nginx:develop
  • upperroom/app-web:develop

⁠Run scripts

⁠bin/run.sh

This scripts runs the local development environment with all services. The followings will be run:

• admin: The django web admin. The server can be accessed at http://localhost:8000/admin/⁠, with username is admin and password is 123456.

• api: The restful apis provided for the frontend. The server can be accessed at http://localhost:8001/api/v1/?schema⁠.

• db: The postgresql database.

• rabbitmq: The rabbitmq server. This server is required as the celery's background jobs.

• nginx: The nginx server that will proxy other services. It provides a way to mimic non-local setup. In order to test, you would need to add the following to /etc/hosts.

  After that you will be able to access https://api.localhost.com/api/v1/user⁠ and https://admin.localhost.com/admin⁠. It is really important to notes that those urls are running with https protocol at default port.

• web: The main web app. The server can be accessed at http://localhost:3000/⁠.

⁠bin/run-admin.sh

• Runs the admin service. This will also runs the db and rabbitmq services. It will automatically also trigger database migration.

⁠bin/run-api.sh

• Runs just the api service. It is suggested to run bin/run.sh or bin/run-admin.sh before running this to make sure database migration is performed.

⁠bin/run-web.sh

• Runs just the web service. It will automatically also trigger api and admin service.

⁠bin/run-design.sh

• Runs just the design service. This will be helpful to check out the latest HTML/CSS design.

⁠Ssh scripts

⁠bin/ssh-api.sh

• This ssh into the api container.

⁠bin/ssh-admin.sh

• This ssh into the admin container.

⁠bin/ssh-nginx.sh

• This ssh into the nginx container.

⁠bin/ssh-web.sh

• This ssh into the web container.

⁠bin/run-algorithm.sh

• This will run the algorithm stack on your local.

⁠bin/build-rabbitmq.sh

• Build RabbitMQ image for pub/sub model.

⁠Deployment document

Deployment guideline⁠