Debian installation pitfall
维护者通常 1 天内回复
评估
- 难度
- 1/5
- 预计耗时
- 1 小时以内
- 新手友好度
- 85/100
- Issue 类型
- 文档
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- docker, markdown
调研方向
从 https://docs.docker.com/engine/install/debian/ 上的 Debian 安装说明开始,并找到列出的命令 apt install ca-certificates curl。按照 issue 中的建议,检查这些说明在全新安装的 Debian 13 上的行为。完成标准是安装步骤不再消耗下一行粘贴的内容,并且在没有报告的 keyring 错误的情况下完成。
由索引模型根据 Issue 内容生成。
描述
Is this a docs issue?
- My issue is about the documentation content or website
Type of issue
Information is incorrect
Description
If you copy+paste this part of the debian installation instructions on a relatively fresh Debian 13 install...
# Add Docker's official GPG key:
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
The apt install ca-certificates curl line will prompt, for Y/n and consume the next pasted line semi-silently, culminating in this sequence not working correctly and outputting difficult-to-triage keyring errors. I believe this is the root cause of Issue #24939 and not obvious for inexperienced users. Stumbled into it myself recently but was able to recover.
Location
https://docs.docker.com/engine/install/debian/
Suggestion
add -y to install command in instructions, test on fresh installs with a minimal set of packages to find inexperienced-user issues like this.
- 主要语言
- Markdown
- 星标
- 4.7k
- 派生
- 8.5k
- 平均合并
- 2 天 14 小时
- 30 天内合并 PR
- 129
环境准备
- 提供 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
docker/docs 的其他 Issue
-
FAQ: Docker Desktop Kubernetes stuck on "Starting" behind a corporate proxy可能已有人在做 @aevesdocker 于 1 天前认领。 未关闭status/triage
难度 2/5 1-3 小时 新手友好度 75/100
维护者通常 1 天内回复
-
Confusing and contradictory information about paths resolving in extend可能已有人在做 @Duo-ee 于 3 天前认领。 未关闭status/triage
难度 2/5 1-3 小时 新手友好度 72/100
维护者通常 1 天内回复
-
[docs-scanner] Inconsistent terminology: 'nested organization' vs 'organization in the company'可能已有人在做 @dave123981 于 4 天前认领。 未关闭
难度 1/5 1 小时以内 新手友好度 88/100
维护者通常 1 天内回复
-
status/triage
难度 2/5 1-3 小时 新手友好度 78/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 1 天内回复
相似的 Issue
-
could docs good first issue
难度 2/5 1-3 小时 新手友好度 82/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 85/100
suitenumerique/find#206 ·
维护者通常 2 天内回复
-
README em inglês未关闭good first issue help wanted priority:p2 type:docs
难度 2/5 1-3 小时 新手友好度 76/100
lucacasanova/homedeck#122 ·
-
needs-triage
难度 1/5 1 小时以内 新手友好度 78/100
bherbruck/solvecraft#11729 · 1 条评论 · 1 个 reaction ·
-
area: cli area: docs documentation effort: small good first issue help wanted patch-candidate
难度 2/5 1-3 小时 新手友好度 72/100
drevendev/HungryCrab#601 ·
维护者通常 1 天内回复