This repository demonstrates a production-grade CI/CD pipeline using:

• Docker
• GitHub Actions
• Artifactory (or any container registry)
• Multi-branch strategy

It supports:

• Feature → Dev → Prod promotion
• Tag-based releases
• Automated validation and gating
• Release creation and notifications

• Developers push code to feature/* branches
• PR is created to dev

Triggered when:

• User selects dev environment manually

1. Create a Git tag
2. Build Docker image
3. Push image to Artifactory (dev repo)
4. Create a pre-release
5. Send notification (success/failure)

Triggered when:

• User selects prod environment
• Provides a release tag

• ✅ Tag exists
• ✅ Docker image exists in dev registry
• ✅ Release/tag exists in GitHub

1. Promote Docker image (dev → prod)
2. Create GitHub Release
3. Generate release notes
4. Create PR (dev → main)
5. Send notification

.
├── .github/
│   └── workflows/
│       └── ci.yml
├── app/
│   ├── __init__.py
│   └── routes.py
├── docs/
│   ├── api.md
│   ├── overview.md
│   └── setup.md
├── scripts/
│   ├── run.sh
│   └── test.sh
├── tests/
│   └── test_basic.py
├── Dockerfile
├── docker-compose.yml
├── requirements.txt
├── README.md
└── .dockerignore

docker build -t <repo>:<tag> .
docker push <repo>:<tag>

• Check tag exists
• Check Docker image exists
• Check GitHub release/tag exists

Example:

./scripts/validate.sh <tag>

Instead of rebuilding:

• Pull from dev registry
• Retag
• Push to prod registry

docker pull dev-repo/app:<tag>
docker tag dev-repo/app:<tag> prod-repo/app:<tag>
docker push prod-repo/app:<tag>

You can integrate:

• Email (SMTP)
• Slack
• Teams

Add in GitHub Secrets:

This repository includes a GitHub Actions workflow in .github/workflows/ci.yml that:

• checks out the code
• installs Python dependencies
• runs unit tests with pytest
• builds the Docker image

A docker-compose.yml file is provided for local development:

docker compose up --build

Additional documentation is available in the docs/ folder:

• docs/overview.md — project overview and structure
• docs/setup.md — development, Docker, and test setup
• docs/api.md — endpoint documentation

A simple Flask sample application is available under app/.

This version includes a multi-page site with HTML templates and CSS assets.

Run locally:

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env
set FLASK_APP=app
flask run

Visit:

• http://127.0.0.1:5000/
• http://127.0.0.1:5000/about
• http://127.0.0.1:5000/contact

Build and run with Docker:

docker build -t flask-sample-app .
docker run -p 5000:5000 flask-sample-app

Run with Docker Compose:

docker compose up --build

Run tests:

pip install pytest
pytest

.
├── .github/
│   └── workflows/
│       └── ci.yml
├── app/
│   ├── __init__.py
│   └── routes.py
├── docs/
│   ├── api.md
│   ├── overview.md
│   └── setup.md
├── scripts/
│   ├── run.sh
│   └── test.sh
├── tests/
│   └── test_basic.py
├── Dockerfile
├── docker-compose.yml
├── requirements.txt
├── README.md
├── .dockerignore
└── .gitignore

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

This project demonstrates a real-world Dev → Prod promotion pipeline with: