diff options
author | GitLab Bot <gitlab-bot@gitlab.com> | 2023-09-21 00:10:41 +0300 |
---|---|---|
committer | GitLab Bot <gitlab-bot@gitlab.com> | 2023-09-21 00:10:41 +0300 |
commit | 5bbc92d39c958030d839507cf446d30e656a0f7c (patch) | |
tree | de59743db1c3d55bb9f105c53402b0eacfa2f96f /doc/integration | |
parent | d66aa9b2992a7d44cc6bae54dfa1c3ba08ad8ef4 (diff) |
Add latest changes from gitlab-org/gitlab@master
Diffstat (limited to 'doc/integration')
-rw-r--r-- | doc/integration/index.md | 31 | ||||
-rw-r--r-- | doc/integration/jenkins.md | 3 |
2 files changed, 22 insertions, 12 deletions
diff --git a/doc/integration/index.md b/doc/integration/index.md index a8aabeefc76..e2c73433006 100644 --- a/doc/integration/index.md +++ b/doc/integration/index.md @@ -6,12 +6,12 @@ info: To determine the technical writer assigned to the Stage/Group associated w # Integrate with GitLab **(FREE ALL)** -You can integrate GitLab with external services for enhanced functionality. +You can integrate GitLab with external applications for enhanced functionality. -## Services +## Project integrations -Services such as Campfire, Jira, Pivotal Tracker, and Slack -are available as [integrations](../user/project/integrations/index.md). +Applications like Jira, Pivotal Tracker, and Slack are available +as [project integrations](../user/project/integrations/index.md). ## Issue trackers @@ -39,7 +39,7 @@ You can integrate GitLab with the following authentication sources: - Twitter - Use GitLab as an [OpenID Connect](openid_connect_provider.md) identity provider. - Authenticate with [Vault](vault.md) through GitLab OpenID Connect. -- Configure GitLab as a [SAML 2.0](saml.md) Service Provider. +- Configure GitLab as a [SAML 2.0](saml.md) service provider. ## Security enhancements @@ -76,7 +76,7 @@ You can integrate GitLab with the following security partners: ## Continuous integration -You can integrate GitLab with the following external services for continuous integration: +You can integrate GitLab with the following external applications for continuous integration: - [Jenkins](jenkins.md) CI. - [Datadog](datadog.md) to monitor for CI/CD job failures and performance issues. @@ -94,17 +94,19 @@ or [Kroki](../administration/integration/kroki.md) to use diagrams in AsciiDoc a ## Troubleshooting +When working with integrations, you might encounter the following issues. + ### SSL certificate errors -When integrating GitLab with services using a self-signed certificate, you might +When you use a self-signed certificate to integrate GitLab with external applications, you might encounter SSL certificate errors in different parts of the application. -As a workaround, you can do one of the following: +As a workaround, do one of the following: -- Add the certificate to the OS trusted chain. See: +- Add the certificate to the OS trusted chain. For more information, see: - [Adding trusted root certificates to the server](https://manuals.gfi.com/en/kerio/connect/content/server-configuration/ssl-certificates/adding-trusted-root-certificates-to-the-server-1605.html) - [How do you add a certificate authority (CA) to Ubuntu?](https://superuser.com/questions/437330/how-do-you-add-a-certificate-authority-ca-to-ubuntu) -- In Omnibus GitLab, add the certificate to the Omnibus trusted chain: +- For installations that use the Linux package, add the certificate to the GitLab trusted chain: 1. [Install the self-signed certificate](https://docs.gitlab.com/omnibus/settings/ssl/index.html#install-custom-public-certificates). 1. Concatenate the self-signed certificate with the GitLab trusted certificate. The self-signed certificate might be overwritten during upgrades. @@ -133,3 +135,12 @@ You can find information in: - `json.exception.class` - `json.exception.message` - `json.message` + +### `Test Failed. Save Anyway` error + +When you configure an integration on an uninitialized repository, the integration might fail with +a `Test Failed. Save Anyway` error. This error occurs because the integration uses push data +to build the test payload when the project does not have push events. + +To resolve this issue, initialize the repository by pushing a test file to the project +and configure the integration again. diff --git a/doc/integration/jenkins.md b/doc/integration/jenkins.md index 4f76301adeb..a65ca3a20ba 100644 --- a/doc/integration/jenkins.md +++ b/doc/integration/jenkins.md @@ -197,8 +197,7 @@ which is set to 10 seconds by default. For this issue, check: -- [Integration webhook logs](../user/project/integrations/index.md#troubleshooting) -for request failures. +- The integration webhook logs for request failures. - `/var/log/gitlab/gitlab-rails/production.log` for messages like: ```plaintext |