Open-Source WordPress Infrastructure on Kubernetes

For a more thorough documentation check the hosted docs.

• WordPress Operator & WordPress Runtime
• MySQL Operator
• Prometheus Operator
• Nginx Controller
• Cert Manager

The project is actively maintained and developed and has reached stable beta state. Check the complete list of releases here. The Presslabs Stack currently runs on Google Cloud Kubernetes Engine and we also have a documented viable deployment flow for Minikube/Docker on Mac/Docker on Windows.

Tiller needs to be initialized in your Kubernetes cluster, eg run helm init

Add the Presslabs helm charts repo:

helm repo add presslabs https://presslabs.github.io/charts
helm repo update

Cert Manager is a requirement for Stack because it depends on certificates in order to setup it's the environment. The official installation documentation can be found here.

kubectl create namespace cert-manager
helm repo add jetstack https://charts.jetstack.io
helm repo update

# Helm v3+
helm install \
  cert-manager jetstack/cert-manager \
  --namespace presslabs-system \
  --version v0.15.2 \
  --set installCRDs=true

# Helm v2
helm install \
  --name cert-manager \
  --namespace presslabs-system \
  --version v0.15.2 \
  jetstack/cert-manager \
  --set installCRDs=true

We collect all necessary CRDs in one place so you can install them.

If you are installing Stack in a different namespace than presslabs-system then you have to download those manifests and change the namespace from this location with the new target namespace.

kustomize build github.com/presslabs/stack/deploy/manifests | kubectl apply -f-

Or, you can use old manifests file deploy/manifests/00-crds.yaml, which, BTW, is deprecated and we recommend to use the first method:

kubectl apply -f https://raw.githubusercontent.com/presslabs/stack/master/deploy/manifests/00-crds.yaml

The Stack also depends on the Kubernetes Application CRD. The following command will install the application CRD. You may also want (this is optional) to install the Application Controller, see the install guide.

kubectl apply -f https://raw.githubusercontent.com/kubernetes-sigs/application/v0.8.3/config/crd/bases/app.k8s.io_applications.yaml

The rest of the Stack can be installed using helm (version 2 or 3). There are many possible platforms where it can be installed. We provide presets for production and development environments.

For GKE is required to have at least three nodes for running components and also have some room for deploying a site. For testing out and playground g1-small should suffice.

helm upgrade -i stack presslabs/stack --namespace presslabs-system -f https://raw.githubusercontent.com/presslabs/stack/master/presets/gke.yaml

Ensure a larger Minikube with eg, minikube start --cpus 4 --memory 8192 to provide a working local environment.

helm upgrade -i stack presslabs/stack --namespace presslabs-system -f https://raw.githubusercontent.com/presslabs/stack/master/presets/minikube.yaml

helm upgrade -i mysite presslabs/wordpress-site --set 'site.domains[0]=www.example.com'

Issues are being tracked here.
We will also gladly accept pull requests.

You can find more detailed information about the contributing process on the docs page.