initial commit

Author: Luke

.github/workflows/build-image.yaml

@@ -0,0 +1,64 @@
+# Builds the specified image using the Dockerfile, targeting the provided `docker_target`. This image is then published in GitHub Container Registry.
+name: Build docker image
+
+on:
+  workflow_call:
+    inputs:
+      docker_target:
+        required: true
+        type: string
+        description: The target in the Dockerfile that should be built. Either "dev" or "main".
+      php_version:
+        required: true
+        type: string
+        description: The PHP version contained within the image, used for tagging the image.
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      # Checkout a copy of the Dockerfile from the repository from the tag associated with the release that triggered
+      # this workflow.
+      - name: Check out repository code
+        uses: actions/checkout@v3
+        with:
+          ref: ${{ github.event.release.tag_name }}
+
+      # Login to the GitHub Container Registry.
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v2
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      # Configure buildx as our preferred builder.
+      - name: Setup docker buildx
+        uses: docker/setup-buildx-action@v2
+        id: buildx
+        with:
+          install: true
+
+      # Generate the tags that should accompany the image.
+      # For the dev image, this is expected to be `dev-latest` and `dev-[PHP_VERSION]-latest`, and `dev-[PHP_VERSION]-[SCHEDULE].
+      - name: Generate tags
+        id: meta
+        uses: docker/metadata-action@v4
+        with:
+          images: ghcr.io/bluewing/php-docker-image
+          flavor: |
+            latest=true
+            prefix=${{ inputs.docker_target }}-,onlatest=true
+          tags: |
+            type=raw,value=${{ inputs.php_version }}-latest
+            type=raw,value=${{ inputs.php_version }}-{{ date 'YYYYMMDD' }}
+
+      # Build the docker image and publish it to GCR.
+      - name: Build and push
+        uses: docker/build-push-action@v3
+        with:
+          context: .
+          target: ${{ inputs.docker_target }}
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

.github/workflows/build-images-on-release.yaml

@@ -0,0 +1,19 @@
+# When a GitHub release event occurs, build both the development and production images contained within the `Dockerfile` using the `build-image.yaml` reusable workflow. Both images will then be published to GitHub Container Registry so they can be used as part of Bluewing application images.
+# This workflow run can take up to 20 minutes or more because the PHP extensions needed must be built from source.
+name: Build images on release
+
+on:
+  release:
+    types: [released]
+
+jobs:
+  build-images:
+    strategy:
+      matrix:
+        docker_target: [dev, main]
+        php_version: [8.1.4]
+    uses: ./.github/workflows/build-image.yaml
+    with:
+      docker_target: ${{ matrix.docker_target }}
+      php_version: ${{ matrix.php_version }}
+    secrets: inherit

.gitignore

@@ -0,0 +1 @@
+.idea/

Dockerfile

@@ -0,0 +1,14 @@
+# syntax = docker/dockerfile:1.2
+
+# This `Dockerfile` has two possible build outputs: `dev` and `main`.
+
+FROM php:8.1.4-fpm-alpine3.15 as base
+LABEL maintainer="lukedavia@icloud.com"
+COPY --from=mlocati/php-extension-installer /usr/bin/install-php-extensions /usr/local/bin/
+
+
+FROM base as main
+RUN install-php-extensions pdo_pgsql redis-5.3.7;
+
+FROM main as dev
+RUN install-php-extensions xdebug-3.1.5;

README.md

@@ -0,0 +1,37 @@
+# `php-docker-image`
+
+This repository contains a general-purpose base PHP docker image for use in Bluewing applications that combines the lightweight base image of Alpine Linux with the speed-wins normally gained through using Debian.
+
+## Rationale
+
+Alpine Linux PHP docker images are typically 6× smaller in size or more, which makes them an excellent choice due to their lightweight footprint. They do however come with the disadvantage that [they ship with musl libc instead of glib and friends](https://hub.docker.com/_/php). This means that the PHP extensions we need as part of our application stack must be compiled from source, installed of installed from a precompiled binary, which significantly slows the build time—up to 800 seconds or more to build a base image with the dependencies we need.
+
+We have extracted these long build times to an infrequently-modified Docker image that can be built once in CI and pulled as much as necessary.
+
+## Available tags
+
+Two image variants are available, a primary image that requires in `pdo_pgsql` and `phpredis` so we can use a development image tagged `dev` which additionally includes `xdebug`.
+
+| Tag                 | PHP version | Alpine Version | Extensions                                | Build size |
+|---------------------|-------------|----------------|-------------------------------------------|------------|
+| `dev-8.1.4-latest`  | 8.1.4       | 3.15           | `pdo_pgsql`,`redis-5.3.7`, `xdebug-3.1.5` |            |
+| `main-8.1.4-latest` | 8.1.4       | 3.15           | `pdo_pgsql`, `redis-5.3.7`,               |            |
+
+Each flavour of image is tagged three times, making it possible to select images based purely on the latest version, the latest version of a specific PHP release, or a specific image entirely:
+
+* `FLAVOR-latest`
+* `FLAVOR-PHP_VERSION-latest`
+* `FLAVOR-PHP_VERSION-DATE`
+
+PHP extensions are installed using the [thecodingmachine/docker-images-php](https://github.com/thecodingmachine/docker-images-php) Docker image.
+
+## Building
+
+Each image is built when a release occurs, using GitHub Actions, and published to GitHub Container Registry. To use these images in your `Dockerfile`, reference them as follows:
+
+```Dockerfile
+# Development, includes xdebug along with other extensions. 
+FROM ghcr.io/bluewing/php-docker-image:dev-latest
+# Production, only pdo_pgsql and redis
+FROM ghcr.io/bluewing/php-docker-image:main-latest
+```