https://github.com/davenchy/depi-project

An automated CI/CD pipeline designed to streamline the development, testing, and deployment process.
https://github.com/davenchy/depi-project

ansible automation bun ci ci-cd cicd devop docker gogs graduation-project jenkins pipeline react

Last synced: 20 days ago
JSON representation

An automated CI/CD pipeline designed to streamline the development, testing, and deployment process.

• Host: GitHub
• URL: https://github.com/davenchy/depi-project
• Owner: Davenchy
• Created: 2024-10-14T20:28:11.000Z (22 days ago)
• Default Branch: main
• Last Pushed: 2024-10-16T06:55:22.000Z (21 days ago)
• Last Synced: 2024-10-17T09:27:33.221Z (20 days ago)
• Topics: ansible, automation, bun, ci, ci-cd, cicd, devop, docker, gogs, graduation-project, jenkins, pipeline, react
• Language: CSS
• Homepage:
• Size: 43 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# DevOps Pipeline DEPI Project

This project is an automated CI/CD pipeline designed to streamline the development, testing, and deployment process. It integrates Gogs, Jenkins, Ansible, and Docker for source code management, continuous integration, and automated deployment. With each push to the repository, a Jenkins pipeline is triggered to run tests, build Docker images, and deploy the application to a production server. Ansible is used for server configuration and deployment automation, while Slack notifications provide real-time pipeline status updates.

The application itself is based on a default Vite + React + TypeScript template, generated using `bun create vite my-app --template react-swc-ts`. A `tests/` directory with a basic passing test case has been added to demonstrate the testing stage.

All DevOps-related code is located in the `devops/` directory. For more details, see the [DevOps Docs](devops/README.md).

This project was developed as part of a team graduation project in the [Digital Egypt Pioneers Initiative - DEPI](https://depi.gov.eg/) DevOps track.

---

## Resources

- **Docker Image:** `davenchy/depi-project:latest`

- **Slides:** Will be added soon.

- **Infrastructure Representation Image:** Will be added soon.

## Tools

- **Jenkins**: Automates the CI/CD pipeline.

- **Ansible**: Automates server configuration and deployment.

- **Gogs**: Source Code Management (SCM) tool.

  > Why Gogs? It’s lightweight, easy to use, and handles both source code management and webhook-based pipeline triggers.

  > GitLab CE was considered but was too resource-heavy for a local machine with modest capabilities.

- **Bun**: A TypeScript runtime used for package management (instead of npm), testing, and building/bundling.

- **Docker**: The backbone of the infrastructure, used to containerize all services.

## Jenkins Plugins

- **docker-workflow**: Enables Docker integration in the pipeline to run Bun and build deployment images.

- **ansible**: Enables the use of Ansible within the pipeline.

- **gogs-webhook**: Triggers the Jenkins pipeline on Gogs webhook requests.

- **slack**: Sends notifications to Slack for pipeline updates.