4.8.5-ol-7-r113 release

bitnami/phpmyadmin/4/ol-7/Dockerfile

@@ -1,4 +1,4 @@
-FROM bitnami/oraclelinux-extras:7-r352
+FROM bitnami/oraclelinux-extras:7-r353
 LABEL maintainer "Bitnami <containers@bitnami.com>"
 
 # Install required system packages and dependencies
@@ -16,7 +16,7 @@ ENV APACHE_HTTPS_PORT_NUMBER="" \
     APACHE_SET_HTTPS_PORT="no" \
     APACHE_SET_HTTP_PORT="no" \
     BITNAMI_APP_NAME="phpmyadmin" \
-    BITNAMI_IMAGE_VERSION="4.8.5-ol-7-r112" \
+    BITNAMI_IMAGE_VERSION="4.8.5-ol-7-r113" \
     DATABASE_HOST="mariadb" \
     DATABASE_PORT_NUMBER="3306" \
     PATH="/opt/bitnami/apache/bin:/opt/bitnami/php/bin:/opt/bitnami/php/sbin:$PATH" \

bitnami/phpmyadmin/README.md

@@ -38,7 +38,7 @@ Bitnami containers can be used with [Kubeapps](https://kubeapps.com/) for deploy
 Learn more about the Bitnami tagging policy and the difference between rolling tags and immutable tags [in our documentation page](https://docs.bitnami.com/containers/how-to/understand-rolling-tags-containers/).
 
 
-* [`4-ol-7`, `4.8.5-ol-7-r111` (4/ol-7/Dockerfile)](https://github.com/bitnami/bitnami-docker-phpmyadmin/blob/4.8.5-ol-7-r111/4/ol-7/Dockerfile)
+* [`4-ol-7`, `4.8.5-ol-7-r113` (4/ol-7/Dockerfile)](https://github.com/bitnami/bitnami-docker-phpmyadmin/blob/4.8.5-ol-7-r113/4/ol-7/Dockerfile)
 * [`4-debian-9`, `4.8.5-debian-9-r97`, `4`, `4.8.5`, `4.8.5-r97`, `latest` (4/debian-9/Dockerfile)](https://github.com/bitnami/bitnami-docker-phpmyadmin/blob/4.8.5-debian-9-r97/4/debian-9/Dockerfile)
 
 Subscribe to project updates by watching the [bitnami/phpmyadmin GitHub repo](https://github.com/bitnami/bitnami-docker-phpmyadmin).
@@ -272,13 +272,85 @@ $ docker run -d --name phpmyadmin -p 80:80 -p 443:443 \
   bitnami/phpmyadmin:latest
 ```
 
+# Customize this image
+
+The Bitnami phpMyAdmin Docker image is designed to be extended so it can be used as the base image for your custom web applications.
+
+## Extend this image
+
+Before extending this image, please note there are certain configuration settings you can modify using the original image:
+
+- Settings that can be adapted using environment variables. For instance, you can change the ports used by Apache for HTTP and HTTPS, by setting the environment variables `APACHE_HTTP_PORT_NUMBER` and `APACHE_HTTPS_PORT_NUMBER` respectively.
+- [Adding custom virtual hosts](https://github.com/bitnami/bitnami-docker-apache#adding-custom-virtual-hosts).
+- [Replacing the 'httpd.conf' file](https://github.com/bitnami/bitnami-docker-apache#full-configuration).
+- [Using custom SSL certificates](https://github.com/bitnami/bitnami-docker-apache#using-custom-ssl-certificates).
+
+If your desired customizations cannot be covered using the methods mentioned above, extend the image. To do so, create your own image using a Dockerfile with the format below:
+
+```Dockerfile
+FROM bitnami/phpmyadmin
+## Put your customizations below
+...
+```
+
+Here is an example of extending the image with the following modifications:
+
+- Install the `vim` editor
+- Modify the Apache configuration file
+- Modify the ports used by Apache
+
+```Dockerfile
+FROM bitnami/phpmyadmin
+LABEL maintainer "Bitnami <containers@bitnami.com>"
+
+## Install 'vim'
+RUN install_packages vim
+
+## Enable mod_ratelimit module
+RUN sed -i -r 's/#LoadModule ratelimit_module/LoadModule ratelimit_module/' /opt/bitnami/apache/conf/httpd.conf
+
+## Modify the ports used by Apache by default
+# It is also possible to change these environment variables at runtime
+ENV APACHE_HTTP_PORT_NUMBER=8181 
+ENV APACHE_HTTPS_PORT_NUMBER=8143
+EXPOSE 8181 8143
+```
+
+Based on the extended image, you can use a Docker Compose file like the one below to add other features:
+
+```yaml
+version: '2'
+services:
+  mariadb:
+    image: 'bitnami/mariadb:10.3'
+    environment:
+      - MARIADB_ROOT_PASSWORD=bitnami
+    volumes:
+      - 'mariadb_data:/bitnami'
+  phpmyadmin:
+    build: .
+    ports:
+      - '80:8181'
+      - '443:8143'
+    depends_on:
+      - mariadb
+    volumes:
+      - 'phpmyadmin_data:/bitnami'
+volumes:
+  mariadb_data:
+    driver: local
+  phpmyadmin_data:
+    driver: local
+```
+
 # Notable Changes
 
 ## 4.8.5-debian-9-r96 and 4.8.5-ol-7-r111
 
+- This image has been adapted so it's easier to customize. See the [Customize this image](#customize-this-image) section for more information.
 - The Apache configuration volume (`/bitnami/apache`) has been deprecated, and support for this feature will be dropped in the near future. Until then, the container will enable the Apache configuration from that volume if it exists. By default, and if the configuration volume does not exist, the configuration files will be regenerated each time the container is created. Users wanting to apply custom Apache configuration files are advised to mount a volume for the configuration at `/opt/bitnami/apache/conf`, or mount specific configuration files individually.
 - The PHP configuration volume (`/bitnami/php`) has been deprecated, and support for this feature will be dropped in the near future. Until then, the container will enable the PHP configuration from that volume if it exists. By default, and if the configuration volume does not exist, the configuration files will be regenerated each time the container is created. Users wanting to apply custom PHP configuration files are advised to mount a volume for the configuration at `/opt/bitnami/php/conf`, or mount specific configuration files individually.
-- Enabling custom Apache certificates by placing them at `/opt/bitnami/apache/certs` has been deprecated, and support for this functionality will be dropped in the near future. Users wanting to enable custom certificates are advised to mount their certificate files on top of the preconfigured ones at `/certs`. Find an example at [Using custom SSL certificates](#using-custom-ssl-certificates).
+- Enabling custom Apache certificates by placing them at `/opt/bitnami/apache/certs` has been deprecated, and support for this functionality will be dropped in the near future. Users wanting to enable custom certificates are advised to mount their certificate files on top of the preconfigured ones at `/certs`.
 
 # Contributing