Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

Clarify versioning/update policy in the README

未关闭
#2,262 1 条评论 2 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
25/100
Issue 类型
文档
描述清晰度
需要澄清
活跃度
停滞
技术栈
docker

调研方向

从 README 和链接的跟踪 issue #2265 开始;审查其中列出的有关 tags、releases、base-image 重建、不可变性、破坏性变更以及 changelog 内容的问题。完成的标准是 README 清楚说明版本和更新策略,包括 production tags、可变引用与半不可变引用、digests 以及一般性建议。

由索引模型根据 Issue 内容生成。

描述

1. To develop docs enhancement meta overview

Breadcrumbs for down the road... (Mostly for myself).

  • Context
    • Docker Official images and what that means
    • Base image updates (eco-system rebuilds)
  • Nextcloud Server releases (upstream bumps)
  • Image releases
    • bugs fixes
    • enhancements
    • upgrades of underlying bits (e.g. a new major PHP or underlying distribution version)

Production Docker tags:

  • Upstream supported stables (proposed)
    • latest
    • previous
    • last
  • Generic
    • stable / production

Tracking this in: #2265


Immutable:

  • No such thing technically since what a tag points to can always be changed
  • We attempt to make specific tags semi-immutable at the Dockerfile level, but the images themselves referenced by these tags will technically always change automatically whenever the underlying base images (debian, alpine, php) are updated (generally for security). This is a byproduct of how Docker base images and Docker Official images work.
  • The only truly immutable option - if you require that - is to reference your images by their digest. The caveat being you're 100% responsible for security updates.

General recommendations:

  • Pin your image references to something. Rule of thumb: a major release or one of { latest, previous, last }

  • Tagging policy
    • latest/previous/last match upstream
    • stable/production generally matches ?

  • Breaking changes
    • ?

  • Image versions
  • Nextcloud Server versions
  • Base image versioning/rebuilding
  • Image tags

  • Mutable tags
  • Rolling tags
  • Semo-immutable
    • e.g. "29.0.5"
  • Digests (immutable/BOM use)

Changelog:

  • Release notes (high-level / quick summary)
  • Commit log (detailed /
主要语言
Shell
星标
7.4k
派生
1.9k
PR 合并指标
30 天内没有已合并 PR

环境准备

  • 没有 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 阅读贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

nextcloud/docker 的其他 Issue

查看 nextcloud/docker 的全部 Issue

相似的 Issue

更多 Shell/Bash Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。