docker build
# 1. 基本构建命令(使用当前目录的 Dockerfile)
docker build .# 2. 指定 Dockerfile 路径和构建上下文
docker build -f /path/to/Dockerfile /path/to/build/context# 3. 为镜像设置名称和标签
docker build -t my-image:latest .# 4. 设置构建参数(ARG 变量)
docker build --build-arg APP_VERSION=1.0.0 -t my-app .# 5. 使用特定目标阶段(多阶段构建)
docker build --target builder-stage -t my-builder .# 6. 不缓存构建过程(强制重新执行所有步骤)
docker build --no-cache -t fresh-image .# 7. 移除中间容器(构建成功后自动删除)
docker build --rm=true -t clean-image .# 8. 设置内存限制和 CPU 配额
docker build --memory=1g --cpus=2.0 -t resource-limited .# 9. 使用特定平台构建(跨平台构建)
docker build --platform linux/arm64 -t arm-image .# 10. 高级用法:构建时传递 SSH 密钥
docker build --ssh default -t ssh-image .# 11. 压缩构建上下文(减少传输大小)
docker build --compress -t compressed-build .# 12. 设置超时时间(防止卡死)
docker build --timeout=30m -t safe-build .# 13. 组合使用示例:完整构建命令
docker build \-t my-registry/app:v2 \ # 镜像名称和标签-f dockerfiles/prod.Dockerfile \ # 指定 Dockerfile--build-arg NODE_ENV=production \ # 构建参数--target runtime-stage \ # 多阶段目标--no-cache \ # 禁用缓存--platform linux/amd64 \ # 目标平台--memory=2g \ # 内存限制. # 构建上下文
参数 | 说明 |
---|
-t / --tag | 设置镜像名称和标签(格式:name:tag ,可多次使用) |
-f / --file | 指定 Dockerfile 路径(默认:PATH/Dockerfile ) |
--build-arg | 传递构建参数(覆盖 Dockerfile 中的 ARG ) |
--target | 多阶段构建时指定目标阶段 |
--no-cache | 禁用构建缓存(从头开始构建) |
--rm | 构建成功后删除中间容器(默认:true ) |
--platform | 设置目标平台(如 linux/amd64 , linux/arm64 ) |
--compress | 使用 gzip 压缩构建上下文 |
--ssh | 允许构建时访问 SSH 代理(安全访问私有仓库) |
--memory | 设置构建容器的内存限制 |
--cpus | 设置 CPU 配额(如 1.5 表示 1.5 个 CPU 核心) |
--timeout | 设置构建超时时间(单位:s /m /h ) |
. | 构建上下文路径(决定 COPY /ADD 的文件范围) |
docker push
# 1. 基本推送命令(推送到 Docker Hub)
docker push username/image-name:tag# 2. 推送到私有仓库(需先登录)
docker push registry.example.com:5000/my-app:v1.0# 3. 推送多个标签(需分别执行)
docker push username/image-name:latest
docker push username/image-name:v1.2# 4. 使用不同格式的镜像标识
docker push my-image-id # 使用镜像ID推送(不推荐)
docker push my-image@sha256:abc123... # 使用摘要推送# 5. 强制推送(覆盖已有镜像)
docker push --force username/image-name:latest# 6. 禁用内容信任(开发环境使用)
docker push --disable-content-trust my-private-reg/image# 7. 组合使用示例
docker tag local-image:dev username/prod-image:v2.1 # 先打标签
docker push username/prod-image:v2.1 # 再推送# 8. 推送多平台镜像(需用 buildx 构建)
docker buildx build --platform linux/amd64,linux/arm64 -t username/multi-arch-image:latest --push .
参数 | 说明 |
---|
--disable-content-trust | 跳过镜像签名验证(默认开启) |
--quiet / -q | 静默模式(只输出错误信息) |
--force / -f | 强制覆盖远程同名镜像(谨慎使用) |
--all-tags / -a | 注意:docker push 不支持此参数 |
docker login
# 登录默认 Docker Hub 仓库(交互式输入认证信息)
docker login
# 注释:
# 执行后需手动输入用户名、密码
# 登录凭证默认保存在 `~/.docker/config.json`# 指定用户名登录 Docker Hub(密码手动输入)
docker login -u your_username
# 注释:
# -u 指定用户名
# 执行后会提示输入密码(避免密码出现在命令历史)# 完整认证登录私有仓库
docker login -u user -p passwd registry.example.com:5000
# 注释:
# -p 直接提供密码(注意安全隐患)
# registry.example.com:5000 指定私有仓库地址
# 适合自动化脚本(但需确保密码安全)# 从文件读取密码登录(避免密码暴露)
cat ~/password.txt | docker login -u user --password-stdin registry.example.com
# 注释:
# --password-stdin 从标准输入读取密码
# cat 命令将密码文件内容通过管道传递
# 避免密码被记录在历史命令或日志中# 登录第三方公共仓库
docker login -u token_username -p access_token ghcr.io
# 注释:
# ghcr.io GitHub Container Registry
# access_token 通常为平台生成的访问令牌
# 适用于 GitHub/GitLab 等容器服务# 退出当前仓库登录
docker logout registry.example.com
# 注释:
# 删除本地存储的指定仓库凭证
# 不指定仓库则默认清除 Docker Hub 登录状态
docker logout
# 登出默认 Docker Hub 仓库
docker logout
# 注释:清除当前用户登录 Docker Hub 的凭证 (~/.docker/config.json)# 登出私有仓库(指定仓库地址)
docker logout registry.example.com:5000
# 注释:
# 清除指定私有仓库的登录凭证
# 格式:仓库域名/IP + 端口号(非默认端口必须指定)# 登出 GitHub Container Registry
docker logout ghcr.io
# 注释:
# 清除 GitHub 容器仓库的凭证
# 适用于第三方容器仓库(GitLab 对应 gitlab.example.com)# 登出所有仓库(需手动实现)
# 注释:Docker 没有直接清除所有凭证的命令,需手动删除配置文件
rm ~/.docker/config.json
# 警告:此操作将删除所有容器仓库的登录凭证!