Skip to main content
Version: 3.17-dev

Manage Git Servers

Git Server is responsible for integration with Version Control System, whether it is GitHub, GitLab, Bitbucket, or Gerrit.


The Git Server is set via the global.gitProviders parameter of the values.yaml file.

To view the current Git Server, you can open Portal Configuration -> Git Servers and inspect the following properties:

  • Git Server status and name - displays the Git Server status, which depends on the Git Server integration status (Success/Failed).
  • Git Server properties - displays the Git Server type, its host address, username, SSH/HTTPS port, public and private SSH keys. See Add Git Server for the SSH host key verification requirement that applies when a private SSH key is configured.
  • Learn more - opens the "Manage Git Servers" documentation page.
  • Undo/Save changes - these buttons apply or revert changes made to the Git Server.
  • + Add Git Server - add a new blank to specify the new Git Server's parameters.
  • Delete a Git Server - deletes the Git Server after confirmation.

KubeRocketCI supports one Git Server per provider: GitHub, GitLab, Bitbucket, and Gerrit, so the platform has up to four Git Servers. A Git Server created in the portal is named after its provider, for example github.

Edit Git Server​

Open a Git Server in the list to change its host, ports, token, and SSH keys. The Git Server name is not shown and cannot be changed.

warning

Portal 0.9.0 (KubeRocketCI 3.16.0) let you name a Git Server freely, and stored its credentials in a ci-<git-server-name> Secret. The Tekton triggers look up ci-<provider>, so webhooks of a Git Server whose name differs from its provider do not start pipelines. Such a Git Server stays visible and editable, but the portal no longer creates one. See Upgrade 3.16.0 to 3.16.1.

View Authentication Data​

To view the authentication data used to connect to the Git server, click the eye icon in the corresponding field, or read the Secret that the Git Server names in its spec.nameSshKeySecret field:

kubectl get secret "$(kubectl get gitserver <git_server_name> -n krci -o jsonpath='{.spec.nameSshKeySecret}')" -n krci -o yaml

Delete Git Server​

There are two ways for deleting Git server: using KubeRocketCI portal or CLI.

To delete a Git server using KubeRocketCI portal, follow the steps below:

  1. Navigate to KubeRocketCI portal -> Configuration -> Version Control System.

  2. In the Version Control System tab, click the bin icon.

  3. In the confirmation window, enter confirm and click Delete.