GitHub Actions推送镜像到Docker Hub报找不到Dockerfile如何解决

1. 先修复工作流的YAML缩进错误 #

YAML对缩进敏感度极高，你当前的配置文件缩进完全不统一，会导致GitHub Actions解析步骤逻辑异常。先把配置替换为缩进对齐的正确版本：

name: workflow 3
on: push
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v2
      - name: Set up QEMU
        uses: docker/setup-qemu-action@v1
      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v1
      - name: login to docker hub
        uses: docker/login-action@v1
        with:
          username: ${{ secrets.DOCKER_NAME }}
          password: ${{ secrets.DOCKER_TOKEN }}
      - name: Build and push
        uses: docker/build-push-action@v2
        with:
          context: .
          push: true
          tags: <你的DockerHub用户名>/app:latest

注意把标签里的<你的DockerHub用户名>替换成你自己的Docker Hub账号名，否则推送时会报权限错误。

2. 解决找不到Dockerfile的核心报错 #

你收到的failed to read dockerfile: no such file or directory报错，本质是构建阶段在你指定的上下文目录（当前配置为仓库根目录.）下找不到可识别的Dockerfile文件，按以下顺序排查：

• 确认仓库根目录存在命名正确的Dockerfile
  构建默认识别的文件名为**Dockerfile**，注意大小写完全匹配：Linux环境下dockerfile、DockerFile这类命名都不会被识别，且文件不能有.txt、.md之类的后缀名。
• 非默认路径/命名的Dockerfile需显式指定
  如果你的Dockerfile不在仓库根目录，或者用了自定义文件名，需要在构建步骤中加file参数指定路径，示例：

  - name: Build and push
    uses: docker/build-push-action@v2
    with:
      context: .
      file: ./docker/MyDockerfile # 替换为Dockerfile在仓库中的实际相对路径
      push: true
      tags: <你的DockerHub用户名>/app:latest
  

• 验证代码拉取是否正常
  如果Checkout步骤拉取仓库代码失败，工作目录为空也会触发这个报错。可以在Checkout步骤之后加一个临时步骤，打印工作目录文件列表验证：

  - name: List workspace files
    run: ls -la
  

  执行工作流时查看该步骤的输出，就能确认当前目录下是否存在预期的Dockerfile。

内容的提问来源于stack exchange，提问作者agmcoder