VIP Container Images

This repository is used to build Docker container images used, among others, by the VIP Local Development Environment.

Images are built and published using GitHub Actions and GitHub Packages. All images in this repository are multi-architechture images, supporting amd64 and arm64.

Using the images

You can find the most up to date versions of the images and the command to pull them in the sidebar, under the Packages section. TL;DR the pulling has to be prefixed with ghcr.io/automattic/vip-container-images. For instance:

docker pull ghcr.io/automattic/vip-container-images/alpine:3.16.0

Using image locally in dev-env

The easiest way is to update the needed service in .lando.yml in the environment's base folder (.local/share/vip/dev-environment/$ENV_SLUG)

For example, for dev-tools you could do something like this:

  devtools:
    type: compose
    services:
      build:
        context: /Users/user/vip-container-images/dev-tools
        dockerfile: /Users/user/vip-container-images/dev-tools/Dockerfile
  # the rest is omitted

For WordPress we'll also need to pass WP_GIT_REF argument, here's an example entry to build an image for trunk:

  wordpress:
    type: compose
    services:
      # image: ghcr.io/automattic/vip-container-images/wordpress:trunk
      build:
        context: /Users/user/vip-container-images/wordpress
        dockerfile: /Users/rinat/projects/vip-go-platform-stack/vip-container-images/wordpress/Dockerfile
        args:
          - WP_GIT_REF=HEAD
  # the rest is omitted

Publishing the images

The image publishing process is performed by a GitHub action every time a commit is done to master. All workflows are triggered then, therefore, all images are built in parallel.

Updating Docker images

This repository has Dependabot set up. Whenever a Docker base image has a new available version, the bot will open a Pull Request with the change.

Adding, Updating and Deleting versions of WordPress

Adding and updating existing version is handled by update-wp-versions workflow. Removal is manual either by updating versions.json or running the utility script.

We have utility scripts to add and remove the versions of WordPress, based on the versions.json we kick off the image builds for every specified version. We use official GitHub repo for WordPress.

Basic syntax is as follows:

$> wordpress/add-version.sh <TAG> <REF> [cacheable=true] [locked=false] [prerelease=false]

• <TAG> is Docker image tag, should be pointing to the major version, E.g. 5.8
• <REF> is either git tag, e.g. 5.8.3 or git SHA, e.g. e86b90cad6330eea636496f7317fac4c1a73e42b

$> wordpress/add-version.sh 6.0 2be90dc589a1c2e2bde5efa691eafe5407d0f753 true true true This will add a 6.0 (pre-release) and point to a specific commit

$> wordpress/add-version.sh 5.9 5.9.3 This will add a 5.9 and point to 5.9.3 tag.

$> wordpress/delete-version.sh 5.9 This can be used to delete tag.

Alternatively, this also can be done by removing the related entry from wordpress/versions.json