dockerfiles/wordpress

Clear Linux* OS wordpress container image

What is this image?

clearlinux/wordpress is a Docker image with wordpress running on top of the official clearlinux base image.

wordpress is a free and open source blogging tool and a content management system (CMS) based on PHP and MySQL, which runs on a web hosting service.

For other Clear Linux* OS based container images, see: https://hub.docker.com/u/clearlinux

Why use a clearlinux based image?

Clear Linux* OS is an open source, rolling release Linux distribution optimized for performance and security, from the Cloud to the Edge, designed for customization, and manageability.

Clear Linux* OS based container images use:

• Optimized libraries that are compiled with latest compiler versions and flags.
• Software packages that follow upstream source closely and update frequently.
• An aggressive security model and best practices for CVE patching.
• A multi-staged build approach to keep a reduced container image size.
• The same container syntax as the official images to make getting started easy.

To learn more about Clear Linux* OS, visit: https://clearlinux.org.

Deployment:

Deploy with Docker

The easiest way to get started with this image is by simply pulling it from Docker Hub.

*Note: This container is compatible with the official wordpress image (fpm tag). It usually works together with containers mysql(mariadb) and nginx.

1. Pull the image from Docker Hub:

   docker pull clearlinux/wordpress
   

2. Start wordpress using the examples below:

   • Use docker-compose to start the wordpress/nginx/mariadb in one-shot:

     docker-compose up
     

     The configuration is defined in the docker-compose.yml

   • List wordpress containers info:

     docker container ls
     
     CONTAINER ID     IMAGE                       PORTS                  NAMES
     
     eff987d8f6e9     clearlinux/nginx:latest     0.0.0.0:8080->80/tcp   wordpress_nginx_1
     738f71a6e7fa     clearlinux/wordpress:latest 9000/tcp               wordpress_wordpress_1
     deaa8614ce8d     clearlinux/mariadb:latest   3306/tcp               wordpress_db_1
     

3. Edit web/blog in wordpress: Open one brower to connect the wordpress blog with URL below.

   http://host-ipaddr:8080/wp-login.php
   

Deploy with Kubernetes

This image can also be deployed on a Kubernetes cluster, such as minikube.The following example YAML files are provided in the repository as reference for Kubernetes deployment:

• pv-local.yaml, pvc-local.yaml: local persistent volumes for databse and wordpress.
• nfs-deployment.yaml, pvc-nfs.yaml: nfs provisioner and volumes for database and wordpress, modified from nfs
• mysql-deployment.yaml: database deployment for wordpress.
• wordpress-deployment.yaml: example wordpress plus nginx as web server.

The example utilies nginx, mariadb and wordpress containers. All are Clear Linux published ones on official clearlinux base image. To deploy the image on a Kubernetes cluster you have two volumes configuration choices:

• Use local volume, not appropriate for scaling on multi-node cluster.

  kubectl apply -f pv-local.yaml
  kubectl apply -f pvc-local.yaml
  

• Use nfs volume, capable for scaling on multi-node cluster.

  kubectl apply -f rbac.yaml
  kubectl apply -f nfs-deployment.yaml
  kubectl apply -f pvc-nfs.yaml
  

Once the persistent volumes got created, you can continue the wordpress deployment.

1. Create secret password for database.

   kubectl apply -f secret.yaml
   

2. Deploy database and wordpress.

   kubectl apply -f mysql-deployment.yaml
   kubectl apply -f wordpress-deployment.yaml
   

3. Then check if the pods are running well.

   kubectl get pods -o wide
   

4. Get wordpress PORT and IP

   kubectl get -o jsonpath="{.spec.ports[0].nodePort}" services wordpress
   kubectl get nodes -o jsonpath="{.items[0].status.addresses[0].address}"
   

5. Edit web/blog in wordpress: Open one brower to connect the wordpress blog with PORT and IP got on step 2.

   http://$IP:$PORT
   

If using nfs volumes, you can scale the wordpress depolyment.

kubectl scale deployments/wordpress --replicas=4

There are two scripts for deploy/clean the wordpress in one-shot command.

• Use local volume, deploy-local.sh.

./deploy-local.sh          # deploy the wordpress
./deploy-local.sh down     # destroy and clean the wordpress

• Use nfs volume, deploy-nfs.sh.

./deploy-nfs.sh          # deploy the wordpress
./deploy-nfs.sh down     # destroy and clean the wordpress

Build and modify:

The Dockerfiles for all Clear Linux* OS based container images are available at https://github.com/clearlinux/dockerfiles. These can be used to build and modify the container images.

1. Clone the clearlinux/dockerfiles repository.

   git clone https://github.com/clearlinux/dockerfiles.git
   

2. Change to the directory of the application:

   cd wordpress/
   

3. Build the container image:

   docker build -t clearlinux/wordpress .
   

   Refer to the Docker documentation for default build arguments. Additionally:

   • swupd_args - specifies arguments to pass to the Clear Linux* OS software manager. See the swupd man pages for more information.

Licenses

All licenses for the Clear Linux* Project and distributed software can be found at https://clearlinux.org/terms-and-policies