diff options
author | Jacob Vosmaer (GitLab) <jacob@gitlab.com> | 2018-01-05 14:31:12 +0300 |
---|---|---|
committer | Rémy Coutable <remy@rymai.me> | 2018-01-05 14:31:12 +0300 |
commit | c5e2c0665fe7e4937689cfedaa064aa64f538c8b (patch) | |
tree | 0b758368b0191fdd4e6f95d862b2265b8e0bdd7c /doc/development/gitaly.md | |
parent | e4b8e913245cad07504a1de658301d90b1e0506f (diff) |
Allow local tests to use a modified Gitaly
Diffstat (limited to 'doc/development/gitaly.md')
-rw-r--r-- | doc/development/gitaly.md | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/doc/development/gitaly.md b/doc/development/gitaly.md index ca2048c7019..26abf967dcf 100644 --- a/doc/development/gitaly.md +++ b/doc/development/gitaly.md @@ -97,6 +97,29 @@ describe 'Gitaly Request count tests' do end ``` +## Running tests with a locally modified version of Gitaly + +Normally, gitlab-ce/ee tests use a local clone of Gitaly in `tmp/tests/gitaly` +pinned at the version specified in GITALY_SERVER_VERSION. If you want +to run tests locally against a modified version of Gitaly you can +replace `tmp/tests/gitaly` with a symlink. + +```shell +rm -rf tmp/tests/gitaly +ln -s /path/to/gitaly tmp/tests/gitaly +``` + +Make sure you run `make` in your local Gitaly directory before running +tests. Otherwise, Gitaly will fail to boot. + +If you make changes to your local Gitaly in between test runs you need +to manually run `make` again. + +Note that CI tests will not use your locally modified version of +Gitaly. To use a custom Gitaly version in CI you need to update +GITALY_SERVER_VERSION. You can use the format `=revision` to use a +non-tagged commit from https://gitlab.com/gitlab-org/gitaly in CI. + --- [Return to Development documentation](README.md) |