Web Apps on Linux(Preview) allows running web apps natively on Linux. WordPress is popular blogging platform primarily used on Linux distributions. Today we have released WordPress for App Service on Linux in the Azure marketplace that helps you quickly create a WordPress application on Web apps (Linux) . Azure App service on Linux lets you bring your own custom image and this template leverages the same for using a custom docker image for WordPress publicly available on docker hub .
This docker image enables you to run a WordPress site on Azure Web App on Linux using either :
- ClearDB : It is Microsoft Partner solution for a fully integrated MySQL service on Azure. Purchasing a paid MySQL database may require a credit card be associated with your Azure subscription.
- Azure Database for MySQL(Preview) : It is a Microsoft solution for MySQL service on Azure that provides a managed database service for app development and deployment that allows you to stand up a MySQL database in minutes and scale on the fly .
- MySQL in-app : This uses the Maria DB database included in the image. This option is recommended for development purposes and does not scale on multiple instances.
Before you begin
If you don’t have an Azure subscription, create a free account before you begin.
Deploy from Marketplace
Enter a unique app name for your **Web App Name**. This name is used as part of the default DNS name for your app <app_name>.azurewebsites.net, so it needs to be unique across all apps in Azure. You can later map a custom domain name to your app before you expose it to your users
|Subscription||Select a Subscription. If you have multiple subscriptions, choose the appropriate subscription.|
Enter a resource group. A resource group is a logical container into which Azure resources like web apps, databases that is deployed and managed. You can create a resource group or use an existing one
|App Service Plan||
App Service plans represent the collection of physical resources used to host your apps. Select the Location and the Pricing tier. For more information on pricing, see App service pricing tier
|Database Provider||Select one of the three options for MySQL : ClearDB , Azure Database for MySQL (Preview) or MySQL in-app. Complete the Database configuration based on your choice.|
This will deploy a WordPress custom image on to Web Apps on Linux . Note there might be cold start for the first request to the site created.
Local database connection information
All the database information is stored in your web app application settings. The password, database name are auto generated . You can find this information in the Azure portal , select your web app -> Application settings -> app settings
Connect to local MariaDB database
If you’re using the builtin MariaDB, you can access the builtin phpMyAdmin site with a URL like below: http://hostname[:port]/phpmyadmin
Manage ClearDB or Azure Service for MySQL(Preview) database
Connect to local redis cache
If you’re using the builtin MariaDB, you can leverage the builtin redis cache server with WordPress cache plugins. For example, the Redis Object Cache. The builtin Redis cache server uses port 6379. It is recommend to use Azure Redis cache for production site.
There are some limitations with using this image on Web Apps on Linux. These are components included with this image .
- WordPress 4.7.2
- PHP 7.1.2
- Apache HTTPD 2.4.25
- MariaDB 10.0+
- phpMyAdmin 4.6.6
Keep this in mind when using the template with your application when using MySQL in-app (Local Database)
- You CANNOT 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. Since the database is local , the solution ONLY supports running on ONE instance.
- The Redis cache built in this docker image is available only when you use the MariaDB built in this docker image as the database. Since redis cache is local , this should be used only with local MariaDB database on a single isntance web app.
- The phpMyAdmin built in this docker image is available only when you use the MariaDB built in this docker image as the database.
Migrating an existing WordPress site
This image creates a new WordPress application every time it is deployed. If you are migrating your application to this site , please follow directions to export and import as mentioned on WordPress Codex.
If you have a complex WordPress application where the above mentioned export and import options are not effective, Web Apps on Linux supports git deployment and you use FTP or GIT deployment to replace the file system on the site created with this template to bring your own content. You can use PHPmyadmin available with this solution to import your application database content.
Recent updates to the docker image for WordPress on Linux may impact your site. If you created your WordPress app before 4/21 :
- Update the app settings and restart your site.
2. Replace DOCKER_CUSTOM_IMAGE setting to LinuxFxVersion = DOCKER|appsvc/apps:wordpress:0.1