https://github.com/myselfakashagarwal/pweb
Three.js Portfolio website with containerised & continuous- dev , build & delivery pipeline
https://github.com/myselfakashagarwal/pweb
cicd docker jenkins nginx threejs
Last synced: 3 months ago
JSON representation
Three.js Portfolio website with containerised & continuous- dev , build & delivery pipeline
- Host: GitHub
- URL: https://github.com/myselfakashagarwal/pweb
- Owner: myselfakashagarwal
- Created: 2024-02-23T10:57:19.000Z (over 2 years ago)
- Default Branch: new
- Last Pushed: 2025-12-27T20:54:23.000Z (7 months ago)
- Last Synced: 2025-12-29T19:17:05.883Z (7 months ago)
- Topics: cicd, docker, jenkins, nginx, threejs
- Language: HTML
- Homepage: http://akash.hackctl.com/
- Size: 27.2 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## About
A web development codebase integrated with a modularized CI/CD pipeline.
## Components
- **Develop** – Dev codebase running via Docker Compose, mimicking production for development.
- **Build** – Jenkins with build and push jobs using Docker-in-Docker (DIND) to build and push artifacts.
- **Deploy** – Pulling the artifact and running it.
- **Update** – A background service that updates to newer versions automatically.
### Develop
The website is built using [Three.js](https://threejs.org/), a WebGL framework. For development purposes, Docker Compose is used to mount the codebase along with environment variables and configurations, providing features such as hot reload.
### Build
Jenkins and Docker are used together in a multi-stage build process. Jenkins jobs like `pweb_build` (which uses the host's Docker daemon to build the artifact) and `pweb_push` (which pushes the build to a defined registry) are mounted during the artifact build.
### Deploy & Update
A cloud VM instance with Docker is kept running with two containers:
- One for the deployable build created in the build phase.
- The other for **Watchtower**, which handles automatic deployments. It monitors the registry and pulls new builds (on push), replacing the old versions with the same configurations and performing graceful shutdowns.
## Working
The entire pipeline is abstracted in `pweb.yml`, a Docker Compose file with multiple configured environments. Profiles are defined to spawn different environments as needed—such as `development` for local development, `build` for the build phase, and `deploy` and `update` for deployment on the cloud.
## Use
(assumed user in present inside the cloned repo)
To spawn the environment ANY
```bash
docker-compose -f pweb.yml --profile ${DESIRED-ENV} up
```
To spawn the environment for development
```bash
docker-compose -f pweb.yml --profile development up
```
To spawn the environment for creatinfg and pushing builds
```bash
docker-compose -f pweb.yml --profile build up
```
To spawn complete pipeline
```
docker-compose -f pweb.yml --profile pweb up
```