Jenkins Pipeline构建Docker镜像报错：context必须为目录

1. 修正docker build命令格式 #

你遇到的核心问题是错误地将Dockerfile作为构建上下文目录传入，docker build的最后一个参数必须是上下文目录，而非Dockerfile。正确的命令格式如下：

• 若Dockerfile在当前工作目录（默认命名为Dockerfile），直接指定上下文目录为当前目录：

  docker build -t dockerhub-image .
  

• 若需指定自定义名称的Dockerfile（比如Dockerfile.prod），才需要用-f参数，同时必须保留上下文目录：

  docker build -t dockerhub-image -f Dockerfile .
  

2. 排查Jenkins环境的特殊问题 #

如果已经用了正确命令但仍报错，需检查Jenkins运行环境的权限或目录配置：

• Jenkins用户的Docker权限：Jenkins默认以jenkins用户运行，若该用户未加入docker组，会导致Docker无法访问上下文目录。执行以下命令并重启Jenkins：

  usermod -aG docker jenkins
  systemctl restart jenkins
  

• 工作目录权限检查：确保/var/lib/jenkins/workspace/pipeline目录及文件的权限允许jenkins用户读取：

  chown -R jenkins:jenkins /var/lib/jenkins/workspace/pipeline
  

• 明确Pipeline工作目录：在Pipeline中用dir指令强制指定工作目录，避免潜在的目录切换问题：

  pipeline {
      agent any
      stages {
          stage('build docker image') {
              steps {
                  dir('/var/lib/jenkins/workspace/pipeline') {
                      sh "pwd"
                      sh "ls -l"
                      sh "docker build -t dockerhub-image ."
                  }
              }
          }
      }
  }
  

• 手动验证命令：在Jenkins服务器上切换到jenkins用户，手动执行docker build命令，确认命令本身可正常运行，排除Pipeline的配置问题：

  su jenkins
  cd /var/lib/jenkins/workspace/pipeline
  docker build -t dockerhub-image .
  

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