lunny/git-lfs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge pull request #5177 from bk2204/jenkins-faq

Browse Source 
Add a FAQ entry on Jenkins problems
This commit is contained in:
brian m. carlson 2022-11-30 21:51:29 +00:00 committed by GitHub
commit 13e6543151
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 20 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
docs/man/git-lfs-faq.adoc
View File

@ -137,6 +137,23 @@ patterns are possible: run `git help gitattributes` for more information on
valid patterns. Note that if you're specifying directories, using slashes is
mandatory: backslashes are not allowed as path separators.
I'm using Jenkins and `git lfs install` fails due to an invalid hook path. What do I do?::
Recent versions of Jenkins have set `core.hooksPath` to various values,
notably `NUL:` on Windows, with the goal of disabling hooks. This is not a
valid path on Windows, nor a valid value for this configuration option, so
when `git lfs install` runs and Git LFS attempts to install hooks, the
operation fails.
+
The easiest way to solve this problem is by using the `--skip-repo` option to
`git lfs install`, which skips the installation of the hooks. Despite the name,
it can be successfully combined with `--local` if you need that option.
+
Note that this prevents things like `git push` from pushing LFS objects and
locked files from being read only, since those are implemented by hooks. If you
need that functionality, you should review the Jenkins documentation about how
to properly configure the environment in such a situation so that hooks can be
used.
== SEE ALSO
git-config(1), git-lfs-install(1), gitattributes(5), gitignore(5).

5
docs/man/git-lfs-install.adoc
View File

@ -50,8 +50,9 @@ and clean filters if they are not already set.
manual "git lfs pull" every time a new commit is checked out on your
repository.
`--skip-repo`::
Skips setup of the local repo; use if you want to install the global lfs
filters but not make changes to the current repo.
Skips installation of hooks into the local repository; use if you want to
install the LFS filters but not make changes to the hooks. It is valid to use
`--local`, `--global`, or `--system` in conjunction with this option.
== SEE ALSO