diff --git a/doc/releases.md b/doc/releases.md index 9a871b30487889e964055551ed9946d286f13efe..f06cdb9b044d851067b74f0c92827d23cb0da4b9 100644 --- a/doc/releases.md +++ b/doc/releases.md @@ -45,11 +45,11 @@ We are happy to document and collate any self-hosting patterns/approaches that o We try to make it as easy as possible for users to self-host a Shields server so we publish a few releases of the server. Please be sure to refer to the [self hosting guide][self hosting] for a detailed walk through on how to spin up a server. - The server uses [Calendar Versioning](https://calver.org/). Tags of the form `server-YYYY-MM-DD` are server releases (these are the tags that are relevant to self-hosting users, e.g. [server-2021-02-01](https://github.com/badges/shields/releases/tag/server-2021-02-01)). -- As well as [tags on GitHub](https://github.com/badges/shields/tags), server releases are also pushed to [DockerHub](https://registry.hub.docker.com/r/shieldsio/shields/tags). See the self-hosting section on [Docker](https://github.com/badges/shields/blob/master/doc/self-hosting.md#Docker) for more details. +- As well as [tags on GitHub](https://github.com/badges/shields/tags), server releases are also pushed to [DockerHub](https://registry.hub.docker.com/r/shieldsio/shields/tags) and [GitHub Container Registry](https://github.com/badges/shields/pkgs/container/shields/versions?filters%5Bversion_type%5D=tagged). See the self-hosting section on [Docker](https://github.com/badges/shields/blob/master/doc/self-hosting.md#Docker) for more details. - We publish release notes for server releases in the [CHANGELOG](https://github.com/badges/shields/blob/master/CHANGELOG.md). There may occasionally be non-backwards compatible changes to be aware of. - We will normally put out one release per month. If there is a security patch or major bugfix affecting self-hosting users, we may put out an out-of-sequence release. - Releases are just a snapshot in time. We advise always tracking the latest release to ensure you are up-to-date with the latest bug fixes and security updates. There are no 'patch' releases - we don't backport fixes to old releases. Tagged versions just provide a convenient way to apply upgrades in a controlled way or roll back to an older version if necessary and communicate about versions. -- You can stay on the bleeding edge by tracking the `master` branch for source installs or the `next` tag on DockerHub. +- You can stay on the bleeding edge by tracking the `master` branch for source installs or the `next` tag on DockerHub/GHCR. [shields.io]: https://shields.io [npm package]: https://www.npmjs.com/package/badge-maker diff --git a/doc/self-hosting.md b/doc/self-hosting.md index 3a6d6ec9cb5c5355b314d597f59c6e0f10353293..096a66619165914e527350f202de3e70e5f536cd 100644 --- a/doc/self-hosting.md +++ b/doc/self-hosting.md @@ -71,18 +71,30 @@ vercel ## Docker -### DockerHub +### Public Images -We publish images to DockerHub at https://registry.hub.docker.com/r/shieldsio/shields +We publish images to: -The `next` tag is the latest build from `master`, or tagged releases are available -https://registry.hub.docker.com/r/shieldsio/shields/tags +- DockerHub at https://registry.hub.docker.com/r/shieldsio/shields and +- GitHub Container Registry at https://github.com/badges/shields/pkgs/container/shields -```console +The `next` tag is the latest build from `master`, or tagged snapshot releases are available: + +- https://registry.hub.docker.com/r/shieldsio/shields/tags +- https://github.com/badges/shields/pkgs/container/shields/versions?filters%5Bversion_type%5D=tagged + +```sh +# DockerHub $ docker pull shieldsio/shields:next $ docker run shieldsio/shields:next ``` +```sh +# GHCR +$ docker pull ghcr.io/badges/shields:next +$ docker pull ghcr.io/badges/shields:next +``` + ### Building Docker Image Locally Alternatively, you can build and run the server locally using Docker. First build an image: