Wordpress-alpine-php Docker Image

This is a WordPress Docker image which can run on both Azure Web App on Linux and your Docker engines's host.

Components

This docker image currently contains the following components:

1. WordPress
2. Nginx (1.15.8)
3. PHP (7.3.4)
4. MariaDB ( 10.1.38/if using Local Database )
5. Phpmyadmin ( 4.8.4/if using Local Database )

How to configure to use Azure Database for MySQL with web app

1. Create a Web App for Containers
2. Browse your site
3. Complete WordPress install and Enter the Credentials for Azure database for MySQL

How to configure GIT Repo and Branch

1. Create a Web App for Containers
2. Add new App Settings

Name	Default Value
GIT_REPO	https://github.com/azureappserviceoss/wordpress-azure
GIT_BRANCH	linux_appservice

4. Browse your site

Note: GIT directory: /home/site/wwwroot.

Note: When you deploy it first time, Sometimes need to check wp-config.php. RM it and re-config DB information is necessary.

Note: Before restart web app, need to store your changes by "git push", it will be pulled again after restart.

How to configure to use Local Database with web app

1. Create a Web App for Containers
2. Update App Setting WEBSITES_ENABLE_APP_SERVICE_STORAGE = true (If you like to keep you DB after restart.)
3. Add new App Settings

Name	Default Value
DATABASE_TYPE	local
DATABASE_USERNAME	wordpress
DATABASE_PASSWORD	some-string

Note: We create a database "azurelocaldb" when using local mysql . Hence use this name when setting up the app

Note: Phpmyadmin site is deployed when using local mysql. Please go to http://[website]/phpmyadmin, and login with DATABASE_USERNAME and DATABASE_PASSWORD.

4. Browse your site
5. Complete WordPress install

Note: Do not use the app setting DATABASE_TYPE=local if using Azure database for MySQL

How to turn on Xdebug

1. By default Xdebug is turned off as turning it on impacts performance.
2. Connect by SSH.
3. Go to /usr/local/etc/php/conf.d, Update xdebug.ini as wish, don't modify the path of below line. zend_extension=/usr/local/lib/php/extensions/no-debug-non-zts-20170718/xdebug.so
4. Save xdebug.ini,
5. Restart php-fpm by below cmd:

# find gid of php-fpm
ps aux
# Kill master process of php-fpm
kill -INT <gid>
# start php-fpm again
php-fpm -D && chmod 777 /var/run/php/php7.0-fpm.sock

6. Xdebug is turned on.

How to update config files of nginx

1. Go to "/etc/nginx", update config files as your wish.
2. Reload by below cmd:

/usr/sbin/nginx -s reload

Tips of Log rotate

1. By default, log rotate is disabled if deploy this images to web app for containers of azure. It's enabled if you use this image by "docker run".
2. Log rotate is managed by crond, you can start it with below cmd, it will check logs files in the /home/LogFiles/nginx every minute, and rotate them if bigger than 1M. Old files are stored in /home/LogFiles/olddir, keep 20 backup files by default setting.

crond

3. Please keep an eye on the log files, the performance will be going down if it's too big.
4. If you don't like to start crond service to triage log rotate every minute, you also can manually triage it by below cmd as your wish, it will talk a while if these log files have already been too big.

logrotate /etc/logrotate.conf

Updating WordPress version , themes , files

If WEBSITES_ENABLE_APP_SERVICE_STORAGE = false ( which is the default setting ) , we recommend you DO NOT update the WordPress core version , themes or files from WordPress admin dashboard.

Choose either one option to updated your files :

There is a tradeoff between file server stability and file persistence . Since we are using local storage for better stability for the web app , you will not get file persistence. In this case , we recommend to follow these steps to update WordPress Core or a theme or a Plugins version :

1. Fork the repo https://github.com/azureappserviceoss/wordpress-azure
2. Clone your repo locally and make sure to use ONLY linux-appservice branch
3. Download the latest version of WordPress , plugin or theme being used locally
4. Commit the latest version bits into local folder of your cloned repo
5. Push your changes to the your forked repo
6. Login to Azure portal and select your web app
7. Click on Application Settings -> App Settings and change GIT_REPO to use your repository from step #1. If you have changed the branch name , you can continue to use linux-apservice . If you wish to use a different branch , update GIT_BRANCH setting as well.

Connect WordPress to Redis

1. Log-in to WordPress admin. In the left navigation, select Plugins, and then select Add New.
2. Search Redis Object Cache, Click Install, wait, then click Activate.
3. In the left navigation, select Plugins, and then select Installed Plugins.
4. In the plugins page, find Redis Object Cache and click Settings.
5. Click the Enable Object Cache button.
6. WordPress connects to the Redis server. The connection status appears on the same page.
7. More infomation about Redis Object Cache

Limitations

• Some unexpected issues may happen after you scale out your site to multiple instances, if you deploy a WordPress site on Azure with this docker image and use the MariaDB built in this docker image as the database.
• The phpMyAdmin built in this docker image is available only when you use the MariaDB built in this docker image as the database.
• Please Include App Setting WEBSITES_ENABLE_APP_SERVICE_STORAGE = true when use built in MariaDB since we need files to be persisted.
• Set permalink as "Day and Name" by default. Peformance issue may happen with customized permalink. If like to use customized permalink, need to modify nginx configuration and remove lines of set_permalink() in wp-settings.php.

Change Log

• Version 0.8

  1. Upgrade php-fpm and nginx.
  2. Upgrade local mariadb.
  3. Update conf of php-fpm.
  4. Add Watch thread of php-fpm, kill STAT D child threads.

• Version 0.72

  1. Fix Permission denied of log files issue of supervisord.

• Version 0.71

  1. Upgrade php-fpm.
  2. Upgrade phpmyadmin.
  3. Add function log rotate. (It's disabed if deploy to web app of azure by default.)
  4. Php-fpm and nginx are watched by supervisord.

• Version 0.7

  1. Upgrade php-fpm.
  2. Upgrade phpmyadmin.
  3. Add function log rotate. (It's disabed if deploy to web app of azure by default.)
  4. Php-fpm and nginx are watched by supervisord.

• Version 0.61

  1. Imporve Performance.

• Version 0.6

  1. Change to Nignx+fpm.
  2. Update version of php to 7.2.8.

• Version 0.51

  1. Add PHP simleXML module.
  2. Bind php 7.1.7, avoid confuse of different php versions.

• Version 0.5

  1. Add PHP redis extension.
  2. Add common debug tools, tcpdump/tcptraceroute.
  3. Fixed some Vulnerabilities.

• Version 0.4

  1. Update version of Alpine/PHP/Apache/Mariadb.
  2. Redis-server is running by default.
  3. Reduce size.

• Version 0.3

  1. Use Git to deploy wordpress.
  2. Update version of PHP/Apache/Mariadb/Phpmyadmin.
  3. Add Xdebug extenstion of PHP.
  4. Use supervisord to keep SSHD and Apache.

How to Contribute

If you have feedback please create an issue but do not send Pull requests to these images since any changes to the images needs to tested before it is pushed to production.