https://github.com/automattic/vip-container-images
Multipurpose VIP Docker container images (primarily meant for use with the VIP Local Development Environment)
https://github.com/automattic/vip-container-images
docker vip wpvip
Last synced: 3 months ago
JSON representation
Multipurpose VIP Docker container images (primarily meant for use with the VIP Local Development Environment)
- Host: GitHub
- URL: https://github.com/automattic/vip-container-images
- Owner: Automattic
- Created: 2021-08-09T07:12:23.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2025-01-27T23:52:00.000Z (3 months ago)
- Last Synced: 2025-01-28T00:31:51.103Z (3 months ago)
- Topics: docker, vip, wpvip
- Language: PHP
- Homepage: https://docs.wpvip.com/technical-references/vip-local-development-environment/
- Size: 36.5 MB
- Stars: 16
- Watchers: 8
- Forks: 4
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# VIP Container Images
This repository is used to build Docker container images used, among others, by the [VIP Local Development Environment](https://docs.wpvip.com/technical-references/vip-local-development-environment/).
Images are built and published using GitHub Actions and GitHub Packages. All images in this repository are [multi-architechture images](https://docs.docker.com/desktop/multi-arch/), 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:
```bash
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:
```yaml
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:
```yaml
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](.github/workflows/) 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](.github/dependabot.yml). 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](/.github/workflows/update-wp-versions.yml). 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](https://github.com/WordPress/WordPress).
Basic syntax is as follows:
`$> wordpress/add-version.sh [cacheable=true] [locked=false] [prerelease=false]`
- `` is Docker image tag, should be pointing to the major version, E.g. `5.8`
- `` 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`