GitLab Search

“branch” defines the git branch to work on.

compatible:

• scm

default: ^main$

remark: The branch value is a regular expression used to match branches across the discovered repositories.

If the scm is linked to a source or a condition (using scmid), the branch will be used to retrieve file(s) from that branch.

If the scm is linked to a target then Updatecli creates a new “working branch” based on the branch value. The working branch created by Updatecli looks like “updatecli_”. The working branch can be disabled using the “workingBranch” parameter set to false.

“commitMessage” is used to generate the final commit message.

compatible:

• scm

remark: it’s worth mentioning that the commit message settings is applied to all targets linked to the same scm.

body defines the commit body of the commit message as defined by the conventional commit specification. More information on -> https://www.conventionalcommits.org/en/

default: none

footers defines the footer of the commit message as defined by the conventional commit specification. More information on -> https://www.conventionalcommits.org/en/

default: none

hideCredit defines if updatecli credits should be displayed inside commit message body

please consider sponsoring the Updatecli project if you want to disable credits. -> https://github.com/updatecli/updatecli

default: false

scope defines the scope of the commit message as defined by the conventional commit specification. More information on -> https://www.conventionalcommits.org/en/

default: none

squash defines if the commit should be squashed

default: false

important: if squash is set to true, then it’s highly recommended to set the commit body to a meaningful value as all other commit information will be lost during the squash operation.

if body is not set, then the commit title/message will be generated based on the most recent commit message of the squashed commits. The commit title is always generated from the target name or description.

type defines the type of commit message such as “chore”, “fix”, “feat”, etc. as defined by the conventional commit specification. More information on -> https://www.conventionalcommits.org/en/

default:

• chore

Depth defines the depth used when cloning the git repository.

Default: disabled (full clone)

Remark: When using a shallow clone (depth greater than 0), Updatecli is not able to retrieve the full git history. This may cause some issues when Updatecli tries to push changes to the remote repository. In that case, you may need to set the force option to true to force push changes to the remote repository.

“directory” defines the local path where the git repository is cloned.

compatible:

• scm

remark: Unless you know what you are doing, it is recommended to use the default value. The reason is that Updatecli may automatically clean up the directory after a pipeline execution.

default: The default value is based on your local temporary directory like: (on Linux) /tmp/updatecli/gitlab//

“email” defines the email used to commit changes.

compatible:

• scm

default: default set to your global git configuration

“force” is used during the git push phase to run git push --force.

compatible:

• scm

default: true

remark: When force is set to true, Updatecli also recreates the working branches that diverged from their base branch.

“gpg” specifies the GPG key and passphrase used for commit signing

compatible:

• scm

signingKey defines the gpg key used to sign the commit message

default: none

“group” defines the GitLab group (or subgroup) to search repositories in.

compatible:

• scm

remark: Supports nested groups using slash notation, e.g. “myorg/myteam”.

“includeSubgroups” defines whether projects from subgroups should be included in the search results.

compatible:

• scm

default: true

Limit defines the maximum number of repositories to return.

compatible:

• scm

default: 10

remark: If limit is set to 0, all repositories matching the query will be returned.

“search” filters the repository list by name.

compatible:

• scm

remark: When omitted, all projects in the group are returned.

“submodules” defines if Updatecli should checkout submodules.

compatible:

• scm

default: true

“token” defines the credential used to authenticate with GitLab

remark: A token is a sensitive information, it’s recommended to not set this value directly in the configuration file but to use an environment variable or a SOPS file.

The value can be set to {{ requiredEnv "GITLAB_TOKEN"}} to retrieve the token from the environment variable GITLAB_TOKEN or {{ .gitlab.token }} to retrieve the token from a SOPS file.

For more information, about a SOPS file, please refer to the following documentation: https://github.com/getsops/sops

“url” defines the GitLab url to interact with

default: “gitlab.com”

“user” specifies the user associated with new git commit messages created by Updatecli

compatible:

• scm

“workingBranch” defines if Updatecli should use a temporary branch to work on. If set to true, Updatecli create a temporary branch to work on, based on the branch value.

compatible:

• scm

default: true

WorkingBranchPrefix defines the prefix used to create a working branch.

compatible:

• scm

default: updatecli

remark: A working branch is composed of three components:

1. WorkingBranchPrefix
2. Target Branch
3. PipelineID

If WorkingBranchPrefix is set to ‘’, then the working branch will look like “_”.

WorkingBranchSeparator defines the separator used to create a working branch.

compatible:

• scm

default: “_”