Docker images: plain X.Y.Z tag (e.g. 7.2.3) is never updated after the initial release build

オープン 初心者向け
#6,583 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 13 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
74/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
docker, github-actions, ruby
領域
devops, release

調査の方向性

.github/workflows/docker-release.yaml の docker-create-multiarch-manifest job から始め、stable への push に対してイメージタグがどのように生成されるかを追ってください。単純な X.Y.Z タグと、各 stable ビルドですでに更新されるタグを比較してください。完了条件は、単純なパッチタグが設定済みのレジストリ全体でそのパッチリリースの最新ビルドを指すこと、または workflow に意図的に固定されていると記載されていることです。

索引モデルが issue の本文から書いたものです。

説明

needs verification
Used Zammad Version

7.2.3

Environment
  • Installation method: Docker (ghcr.io/zammad/zammad, docker.io/zammad/zammad, docker.io/zammad/zammad-docker-compose, quay.io/zammad/zammad)
  • Operating system: n/a (container image tagging issue)
  • Database + version: n/a
  • Elasticsearch version: n/a
  • Browser + version: n/a
Actual behaviour

The plain X.Y.Z image tag (e.g. 7.2.3) is only created once, when the git tag is pushed, and never moves after that. All other release tags (X.Y.Z-NNNN, X.Y, X, latest, stable, sha-*) are updated on every push to stable.

As a result, ghcr.io/zammad/zammad:7.2.3 still contains the 7.2.3-0000 build from 2026-11-11, while 7.2.3-0016, 7.2, 7, latest and stable point to the current build:

Tag Image revision (org.opencontainers.image.revision) Created
7.2.3 d3f316a 2026-11-11
7.2.3-0000 d3f316a 2026-11-11
7.2.3-0016 / 7.2 / 7 / latest / stable / sha-e3273f5 e3273f5 2026-11-19

This affects all registries the workflow pushes to: ghcr.io/zammad/zammad, docker.io/zammad/zammad, docker.io/zammad/zammad-docker-compose and quay.io/zammad/zammad. On each of them, 7.2.3 was last updated on 2026-11-11, while 7.2.3-0016 and 7.2 were updated on 2026-11-19.

It also affects every release, not only 7.2.3. On GHCR none of the plain tags 7.1.0, 7.1.1, 7.1.2, 7.1.3, 7.2.2, 7.2.3 matches its newest -NNNN build. Each one still has the content of -0000. For example, 7.2.2 has revision 295796a (2026-10-08), while 7.2.2-0049 has cfad94c (2026-11-10).

Cause (in .github/workflows/docker-release.yaml, job docker-create-multiarch-manifest): ZAMMAD_VERSION, ZAMMAD_VERSION_MAJOR_MINOR, ZAMMAD_VERSION_MAJOR, latest and stable are enabled for refs/heads/stable. The plain X.Y.Z tag only comes from type=ref,event=tag, so it is only set when the tag itself is pushed.

Because of this, anyone pinning to the patch version gets no fixes after the first build of the release, even though 7.2 and 7 do get them. This tag behaviour is also hard to spot.

Expected behaviour

X.Y.Z should follow the newest build of that patch release (X.Y.Z-NNNN), the same way X.Y and X do. Then 7.2.3 would currently point to the same image as 7.2.3-0016.

A possible fix is to add the most recent tag as a raw tag for stable builds, e.g.:

- name: Get Zammad patch version from the most recent tag
  run: echo ZAMMAD_VERSION_PATCH="$(git describe --tags --abbrev=0)" >> $GITHUB_ENV
...
  type=raw,value=${{ env.ZAMMAD_VERSION_PATCH }},enable=${{ github.ref == format('refs/heads/{0}', 'stable') }}

If keeping X.Y.Z pinned to -0000 is intentional, please document it, because it differs from how X.Y and X behave.

Steps to reproduce the behaviour
for t in 7.2.3 7.2.3-0000 7.2.3-0016 7.2; do
  echo -n "$t: "
  docker buildx imagetools inspect ghcr.io/zammad/zammad:$t --format '{{json .Image}}' \
    | jq -r '."linux/amd64".config.Labels."org.opencontainers.image.revision"'
done

Output (2026-11-20):

7.2.3:      d3f316a4002e123dfb0a7b71712d23434c073178
7.2.3-0000: d3f316a4002e123dfb0a7b71712d23434c073178
7.2.3-0016: e3273f5878ef236916addc09aa0d1b686c841581
7.2:        e3273f5878ef236916addc09aa0d1b686c841581

The same check for 7.2.2 vs. 7.2.2-0049, or 7.1.3 vs. 7.1.3-0018, shows the same mismatch.

Support Ticket

No response

I'm sure this is a bug and no feature request or a general question.

yes

主要言語
Ruby
スター
6k
フォーク
1.1k
PR マージ指標
30日以内にマージされた PR はありません

環境構築

  • Dockerfile または Docker Compose ファイルあり
  • プルリクエストのテンプレートあり
  • コントリビューションガイドなし

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

zammad/zammad のほかの issue

zammad/zammad の issue をすべて見る

似ている issue

Ruby の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。