celosop/wordpress repository overview

⁠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⁠.

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

⁠Why use a clearlinux based image?

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
   

   Copy

2. Start wordpress using the examples below:

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

     docker-compose up
     

     Copy

     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
     

     Copy

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

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

   Copy

⁠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
  

  Copy
• 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
  

  Copy

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

1. Create secret password for database.

   kubectl apply -f secret.yaml
   

   Copy

2. Deploy database and wordpress.

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

   Copy

3. Then check if the pods are running well.

   kubectl get pods -o wide
   

   Copy

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}"
   

   Copy

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
   

   Copy

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
   

   Copy

2. Change to the directory of the application:

   cd wordpress/
   

   Copy

3. Build the container image:

   docker build -t clearlinux/wordpress .
   

   Copy

   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⁠