Sign inSign up
stateless-wordpress logo

gioamato/stateless-wordpress

By gioamato

•Updated 13 days ago

Image
0

2.4K

gioamato/stateless-wordpress repository overview

⁠Stateless WordPress

Release GitHub Docker Pulls

Minimal, cloud-native, battle-tested WordPress environment meant to be used both in local development and staging/production.

⁠Supported Architectures

Images are published as multi-arch manifests for linux/amd64 and linux/arm64 (e.g. Apple Silicon, AWS Graviton, Raspberry Pi 4/5 with a 64-bit OS). Docker pulls the right variant automatically.

⁠Image Tags

Each image is published under three tags on Docker Hub⁠:

TagExampleMoves when
<image>-alpinewordpress-alpineevery release
<image>-<version>-alpinewordpress-7.1.3-alpineevery release of that upstream WordPress/NGINX version
<image>-<version>-alpine-<commit>wordpress-7.1.3-alpine-83cf25enever: pin this one to roll back or to deploy a known build

A release is published only after both architectures pass the smoke test (see Testing⁠), and only for the images whose directory changed.

⁠Usage

⁠Local Development Environment
# Clone the repo
git clone https://github.com/gioamato/stateless-wordpress.git
cd stateless-wordpress

# Spin it up with Docker Compose
docker compose up -d

# Open your browser and head to http://localhost:8080
# You will find the famous WordPress 5-minute install
⁠Kubernetes
# Deploy with kubectl
kubectl apply -f https://raw.githubusercontent.com/gioamato/stateless-wordpress/master/deploy/kubernetes/deploy.yaml

# The namespace 'stateless-wordpress' is created to host the example resources:
# - 1 Stateful MySQL replica with emptyDir volume (data lost on restart)
# - 3 Stateless WordPress replicas (horizontal scaling)
# - A Secret storing WordPress Enviroment Configuration
# - A Service with type LoadBalancer to expose the app

# Open your browser and head to the service External IP
# You will find the famous WordPress 5-minute install

⁠Testing

Every pull request runs the same checks you can run locally (only Docker is required):

# Lint Dockerfiles, shell scripts and workflows, and check composer.lock is in sync
tests/lint.sh

# Build both images, start the stack and test it end to end:
# env-based PHP/FPM config, WordPress install, bundled plugins/theme/translations,
# FastCGI cache, NGINX access rules and clean PHP/NGINX logs
tests/smoke.sh

The smoke test uses its own Compose project and port (SMOKE_PORT, default 8089), so it can run next to the local development stack.

⁠Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

⁠Credits

⁠License

MIT⁠

Tag summary

Content type

Image

Digest

sha256:24aa83128…

Size

115.3 MB

Last updated

13 days ago

docker pull gioamato/stateless-wordpress:wordpress-7.1.3-alpine-2d1cdcc