Gitea Tag
kind: gitea/tag
| source | condition | target |
|---|---|---|
✔ | ✔ | ✗ |
Description
The Gitea "tag" plugin allows to manipulate Gitea repository tags.
source
When used as a "source", the Gitea tag plugin allows to get a Gitea repository tag according the version filter rule provided.
condition
When used as a "condition". the Gitea tag plugin allows to test that specific Gitea tag exist.
target
Target is not supported, feel free to manifest your interest by opening an issue on updatecil/updatecli/issues, or highlighting an existing one.
Parameters
| Name | Type | Description | Required |
|---|---|---|---|
| owner | string | [S][C] Owner specifies repository owner | |
| repository | string | [S][C] Repository specifies the name of a repository for a specific owner | |
| tag | string | [S] Tag defines the Gitea tag . | |
| token | string | “token” specifies the credential used to authenticate with Gitea API 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 https://github.com/getsops/sops | |
| url | string | “url” defines the Gitea url to interact with | |
| username | string | “username” defines the username used to authenticate with Gitea API | |
| versionfilter | object | [S][C] VersionFilter provides parameters to specify version pattern and its type like regex, semver, or just latest. | |
| kind | string | specifies the version kind such as semver, regex, or latest | |
| pattern | string | specifies the version pattern according the version kind | |
| strict | boolean | strict enforce strict versioning rule. Only used for semantic versioning at this time |
Example
# updatecli.yaml
name: "Show Gitea tag usage"
sources:
default:
name: "Get tag using versionfilter from a Gitea repository"
kind: "gitea/tag"
spec:
url: "try.gitea.io"
owner: "olblak"
repository: "updatecli-test"
versionfilter:
kind: "semver"
pattern: "~0.0"
latest:
name: "Get latest tag tag from a Gitea repository"
kind: "gitea/tag"
spec:
url: "try.gitea.io"
owner: "olblak"
repository: "updatecli-test"
conditions:
default:
name: "Test tag '0.0.2' exist on the Gitea repository"
kind: "gitea/tag"
disablesourceinput: true
spec:
url: "try.gitea.io"
owner: "olblak"
repository: "updatecli-test"
tag: "0.0.2"
sourcedefault:
name: "Test that the tag retrieved from source 'default' exist on the Gitea repository"
kind: "gitea/tag"
sourceid: "default"
spec:
url: "try.gitea.io"
owner: "olblak"
repository: "updatecli-test"
latest:
name: "Test that the tag retrieved from source 'latest' exist on the Gitea repository"
kind: "gitea/tag"
sourceid: "latest"
spec:
url: "try.gitea.io"
owner: "olblak"
repository: "updatecli-test"