Skip to content

ACM's Website Mono-Repository. Inside contains submodules for all micro-frontend and micro-backend apis

License

Notifications You must be signed in to change notification settings

UCMercedACM/ACM

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

96 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ACM


ACM's Website Mono-Repository. Inside contains submodules for all micro-frontend and micro-backend apis

Prequisities

  1. Docker version

    $ docker -v
    Docker version 19.03.8, build afacb8b
  2. Docker Compose version

    $ docker-compose -v
    docker-compose version 1.25.4, build 8d51620a

Getting Started

  1. git submodule init
  2. git submodule update
  3. The whole project runs on multiple docker containers on a shared network. You can find all off the development yaml files in the root of this repository.

Deciding Which Environment to Run

Chapter Website

docker-compose.web-lite.yml

A simple container meant to only load the chapter-website, the catch is the environment configuration. Which runs the site in production mode.

Chapter Website + APIs + Postgres

docker-compose.web-full.yml

Contains

  • Chapter Website, ACM UCM's main website written in Angular 9 on the Ivy Framework with NgRx for state management
  • Half-Dome, Backend Server written in Nodejs with Express to handle all requests related to information of our members
  • Cathedral, Backend Server written in Python with Flask to handle all requests related to information of our projects
  • Tenaya, Backend Server written in Go with the GoFiber Framework to handle all requests related to information of our events
  • Tuolomne, Backend Server written in PHP with the Laravel Framework to handle all requests related to information of our workshops
  • Mariposa, Backend Server written in Java with the Maven Framework to handle all requests related to information of our LAN parties

ELK Stack + APM

docker-compose.elk-lite.yml

Contains

Elk Stack

ELK Stack + APM + Curator + Logspout + Enterprise Search

docker-compose.elk-lite.yml

Contains

ELK Stack

Prometheus + Grafana + Node Exporter + Cadvisor

docker-compose.grafana.yml

Contains

Run the Project with Docker Compose

Below is a list of possible combinations to run the ACM Website locally

Website with all API Services

  1. Run the root yaml compose file docker-compose -p "ACM Chapter Website" -f docker-compose.web-full.yml up -d
  2. To create all tables to store data on run the bash script with this command chmod +x database_setup.sh && ./database_setup.sh

Note: When running the project this way all applications opens on http://localhost:<portNumber>

To check if they are setup correctly:

  1. Docker Compose

    $ docker-compose ps
         Name                    Command              State            Ports
    ---------------------------------------------------------------------------------
    Chapter-Website   docker-entrypoint.sh yarn  ...   Up      0.0.0.0:4200->4200/tcp
    Half-Dome         docker-entrypoint.sh yarn  ...   Up      0.0.0.0:4201->4201/tcp
    Tuolumne          docker-php-entrypoint php  ...   Up      0.0.0.0:4202->4202/tcp
    Tenaya            go run main.go                   Up      0.0.0.0:4203->4203/tcp
    pgadmin           /entrypoint.sh                   Up      443/tcp, 0.0.0.0:8080->80/tcp
    postgres          docker-entrypoint.sh postgres    Up      0.0.0.0:35432->5432/tcp
  2. Docker

    $ docker ps
    CONTAINER ID        IMAGE                  COMMAND                  CREATED             STATUS             PORTS                           NAMES
    bcdd8cab6353        chapter-website:v0.1   "docker-entrypoint.s…"   3 minutes ago       Up 3 minutes       0.0.0.0:4200->4200/tcp          Chapter-Website
    36a54a443c24        half-dome:v1.1         "docker-entrypoint.s…"   3 minutes ago       Up 3 minutes       0.0.0.0:4201->4201/tcp          Half-Dome
    29ace3f0ea26        tuolumne:v1.0          "docker-php-entrypoi…"   3 minutes ago       Up 3 minutes       0.0.0.0:4202->4202/tcp          Tuolumne
    f970a1f44851        tenaya:v1.0            "go run main.go"         3 minutes ago       Up 3 minutes       0.0.0.0:4203->4203/tcp          Tenaya
    2b7e5a24c88a        dpage/pgadmin4         "/entrypoint.sh"         3 minutes ago       Up 3 minutes       443/tcp, 0.0.0.0:8080->80/tcp   pgadmin
    2d3f4c37df54        postgres:12.2-alpine   "docker-entrypoint.s…"   3 minutes ago       Up 3 minutes       0.0.0.0:35432->5432/tcp         postgres

Debugging Issues

Containers not Updating with New Code

  1. Recreate Containers

    $ docker-compose -f docker-compose.web-full.yml up -d --force-recreate
    Recreating pgadmin         ... done
    Recreating postgres        ... done
    Recreating Half-Dome       ... done
    Recreating Tuolumne        ... done
    Recreating Tenaya          ... done
    Recreating Chapter-Website ... done
    Attaching to pgadmin, postgres, Half-Dome, Toulumne, Tenaya, Chapter-Website
    ...
  2. Rebuild Containers

    $ docker-compose -f docker-compose.web-full.yml up -d --build
    Building half-dome
    ...
    Successfully built ce4b7e44d100
    Successfully tagged docker_half-dome:latest
    Building chapter-website
    ...
    Successfully built 6955801be2ec
    Successfully tagged docker_chapter-website:latest
    Starting postgres ... done
    Recreating Half-Dome ... done
    Recreating Chapter-Website ... done
    Attaching to postgres, Half-Dome, Chapter-Website

    Rebuilding a specific container: docker-compose -p "ACM Chapter Website" up -d --build --no-deps <service-name> Reinstalling dependencies of a specific container: docker-compose -p "ACM Chapter Website" up -d --build --no-deps --force-recreate <service-name>

  3. netstat

    $ netstat -lna | grep '4200\|4201\|4202\|4203\|8080\|35432'
    tcp46      0      0  *.4200                 *.*                    LISTEN
    tcp46      0      0  *.4201                 *.*                    LISTEN
    tcp46      0      0  *.4202                 *.*                    LISTEN
    tcp46      0      0  *.4203                 *.*                    LISTEN
    tcp46      0      0  *.8080                 *.*                    LISTEN
    tcp46      0      0  *.35432                *.*                    LISTEN

Manually Checking the Postgres Database

Via Commnad Line

Run docker exec -it postgres psql -U docker acm after you have started up any of the compose files to sift through the database.

Via Browser

Open localhost:8080 and punch in the email and password

Note: if running this locally the default email is [email protected] and the default password is PgAdmin2020!

Cleaning Up When Done Developing or Trying to Reset Your Environment

$ docker system prune --volumes
WARNING! This will remove:
  - all stopped containers
  - all networks not used by at least one container
  - all volumes not used by at least one container
  - all dangling images
  - all dangling build cache

Are you sure you want to continue? [y/N] y
...
Total reclaimed space: __GB

About

ACM's Website Mono-Repository. Inside contains submodules for all micro-frontend and micro-backend apis

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published