35-Git

已于 2022-09-19 21:41:25 修改
阅读量873 收藏 3
点赞数 1
CC 4.0 BY-SA版权
分类专栏： Java 文章标签： git github
于 2022-08-09 18:58:07 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/cygqtt/article/details/126217207
本文详细介绍Git版本控制系统的基础知识，包括安装、基本操作、远程仓库管理、分支管理等内容，并结合IDEA进行实操演示。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

35-Git笔记-qianfeng-笔记

文章目录

在这里插入图片描述

一、Git简介

①：项目的版本管理

在项目开发过程中，项目没开发到一个节点就会对当前项目进行备份，这个备份就是项目的一个版本；当我 们继续开发一个阶段后，再次进行备份，就生成新的版本一一多个版本的集合就是项目的版本库

在项目版本管理中，我们可以使用手动进行管理，但是存在一些问题：

  • 需要手动维护版本的更新日志，记录每个版本的变化
  • 需要手动查找历史版本，当历史版本比较多的时候，查找工作很繁琐
  • 当我们需要回退到某个版本时，只能够手动的通过DE工具手动打开

②：团队协同开发

在这里插入图片描述

③：版本管理工具—Git

Git是以恶搞开源的分布式版本控制系统，用于敏捷高效的处理任何大小项目的版本管理

核心功能

  • 项目的版本管理
  • 团队协同开发

二、Git下载及安装

①：下载

官网：https://git-scm.com/
在这里插入图片描述

②：安装

除了选择安装位置以外，其他都傻瓜式安装

③：检查安装

  • win + R
  • git --version

在这里插入图片描述

三、Git架构

在这里插入图片描述

四、Git基本使用

①：创建版本库

  • 在工作空间的目录中，右键“Git Bash Here”打开git终端
  • 在Git终端中输入git init指令，创建版本库（就是一个.git目录）
    在这里插入图片描述

指令：git init

在这里插入图片描述

②：查看版本状态

git status

③：将工作空间的修改添加到暂存区

git add a.txt 只将工作空间中的某个文件add到暂存区
git add· 将工作空间中所有文件都add暂存区

在这里插入图片描述

④：将暂存区内容提交到版本库（仓库）

git commit -m ‘版本说明（描述）’

在这里插入图片描述

⑤：查看

git log 查看每个版本的详细信息
git log --oneline 每个版本只显示一行信息

在这里插入图片描述

⑥：设置用户信息

git config --global user.name 'Coke666' 设置用户名
git config --global user.email 'coke@haha.com' 设置用户邮箱

在这里插入图片描述

在这里插入图片描述

⑦：同步历史版本到工作空间

git add . 添加到暂存取
git commit -m '版本日志（描述）' 提交
git log --oneline 查看版本信息

在这里插入图片描述> git checkout 版本号

在这里插入图片描述

注意 ： 只能查看当前版本之前的信息

在这里插入图片描述

不过 可以回到最新版本, 但是要记住版本号！！！！

在这里插入图片描述

五、远程仓库

①：远程仓库介绍

远程仓库，远程版本库； 实现版本库的远程存储，以实现团队的协同开发

远程仓库
在这里插入图片描述

②：如何获得远程仓库？

③：创建远程仓库（码云）

1. 注册（注册步骤略~）
在这里插入图片描述
2. 创建仓库
在这里插入图片描述
仓库地址： https://gitee.com/c-coke/git-demo.git
在这里插入图片描述
3. 添加协同开发人员
在这里插入图片描述

六、远程仓库操作

①：准备工作

  1. 创建本地工作空间

     D:\OOP\java\develop_idea\04_git\01_gitDemo 
 	src
 		main 
 			java 
 			resources
 		test 
 			java 
 	pom.xml

在这里插入图片描述
2. 初始化本地仓库

git init

在这里插入图片描述

  1. 将工作空间搭建的项目结构add到暂存区

     git add .

在这里插入图片描述

  1. 将暂存区文件提交到版本库，生成第一个版本

     git commit -m '创建项目'

在这里插入图片描述

  1. 为当前项目创建一个远程仓库

     远程仓库地址： https://gitee.com/c-coke/01_git-demo.git

在这里插入图片描述

②：本地仓库关联远程仓库并查看

建立D:\OOP\java\develop_idea\04_git\01_gitDemo 的本地仓库与 远程仓库https://gitee.com/c-coke/01_git-demo.git的关联

git remote add origin https://gitee.com/c-coke/01_git-demo.git    关联远程仓库

git remote -v			查看远程仓库的状态

在这里插入图片描述

③：将本地仓库push到远程仓库

	git push origin master        origin 远程仓库的别名   master 远程仓库分支名

在这里插入图片描述

在这里插入图片描述

在本地仓库中新建文件

  • main\java 新建 HelloWorld.java
  • main\resources 中新建一个img文件夹并在该文件夹中存一张照片
  • 添加到暂存区 → 提交 → push到远程仓库

在这里插入图片描述
在这里插入图片描述

④：其他开发者pull远程仓库到本地

  1. 直接从远程仓库上传文件（模拟其他开发人员提交的代码）

在这里插入图片描述

指令 ：git pull https://gitee.com/c-coke/01_git-demo.git master

在这里插入图片描述

⑤：解决协同开发冲突问题

1. 模拟其他开发人员修改信息
在这里插入图片描述
2.在本地也修改HelloWorld.java中的内容 👉并添加👉提交
在这里插入图片描述
3. 当push到远程仓库时会报错（冲突）
在这里插入图片描述
4.解决冲突问题
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

出现以下问题解决方法
在这里插入图片描述

⑥：从远程仓库拉取报错

在这里插入图片描述

七、分支管理

在这里插入图片描述

①：分支介绍

分支就是版本库中记录版本位置（支线），分支之间项目不影响，使用分支可以对项目起到保护作用
分支就是一条时间线，每次提交就在这条时间线上形成一个版本

②：分支特性

  • 创建一个新的版本库，默认创建一个主分支-master分支
  • 每个分支可以进行单独管理（常规分支、保护分支、只读分支）
  • 分支是可以合并的

③：分支操作

01.创建分支

创建分支：git branch 分支名
在这里插入图片描述

02.查看分支

在这里插入图片描述

查看分支：gti branch
在这里插入图片描述

03.切换分支

切换分支：git checkout 分支名
在这里插入图片描述

04.删除分支内容

提交删除信息：git commit -a -m '描述
在这里插入图片描述

05.检出分支

检出分支：git checkout 版本号 -b 分支名
在这里插入图片描述

06.合并分支1（三方合并）

1.先在dev2分支下新建一个文件（master主分支没有的文件）
在这里插入图片描述
2.切换回主分支（master）
在这里插入图片描述
3.合并分支：git merge 分支名
在这里插入图片描述

07.合并分支2（快速合并）

1.在master分支下新建dev3分支并在该分支下新建dev3.txt文件
在这里插入图片描述
2.切换会master分支
在这里插入图片描述
3.在master分支下合并dev3分支
在这里插入图片描述

08.三方合并和快速合并的区别

在这里插入图片描述

09.删除本地分支

git branch -d  local_branch_name

git branch 是在本地删除分支的命令。
-d 是一个标志，是命令的一个选项，它是--delete. 顾名思义，
它表示您要删除某些内容。-local_branch_name是要删除的分支的名称。

④：企业分支模型

在这里插入图片描述

八、标签操作

在这里插入图片描述在这里插入图片描述

①：创建新标签并推送到远程仓库

在这里插入图片描述

②：检出标签（下载）

多个标签切换对比

1. 创建新的文件
在这里插入图片描述
2. 创建一个新的标签并推到远程仓库
在这里插入图片描述 在这里插入图片描述
3. 检出标签（检出标签必须创建一个新的分支）
在这里插入图片描述

九、IDEA整合Git使用

作为Jva开发工程，我们代码的编写工作都是在lDE工具(idea)中完成，因此我们需要了解和掌握直接使用IDE工具完成Git的操作

①：IDEA关联Git

1.使用Settings for New Projects 永久设置
在这里插入图片描述
在这里插入图片描述

②：IDEA中Git版本管理

01.准备工作

准备工作

1.创建一个新的web项目
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

02.创建本地版本库

创建版本库
在这里插入图片描述
在这里插入图片描述

03.设置忽略文件（不需要提交的文件）

在工作空间中有些文件是不需要记录到版本库中的（例如.idea、target、iml文件），可以通过设置忽略提交 来实现

  • 在工作空间的根目录（项目的根目录）中创健一个名为.g1 tignore文件
  • 在.g1t1 gnore文件配置忽略过滤条件
在这里插入图片描述

04.将工作空间add到暂存区

1. 选择项目文件-右键-Git-Add(添加到暂存区的文件-绿色)
在这里插入图片描述
在这里插入图片描述
2. 如果一个文件创建好之后还没有添加到暂存区-棕红色
在这里插入图片描述
3.添加到暂存区的操作可以设置默认添加
在这里插入图片描述
在这里插入图片描述

06. 克隆远程仓库

方式一
在这里插入图片描述
在这里插入图片描述

方式二
在这里插入图片描述
在这里插入图片描述
克隆一个（开源）的远程仓库
在这里插入图片描述

05.将暂存区提交到版本库

1.选择项目/文件-右键-Git-Commit(记录到版本库的文件-黑色)
在这里插入图片描述
在这里插入图片描述
2. 如果对记录到版本库的文件进行了修改，也就是说工作空间和版本库不一致一-蓝色
在这里插入图片描述
在这里插入图片描述

③：IDEA中Git分支管理

01.创建分支

1. 点击IDEA右下角Git
2. 在弹窗中点击New Branch
3. 输入新分支的名称
在这里插入图片描述

02.切换分支

1.点击IDEA右下角Git
2.点击非当前分支右边的箭头
3. 在选项卡点击checkout
在这里插入图片描述

03.删除分支

在这里插入图片描述

04.合并分支

例如：将dey合并到naster

  • 切换到master分支
  • 点击dey分支右面的箭头，在展开的菜单中选择Merge into current
1.在dev分支中添加一些内容并提交
在这里插入图片描述
在这里插入图片描述

④：IDEA中使用Git进行团队协同开发

01.项目管理者

  1. 完成项目的搭建

  2. 为当前项目创建本地版本库

  3. 将搭建好的项目提交到本地版本库

    1. add到暂存区
    2. 提交

  4. 创建远程仓库

    1. https://gitee.com/c-coke/02_git-demo2.git
    2. 管理👉添加开发者

  5. 将本地仓库push到远程仓库

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
  1. 在远程仓库新建dev分支（master需要进行保护）
在这里插入图片描述
  1. 将本地dev push到远程仓库
    |在这里插入图片描述|
    | 在这里插入图片描述|
  2. 将master分支设置为保护分支
在这里插入图片描述

02.项目开发者

  1. 从管理员提供的远程仓库pull到本地
    1. 远程仓库：https://gitee.com/c-coke/02_git-demo2.git
      在这里插入图片描述
1. 在远程仓库中直接修改代码 模拟其他开发人员
在这里插入图片描述
2. 拉取远程仓库的信息
在这里插入图片描述
在这里插入图片描述

⑤：IDEA中使用Git的冲突解决

1. 模拟同时提交冲突问题
在这里插入图片描述
2. 模拟另外一名开发者 在本地同样的文件中添加一行代码
在这里插入图片描述
3.本地开发人员push到远程仓库
在这里插入图片描述
4.合并两人的代码
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
2-35-git&github-版本控制服务器.doc
11-03
Git作为一个由Linus Torvalds开发的分布式版本控制系统，在软件开发领域扮演着至关重要的角色。它起初是为了帮助管理Linux内核的开发而创造的，但随着时间的推移，它已经成长为一个功能全面、能够适应各种项目需求的...
ffmpeg-2021-02-10-git-e0fd35d867-full_build (1).7z
05-06
Fmpeg 是领先的多媒体框架，能够解码、编码、转码、混合、解密、流媒体、过滤和播放人类和机器创造的几乎所有东西。它支持最晦涩的古老格式，直到最尖端的格式。
git分支管理
IT枫斗者的博客
05-03 1100
Aone Flow 采取了另外一个思路。只存在一个 Master 分支，当要开发时，就拉出新的 Feature 分支，可以同时存在多个 Feature，当达到发布计划时，就把需要合并的多条 Feature 分支合并起来，通过后再往 Master 上合并，并且tag下来。
Git@OSC 新增分支保护功能 : 常规、保护、只读
weixin_34241036的博客
06-05 1813
Git@OSC 新增分支保护功能！ 分支保护功能是为了防止相关成员 Push 代码到重要的分支（例如 master 分支），便于项目的分支管理。 Git@OSC 的分支除了之前的常规分支外，新增两种不同的权限： 常规分支：项目成员（开发者权限及以上）可Push分支 保护分支：项目管理员才能管理（Push）被保护的分支。 只读分支：任何人都无法Push代...
gitlab设置分支保护
qq_492448446的博客
05-19 2万+
1、第一步，找到分支，然后点击setting，然后选择Repository 2.第一步，选择Protected Branches 3.第三步：选择需要被限制的分支，进行权限授权，然后点击protect即可 使用Merge Request时的操作步骤： 编写代码并将其推送到单独的分支。 为主要开发分支创建合并请求。 Assignee以及说明字段和评论中被提到的那些人将通过电子邮件通知合并请求。如果需要某一位开发人员关注，你可以在描述字段中@该名开发人员。 等到MR被接受或拒绝，并.
git 分支 保护分支，以gitee为例
52CRACKING
06-20 2746
假设我们当前项目下有两个分支，分别名为 master 和 dev 根据 gitee 的项目成员权限说明，我们将 master 分支设置为保护分支，将 dev 分支设置为常规分支。如图所示。 然后创建我们的用户及相应 ssh key 假设现在有两个用户分别是 yeahlife@yeah.net...
git版本控制
qq_39933787的博客
01-06 621
分布式版本控制 我们知道，Git是一个开源的分布式版本控制系统，这让团队协作成为了可能。我们可以通过fetch/pull将远程仓库的代码拉取到本地，也可以将本地代码push到远程仓库。 而我们向版本库提交代码的一个基本方向是： 工作区 --> 暂存区 --> 版本库 当对工作区修改（或新增）的文件执行git add命令时，暂存区的目录树被更新。 当执行git commit命令进行提交操作时，暂存区的目录树写到版本库中。 分支管理 Git最核心的内容当然是分支管
ConnectBot-git-v1.9.5-35-ga93051b4-google.apk
02-21
ConnectBot-git-v1.9.5-35-ga93051b4-google.apk
mosh-ultimate-git-course:用Mosh编写代码-终极Git课程
03-16
Git工作流程（4:35） 暂存文件（3:37） 提交更改（2:13） 承诺最佳实践（1:59） 跳过暂存区（1:24） 删除文件（2:02） 重命名或移动文件（2:17） 忽略文件（6:34） 短状态（2:52） 查看已分阶段和未分阶段...
git-history-data:git-history-data分析Git源代码存储库并以易于分析的形式转储数据-git source code
03-25
git-history-data分析Git源代码存储库，并以易于分析的形式转储数据。 以最简单的形式，它为历史记录中的每个文件以及做出更改的人打印出一行，如下所示： $ cd myrepo $ git-history-data "Commit", "Date", ...
gitlab设置保护分支
weixin_39064001的博客
05-02 3001
gitlab设置保护分支
Github——设置分支保护规则
Williamcsj的博客
03-22 6502
Github——设置分支保护规则
GitLab分支保护
热门推荐
weixin_40400084的博客
08-06 2万+
首先 我们项目中提交了2个分支 一个是dev 一个是master 如下图 然后点击左侧 Repostitory 下面有个 Branches 弹出下图 然后点击 project settings. 然后出现 1 代表 你要保护的分支 如果master 或者dev 2 代表 谁有权限去跟这个分支的合并 我选择 Masters //注 我这里Maintainers=同于M...
企业级GIT分支管控方案
qq_28933825的博客
03-18 1829
根据以上描述，企业开发时，实际上长期存在的分支只有master和dev分支，其他分支都是多个且临时的那么本期我们的git分支管控就到此结束了，企业生产中要把控好安全生产，就要严格控制好分支权限，开发时定期更新，减少冲突文章知识点与官方知识档案匹配，可进一步学习相关知识Git技能树首页概览4196人正在系统学习中有问题，可添加我的个人微信微信名片。
gitlab保护分支设置
qq_25096749的博客
10-13 4104
gitlab保护分支
git设置保护分支
weixin_46041797的博客
08-14 4508
1. 新建保护分支规则 可在 管理>设置保护分支 中，点击新建规则按钮，到如下 然后输入分支名称或通配符规则 点击保存即可 2.修改分支 点击 分支 会来到分支管理页面 在此页面中设置分支状态即可，如需进一步设置，点击标注三角形旁边的按钮进行设置即可 更加详细教程：官网链接 ...
优雅的使用git搭建项目环境教程--轻松拉取、合并protected的分支
超哥的博客
07-04 4214
首先下载git，安装（路径为英文），地址自找，o(╯□╰)o。配置git基本环境1） 打开git命令终端，或者在随便一个文件夹下，鼠标右键选择git bash here打开终端。git config --global user.name "姓名" git config --global user.email "你的邮箱" ssh-keygen -t rsa -C "上面填的邮箱&
Gitlab保护分支与合并请求
weixin_42253874的博客
06-27 5857
熟悉了Git工作流之后，有几个重要的分支，如Master(改名为Main)、Develop、Release分支等，是禁止开发成员随意合并和提交的，在此分支上的提交和推送权限仅限项目负责人或维护人员。开发人员如果功能模块测试完善，后可提交合并请求，让维护人员进行审批、代码合并。
Git操作远程仓库及分支的使用
m0_63512120的博客
02-29 2229
常规分支（Regular Branch）：常规分支是指代码仓库中的主要分支，通常是用于存放稳定的、生产可用的代码版本。在常规分支上进行的更改会直接影响到项目的生产环境。在 Gitee 中，通常情况下，master 分支就是常规分支，开发者们会将稳定的、经过测试的代码合并到 master 分支中。保护分支（Protected Branch）：保护分支是指在代码仓库中被设置了额外限制或权限的分支。这些限制可以包括阻止普通开发者直接向该分支推送代码、要求代码审查通过后才能合并等。
Started by user sl Running as SYSTEM Building in workspace /var/jenkins_home/workspace/sl-express-gitflow-web [WS-CLEANUP] Deleting project workspace... [WS-CLEANUP] Deferred wipeout is used... [WS-CLEANUP] Done The recommended git tool is: NONE using credential 81a93e16-3a6b-474b-8727-1293bde49842 Cloning the remote Git repository Cloning repository http://git.sl-express.com/sl/sl-express-gitflow-web.git > /usr/bin/git init /var/jenkins_home/workspace/sl-express-gitflow-web # timeout=10 Fetching upstream changes from http://git.sl-express.com/sl/sl-express-gitflow-web.git > /usr/bin/git --version # timeout=10 > git --version # 'git version 2.30.2' using GIT_ASKPASS to set credentials gogs账号 > /usr/bin/git fetch --tags --force --progress -- http://git.sl-express.com/sl/sl-express-gitflow-web.git +refs/heads/*:refs/remotes/origin/* # timeout=10 > /usr/bin/git config remote.origin.url http://git.sl-express.com/sl/sl-express-gitflow-web.git # timeout=10 > /usr/bin/git config --add remote.origin.fetch +refs/heads/*:refs/remotes/origin/* # timeout=10 Avoid second fetch > /usr/bin/git rev-parse refs/remotes/origin/develop^{commit} # timeout=10 Checking out Revision 46c2028eb5f59801b8baca4d73fa5acbbbb33d2f (refs/remotes/origin/develop) > /usr/bin/git config core.sparsecheckout # timeout=10 > /usr/bin/git checkout -f 46c2028eb5f59801b8baca4d73fa5acbbbb33d2f # timeout=10 Commit message: "实现相乘的接口" > /usr/bin/git rev-list --no-walk 46c2028eb5f59801b8baca4d73fa5acbbbb33d2f # timeout=10 [SSH] script: chmod a+rw /var/run/docker.sock [SSH] executing... [SSH] completed [SSH] exit-status: 0 [sl-express-gitflow-web] $ /maven/bin/mvn -s /maven/conf/settings.xml -gs /maven/conf/settings.xml clean package -Dmaven.test.skip=true -U [INFO] Scanning for projects... [INFO] [INFO] -----------< com.sl-express.gitflow:sl-express-gitflow-web >------------ [INFO] Building sl-express-gitflow-web 1.0-SNAPSHOT [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ sl-express-gitflow-web --- [INFO] [INFO] --- spring-boot-maven-plugin:2.6.6:build-info (default) @ sl-express-gitflow-web --- [INFO] [INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ sl-express-gitflow-web --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] Copying 3 resources [INFO] [INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ sl-express-gitflow-web --- [INFO] Changes detected - recompiling the module! [INFO] Compiling 2 source files to /var/jenkins_home/workspace/sl-express-gitflow-web/target/classes [INFO] [INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ sl-express-gitflow-web --- [INFO] Not copying test resources [INFO] [INFO] --- maven-compiler-plugin:3.1:testCompile (default-testCompile) @ sl-express-gitflow-web --- [INFO] Not compiling test sources [INFO] [INFO] --- maven-surefire-plugin:2.12.4:test (default-test) @ sl-express-gitflow-web --- [INFO] Tests are skipped. [INFO] [INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ sl-express-gitflow-web --- [INFO] Building jar: /var/jenkins_home/workspace/sl-express-gitflow-web/target/sl-express-gitflow-web-1.0-SNAPSHOT.jar [INFO] [INFO] --- spring-boot-maven-plugin:2.6.6:repackage (default) @ sl-express-gitflow-web --- [INFO] Replacing main artifact with repackaged archive [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 4.899 s [INFO] Finished at: 2025-06-29T23:35:04+08:00 [INFO] ------------------------------------------------------------------------ [sl-express-gitflow-web] $ /bin/bash /tmp/jenkins10798732479328880887.sh chmod: cannot access 'target/-1.0-SNAPSHOT.jar': No such file or directory Docker version 20.10.17, build 100c701 ---------停止容器（）--------- "docker stop" requires at least 1 argument. See 'docker stop --help'. Usage: docker stop [OPTIONS] CONTAINER [CONTAINER...] Stop one or more running containers ---------删除容器（）--------- "docker rm" requires at least 1 argument. See 'docker rm --help'. Usage: docker rm [OPTIONS] CONTAINER [CONTAINER...] Remove one or more containers ---------删除镜像（:1.0-SNAPSHOT）--------- Error response from daemon: invalid reference format ---------构建新镜像（:1.0-SNAPSHOT）--------- invalid argument ":1.0-SNAPSHOT" for "-t, --tag" flag: invalid reference format See 'docker build --help'. ---------运行服务--------- docker: invalid reference format: repository name must be lowercase. See 'docker run --help'. Build step 'Execute shell' marked build as failure Finished: FAILURE
最新发布
06-30
在 Jenkins 构建过程中，遇到 `docker stop`, `docker rm`, `docker tag`, `docker build` 等命令执行失败，并提示 `invalid reference format` 错误，通常是由于镜像名称或标签格式不正确所导致的。该问题可能出现在 Jenkinsfile 的构建脚本中，尤其是在使用变量拼接 Docker 镜像名称和标签时[^1]。 ### 常见原因与解决方案 #### 1. **Docker 镜像名或标签为空** 当 Jenkins 使用环境变量定义镜像名称（如 `${env.IMAGE_NAME}`）或标签（如 `${env.BRANCH_NAME}`）时，若变量未正确设置或为空，则会导致 `docker build -t` 或 `docker tag` 操作失败。 **示例错误命令：** ```bash docker build -t ${IMAGE_NAME}:${BRANCH_NAME} . ``` 如果 `BRANCH_NAME` 为 `feature/new-branch` 这样的 Git 分支名，直接用于镜像标签会导致非法字符（如 `/`）出现，从而触发 `invalid reference format` 错误。 **解决方法：** - 对分支名称进行替换处理，避免非法字符： ```bash docker build -t ${IMAGE_NAME}:${BRANCH_NAME//\//-} . ``` - 确保所有变量在 Jenkins Pipeline 中被正确赋值，可通过 `echo` 打印变量内容进行调试： ```groovy echo "Image name: ${env.IMAGE_NAME}, Branch: ${env.BRANCH_NAME}" ``` #### 2. **Jenkins Pipeline 中 Shell 脚本执行方式不当** 在 Jenkins Pipeline 的 `sh` 步骤中，如果命令拼接不当或缺少必要的空格、转义符，也可能导致命令解析失败。 **示例错误写法：** ```groovy sh "docker tag ${IMAGE_NAME}:${BRANCH_NAME} registry.example.com/${IMAGE_NAME}:${BRANCH_NAME}" ``` **改进写法：** 确保变量前后有引号包裹，防止空格或特殊字符干扰： ```groovy sh ''' docker tag "${IMAGE_NAME}:${BRANCH_NAME}" "registry.example.com/${IMAGE_NAME}:${BRANCH_NAME//\//-}" ''' ``` #### 3. **权限问题导致容器操作失败** 如果 Jenkins 容器内部执行 `docker stop` 或 `docker rm` 命令失败，可能是由于容器用户权限不足。默认情况下，Jenkins 容器以非 root 用户运行，无法直接管理宿主机上的 Docker 守护进程[^2]。 **解决方法：** - 启动 Jenkins 容器时指定 `-u root` 以 root 权限运行： ```bash docker run -u root ... jenkinsci/blueocean ``` - 确保挂载了 Docker 套接字： ```bash -v /var/run/docker.sock:/var/run/docker.sock ``` #### 4. **Jenkins 构建节点权限配置不当** 如果 Jenkins 设置了多节点（agent），而某些节点未正确配置 Docker 环境或权限，也可能导致构建失败。 **解决方法：** - 在 Jenkins Pipeline 中明确指定具有 Docker 支持的节点： ```groovy node("docker-node") { stage("Build Image") { sh "docker build -t myapp:${env.BUILD_ID} ." } } ``` --- ### 示例修复后的 Jenkinsfile 片段 ```groovy pipeline { agent any environment { IMAGE_NAME = "myapp" BRANCH_NAME = "${env.GIT_BRANCH}" } stages { stage("Build Docker Image") { steps { script { def sanitizedBranch = BRANCH_NAME.replaceAll("/", "-") sh """ docker build -t \${IMAGE_NAME}:\${sanitizedBranch} . """ } } } stage("Tag and Push") { steps { script { def sanitizedBranch = BRANCH_NAME.replaceAll("/", "-") sh """ docker tag \${IMAGE_NAME}:\${sanitizedBranch} registry.example.com/\${IMAGE_NAME}:\${sanitizedBranch} docker push registry.example.com/\${IMAGE_NAME}:\${sanitizedBranch} """ } } } } } ``` ---
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

七@归七

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值