Git客户

ID:git-client

介绍

必威国际有限公司詹金斯的标志+Git的标志

git客户端插件为Jenkins插件提供了git应用程序编程接口(api)。必威国际有限公司它可以获取、签出、分支、列表、合并和标记存储库。指的是API文档获取特定API的详细信息。

GitClient接口提供git访问的主要入口点。它支持使用HTTP和HTTPS协议访问git仓库的用户名/密码凭据(例如,https://github.com/必威国际有限公司jenkinsci/git-client-pluginhttp://git.example.com/your-repo.git).它支持使用SSH协议访问git存储库的私钥凭证(例如,git@github.com:必威国际有限公司 jenkinsci / git-client-plugin.gitssh: / / git@github.c必威国际有限公司om/jenkinsci/git-client-plugin.git).证书支持由必威国际有限公司詹金斯凭证插件

更新日志的GitHub版本

发布说明已经记录在GitHub因为git客户端插件2.8.1。之前的版本说明记录在git客户端插件库中更改日志

实现

git客户端插件默认实现需要这样做git命令行安装在控制器和所有使用git的代理上。使用大文件的命令行git实现也应该安装git LFS.命令行git实现是git客户端插件提供的git接口的规范实现。

命令行git是默认启用安装git客户端插件时。

JGit

git客户端插件还包括两个可选的实现("jgit"和“jgitapache”),用Eclipse JGit, git的纯Java实现。git客户端插件中的JGit实现提供了命令行git实现的大部分功能。当JGit实现不完整时,会在控制台日志中记录这种差异。

JGit是默认情况下禁用安装git客户端插件时。

使JGit

点击“添加Git“按钮在”全球工具配置“下一节”管理詹金斯必威国际有限公司,以添加JGit或JGit与Apache HTTP客户端作为git实现。

使用Apache HTTP客户端启用JGit或JGit

JGit与Apache HTTP客户端

git客户端插件中的原始JGit实现在活动目录身份验证方面存在问题。实现了一个解决方案来提供JGit,但使用Apache HTTP客户端进行身份验证。JGit中的问题现在已经解决,并在git客户端插件版本中发布。JGit与Apache HTTP客户端继续交付,以确保兼容性。

安装PortableGit自动

可以安装git客户端插件Git for Windows Portable自动从一个zip文件。

配置Git for Windows Portable以自动安装
  • 下载并安装Git for Windows Portable从它的7z.exe文件。

  • 创建安装的zip文件为PortableGit-a.bb.c.zip

  • 将zip文件上传到HTTP服务器。

  • 设置下载二进制归档文件的URL为上传的zip文件的URL。

  • 离开Git之路可执行的,git

  • 指定PortableGit-a.bb.c \ bin \ git.exe提取的归档文件的子目录.这指向归档文件中的git.exe相对于归档文件的根。

Git for Windows Portable将安装在每个代理git工具\ \ PortableGit-a.bb.c.git可执行文件的路径为git工具\ \ PortableGit-a.bb.c \ bin \ git.exe

Windows证书管理器

Git for Windows能够与Windows凭据管理器集成,以安全存储凭据。Windows凭证管理器非常适合Windows桌面上的交互式用户。Windows凭证管理器不适用于git客户端插件中的批处理。在运行Windows的Jenkins代理上安装Git时,最好禁用Windows凭据管理器。必威国际有限公司

错误报告

的报告问题和增强必威国际有限公司詹金斯问题跟踪器.请使用“如何报告问题”报告问题时的指导方针。

为插件做贡献

为插件做出贡献对贡献的指导方针。

插件属性

有些插件设置是由Java系统属性控制的。属性通常用于覆盖标准行为或恢复到以前的行为。指必威国际有限公司由系统属性控制的Jenkins特征有关系统属性和如何设置它们的详细信息。

checkRemoteURL

org.必威国际有限公司jenkinsci.plugins.gitclient.CliGitAPIImpl.checkRemoteURL被设置为它禁用了对存储库url的安全检查。

默认是真正的因此,如果存储库URL以-或包含空格字符。

forceFetch

org.必威国际有限公司jenkinsci.plugins.gitclient.CliGitAPIImpl.forceFetch被设置为它允许命令行git版本2.20和更高版本不更新已经被提取到工作区中的标签。

命令行git 2.20和更高版本在获取存储库中已经存在的远程标记时改变了行为。命令行git在2.20之前静默地更新一个现有的标记,如果远程标记指向一个与本地标记不同的SHA1。命令行git 2.20或更高版本不更新现有的标记,如果远程标记指向与本地标记不同的SHA1,除非——力选项被传递给git获取

默认是真正的因此,新的命令行git版本的行为与旧版本相同。

promptForAuthentication

org.必威国际有限公司jenkinsci.plugins.gitclient.CliGitAPIImpl.promptForAuthentication被设置为真正的它允许命令行git 2.3及更高版本提示用户进行身份验证。命令行git提示身份验证应该很少,因为Jenkins凭据应该通过凭据插件来管理。必威国际有限公司

凭据提示可能发生在多个平台上,但在Windows计算机上更常见,因为许多Windows代理从桌面环境运行。在Unix环境中,在桌面上运行的代理要少见得多。

默认是命令行git不会提示交互式身份验证。

useCLI

org.必威国际有限公司jenkinsci.plugins.gitclient.CliGitAPIImpl.useCLI被设置为,它将使用JGit作为默认实现,而不是命令行git。

默认是真正的命令行git被选为默认实现。

user.name.file.encoding

org.必威国际有限公司jenkinsci.plugins.gitclient.CliGitAPIImpl.user.name.file.encoding设置为非空值(如ibm - 1047),并且代理在IBM zOS上运行,则使用该字符集编写用户名凭据文件。其他凭据文件的字符集不变。其他操作系统上的字符集不变。

默认值为空,因此zOS文件编码行为与之前一样。

user.passphrase.file.encoding

org.必威国际有限公司jenkinsci.plugins.gitclient.CliGitAPIImpl.user.passphrase.file.encoding设置为非空值(如ibm - 1047)和代理在IBM zOS上运行时,ssh密码短语文件使用该字符集编写。其他凭据文件的字符集不变。其他操作系统上的字符集不变。

默认值为空,因此zOS文件编码行为与之前一样。

user.password.file.encoding

org.必威国际有限公司jenkinsci.plugins.gitclient.CliGitAPIImpl.user.password.file.encoding设置为非空值(如ibm - 1047),并且代理在IBM zOS上运行,则使用该字符集编写密码文件。其他凭据文件的字符集不变。其他操作系统上的字符集不变。

默认值为空,因此zOS文件编码行为与之前一样。

useSETSID

org.必威国际有限公司jenkinsci.plugins.gitclient.CliGitAPIImpl.useSETSID被设置为真正的setsid命令可用时,非windows计算机上的git客户端进程将使用setsid命令使它们与任何控制终端分离。大多数代理运行时没有控制终端和useSETSID不需要设置。启用useSETSID仅在代理与控制终端一起运行的极少数情况下。如果在这些情况下不使用它,代理可能会阻塞一些经过身份验证的git操作。

这个设置对你很有帮助必威国际有限公司詹金斯群代理入站代理从终端模拟器启动。

默认是setsid是不习惯。