diff options
author | GitLab Bot <gitlab-bot@gitlab.com> | 2020-01-24 18:09:00 +0300 |
---|---|---|
committer | GitLab Bot <gitlab-bot@gitlab.com> | 2020-01-24 18:09:00 +0300 |
commit | c282dba898a4cb0645f88579339502a4e3778727 (patch) | |
tree | 94a6457ce4438e085c9ae43bc51a2b5a29787bf2 /doc/user/packages/maven_repository | |
parent | 2c2dd5e36c4ed5f09f488be288882d98f9124d12 (diff) |
Add latest changes from gitlab-org/gitlab@master
Diffstat (limited to 'doc/user/packages/maven_repository')
-rw-r--r-- | doc/user/packages/maven_repository/index.md | 50 |
1 files changed, 50 insertions, 0 deletions
diff --git a/doc/user/packages/maven_repository/index.md b/doc/user/packages/maven_repository/index.md index da5139fcaf9..ea052703416 100644 --- a/doc/user/packages/maven_repository/index.md +++ b/doc/user/packages/maven_repository/index.md @@ -338,3 +338,53 @@ The next time the `deploy` job runs, it will copy `ci_settings.xml` to the user's home location (in this case the user is `root` since it runs in a Docker container), and Maven will utilize the configured CI [environment variables](../../../ci/variables/README.md#predefined-environment-variables). + +## Troubleshooting + +### Useful Maven command line options + +There's some [maven command line options](https://maven.apache.org/ref/current/maven-embedder/cli.html) +which maybe useful when doing tasks with GitLab CI. + +- File transfer progress can make the CI logs hard to read. + Option `-ntp,--no-transfer-progress` was added in + [3.6.1](https://maven.apache.org/docs/3.6.1/release-notes.html#User_visible_Changes). + Alternatively, look at `-B,--batch-mode` + [or lower level logging changes.](https://stackoverflow.com/questions/21638697/disable-maven-download-progress-indication) + +- Specify where to find the POM file (`-f,--file`): + + ```yaml + package: + script: + - 'mvn --no-transfer-progress -f helloworld/pom.xml package' + ``` + +- Specify where to find the user settings (`-s,--settings`) instead of + [the default location](https://maven.apache.org/settings.html). There's also a `-gs,--global-settings` option: + + ```yaml + package: + script: + - 'mvn -s settings/ci.xml package' + ``` + +### Verifying your Maven settings + +If you encounter issues within CI that relate to the `settings.xml` file, it might be useful +to add an additional script task or job to +[verify the effective settings](https://maven.apache.org/plugins/maven-help-plugin/effective-settings-mojo.html). + +The help plugin can also provide +[system properties](https://maven.apache.org/plugins/maven-help-plugin/system-mojo.html), including environment variables: + +```yaml +mvn-settings: + script: + - 'mvn help:effective-settings' + +package: + script: + - 'mvn help:system' + - 'mvn package' +``` |