Skip to content

Latest commit

 

History

History
139 lines (87 loc) · 3.56 KB

README.md

File metadata and controls

139 lines (87 loc) · 3.56 KB

Simplicate Docker Monorepo

This repo provides:

  • Production-ready base images for Python FastAPI and PHP-FPM

  • A unified Makefile for local build/test/push workflows

  • GitHub Actions pipelines for develop vs main branch builds

  • A library of compose.yaml configs for quickly bootstrapping supporting services

📦 Images

1. Python FastAPI

Located in: images/docker-python-fastapi

  • Based on Python 3.13-slim
  • Includes:
    • FastAPI + Uvicorn
    • OpenAI, LangChain, Meilisearch, MinIO
    • NLP libraries (spacy, tiktoken, unstructured)
    • File parsing libraries (PyPDF2, pdfplumber, python-docx, openpyxl, pandas, etc.)
    • Media processing (ffmpeg, moviepy, pydub, vosk)
    • CLI tools: mc (MinIO client), jq, yq, curl, wget, nano
  • Intended as a general-purpose base image for Python APIs and helper services.

2. PHP-FPM (Craft CMS)

Located in: images/docker-php-fpm

  • Based on php:8.3-fpm
  • Includes:
    • Common PHP extensions (gd, intl, ldap, imap, zip, opcache, soap, xsl, etc.)
    • PECL extensions (xdebug, redis, imagick, xmlrpc)
  • Optimized for Craft CMS and other PHP web apps.

🛠 Build & Run

A single Makefile at the project root provides commands to build, run, and push either image.

Environment

  • IMAGE → target image (python-fastapi or php-fpm)
  • VERSION → tag version (dev, 1.0.0, etc.)

Commands

Build

Builds the image locally

make build IMAGE=python-fastapi VERSION=dev

Run

Runs the container locally, exposing port 8000 for FastAPI (or PHP-FPM defaults).

make run IMAGE=python-fastapi VERSION=dev

Shell

Opens an interactive shell inside the container.

make shell IMAGE=php-fpm VERSION=dev

Push to Docker Hub

Pushes the built image to Docker Hub under both :1.0.0 and :latest.

make push IMAGE=python-fastapi VERSION=1.0.0

Test Build

Runs a build and lists the resulting images.

make test-build IMAGE=python-fastapi

GitHub Develop Trigger

Commits and pushes to the develop branch, triggering a CI build (test only).

make push-develop IMAGE=python-fastapi

🚀 CI/CD

develop branch → performs a test build (does not push to Docker Hub).

main branch → performs a full build, tags images with latest and commit SHA, and pushes to Docker Hub.

Images are built for multiple platforms: linux/amd64 and linux/arm64.

🗂 Containers Directory

The containers/ folder contains a curated set of compose.yaml files for quickly spinning up commonly used services.

Current services:

  • meilisearch → Lightning-fast, open-source search engine with a developer-friendly API.
  • miniflux → Minimalist, self-hosted RSS reader with APIs and integrations.
  • minio → S3-compatible object storage, great for local or production use.
  • n8n → Workflow automation platform, similar to Zapier, but self-hosted.
  • plausible → Lightweight, privacy-friendly web analytics alternative to Google Analytics.
  • wallabag → Self-hosted “read-it-later” app for saving and archiving articles.

Usage

Each folder contains a compose.yaml file. To run any service:

docker compose -f containers/<service>/compose.yaml up -d

🔑 Secrets

GitHub Actions workflows require the following secrets set at the repo level:

DOCKERHUB_USERNAME → your Docker Hub username (simplicateca)

DOCKERHUB_TOKEN → a Docker Hub access token with push permissions