gitlab-cli
GitLab CLI is a command-line tool that allows you to interact with the GitLab API.See https://gitlab.com/gitlab-org/cli for more information.
This module also contains the (deprecated) GitLab Release CLI.
See https://gitlab.com/gitlab-org/release-cli for more information.
Installation
dagger install github.com/vbehar/daggerverse/gitlab-cli@v0.7.0
Entrypoint
Return Type
GitlabCli !
Arguments
Name | Type | Default Value | Description |
---|---|---|---|
privateToken | Secret | - | private (personal) token to use for authentication with GitLab. |
jobToken | Secret | - | (CI) job token to use for authentication with GitLab. Defined as CI_JOB_TOKEN in the GitLab CI environment. |
host | String | - | host of the GitLab instance. |
repo | String | - | default gitlab repository for commands accepting the --repo flag. |
group | String | - | default gitlab group for commands accepting the --group flag. |
releaseCliVersion | String | "v0.18.0" | version of the GitLab Release CLI tool to use. https://gitlab.com/gitlab-org/release-cli |
Example
dagger -m github.com/vbehar/daggerverse/gitlab-cli@fe6e45ee7ce7ef44b0b15c906e4e936278f93fe6 call \
func (m *myModule) example() *GitlabCli {
return dag.
GitlabCli()
}
@function
def example() -> dag.GitlabCli:
return (
dag.gitlab_cli()
)
@func()
example(): GitlabCli {
return dag
.gitlabCli()
}
Types
GitlabCli 🔗
GitlabCli is a Dagger Module to interact with the GitLab CLI.
privateToken() 🔗
Return Type
Secret !
Example
dagger -m github.com/vbehar/daggerverse/gitlab-cli@fe6e45ee7ce7ef44b0b15c906e4e936278f93fe6 call \
private-token
func (m *myModule) example() *Secret {
return dag.
GitlabCli().
PrivateToken()
}
@function
def example() -> dagger.Secret:
return (
dag.gitlab_cli()
.private_token()
)
@func()
example(): Secret {
return dag
.gitlabCli()
.privateToken()
}
jobToken() 🔗
Return Type
Secret !
Example
dagger -m github.com/vbehar/daggerverse/gitlab-cli@fe6e45ee7ce7ef44b0b15c906e4e936278f93fe6 call \
job-token
func (m *myModule) example() *Secret {
return dag.
GitlabCli().
JobToken()
}
@function
def example() -> dagger.Secret:
return (
dag.gitlab_cli()
.job_token()
)
@func()
example(): Secret {
return dag
.gitlabCli()
.jobToken()
}
host() 🔗
Return Type
String !
Example
dagger -m github.com/vbehar/daggerverse/gitlab-cli@fe6e45ee7ce7ef44b0b15c906e4e936278f93fe6 call \
host
func (m *myModule) example(ctx context.Context) string {
return dag.
GitlabCli().
Host(ctx)
}
@function
async def example() -> str:
return await (
dag.gitlab_cli()
.host()
)
@func()
async example(): Promise<string> {
return dag
.gitlabCli()
.host()
}
repo() 🔗
Return Type
String !
Example
dagger -m github.com/vbehar/daggerverse/gitlab-cli@fe6e45ee7ce7ef44b0b15c906e4e936278f93fe6 call \
repo
func (m *myModule) example(ctx context.Context) string {
return dag.
GitlabCli().
Repo(ctx)
}
@function
async def example() -> str:
return await (
dag.gitlab_cli()
.repo()
)
@func()
async example(): Promise<string> {
return dag
.gitlabCli()
.repo()
}
group() 🔗
Return Type
String !
Example
dagger -m github.com/vbehar/daggerverse/gitlab-cli@fe6e45ee7ce7ef44b0b15c906e4e936278f93fe6 call \
group
func (m *myModule) example(ctx context.Context) string {
return dag.
GitlabCli().
Group(ctx)
}
@function
async def example() -> str:
return await (
dag.gitlab_cli()
.group()
)
@func()
async example(): Promise<string> {
return dag
.gitlabCli()
.group()
}
releaseCliVersion() 🔗
Return Type
String !
Example
dagger -m github.com/vbehar/daggerverse/gitlab-cli@fe6e45ee7ce7ef44b0b15c906e4e936278f93fe6 call \
release-cli-version
func (m *myModule) example(ctx context.Context) string {
return dag.
GitlabCli().
ReleaseCliVersion(ctx)
}
@function
async def example() -> str:
return await (
dag.gitlab_cli()
.release_cli_version()
)
@func()
async example(): Promise<string> {
return dag
.gitlabCli()
.releaseCliVersion()
}
container() 🔗
Container returns a container with the GitLab CLI installed.
Return Type
Container !
Example
dagger -m github.com/vbehar/daggerverse/gitlab-cli@fe6e45ee7ce7ef44b0b15c906e4e936278f93fe6 call \
container
func (m *myModule) example() *Container {
return dag.
GitlabCli().
Container()
}
@function
def example() -> dagger.Container:
return (
dag.gitlab_cli()
.container()
)
@func()
example(): Container {
return dag
.gitlabCli()
.container()
}
run() 🔗
Run runs the glab CLI with the given arguments.
Return Type
String !
Arguments
Name | Type | Default Value | Description |
---|---|---|---|
args | [String ! ] | - | arguments to pass to the glab CLI |
ctr | Container | - | container to use for the command, instead of the default container you can use this to customize the container |
Example
dagger -m github.com/vbehar/daggerverse/gitlab-cli@fe6e45ee7ce7ef44b0b15c906e4e936278f93fe6 call \
run
func (m *myModule) example(ctx context.Context) string {
return dag.
GitlabCli().
Run(ctx)
}
@function
async def example() -> str:
return await (
dag.gitlab_cli()
.run()
)
@func()
async example(): Promise<string> {
return dag
.gitlabCli()
.run()
}
release() 🔗
Release allows you to interact with GitLab Releases.
Return Type
GitlabCliRelease !
Arguments
Name | Type | Default Value | Description |
---|---|---|---|
tagName | String ! | - | name of the tag. |
descriptionFile | File | - | a file from which to read the release description. |
ctr | Container | - | container to use for the command, instead of the default container you can use this to customize the container |
Example
dagger -m github.com/vbehar/daggerverse/gitlab-cli@fe6e45ee7ce7ef44b0b15c906e4e936278f93fe6 call \
release --tag-name string
func (m *myModule) example(tagName string) *GitlabCliRelease {
return dag.
GitlabCli().
Release(tagName)
}
@function
def example(tag_name: str) -> dag.GitlabCliRelease:
return (
dag.gitlab_cli()
.release(tag_name)
)
@func()
example(tagName: string): GitlabCliRelease {
return dag
.gitlabCli()
.release(tagName)
}
GitlabCliRelease 🔗
Release allows you to interact with GitLab Releases.
tagName() 🔗
Return Type
String !
Example
dagger -m github.com/vbehar/daggerverse/gitlab-cli@fe6e45ee7ce7ef44b0b15c906e4e936278f93fe6 call \
release --tag-name string \
tag-name
func (m *myModule) example(ctx context.Context, tagName string) string {
return dag.
GitlabCli().
Release(tagName).
TagName(ctx)
}
@function
async def example(tag_name: str) -> str:
return await (
dag.gitlab_cli()
.release(tag_name)
.tag_name()
)
@func()
async example(tagName: string): Promise<string> {
return dag
.gitlabCli()
.release(tagName)
.tagName()
}
descriptionFile() 🔗
Return Type
File !
Example
dagger -m github.com/vbehar/daggerverse/gitlab-cli@fe6e45ee7ce7ef44b0b15c906e4e936278f93fe6 call \
release --tag-name string \
description-file
func (m *myModule) example(tagName string) *File {
return dag.
GitlabCli().
Release(tagName).
DescriptionFile()
}
@function
def example(tag_name: str) -> dagger.File:
return (
dag.gitlab_cli()
.release(tag_name)
.description_file()
)
@func()
example(tagName: string): File {
return dag
.gitlabCli()
.release(tagName)
.descriptionFile()
}
ctr() 🔗
Return Type
Container !
Example
dagger -m github.com/vbehar/daggerverse/gitlab-cli@fe6e45ee7ce7ef44b0b15c906e4e936278f93fe6 call \
release --tag-name string \
ctr
func (m *myModule) example(tagName string) *Container {
return dag.
GitlabCli().
Release(tagName).
Ctr()
}
@function
def example(tag_name: str) -> dagger.Container:
return (
dag.gitlab_cli()
.release(tag_name)
.ctr()
)
@func()
example(tagName: string): Container {
return dag
.gitlabCli()
.release(tagName)
.ctr()
}
container() 🔗
Container returns a container ready to be used for managing releases.
Return Type
Container !
Example
dagger -m github.com/vbehar/daggerverse/gitlab-cli@fe6e45ee7ce7ef44b0b15c906e4e936278f93fe6 call \
release --tag-name string \
container
func (m *myModule) example(tagName string) *Container {
return dag.
GitlabCli().
Release(tagName).
Container()
}
@function
def example(tag_name: str) -> dagger.Container:
return (
dag.gitlab_cli()
.release(tag_name)
.container()
)
@func()
example(tagName: string): Container {
return dag
.gitlabCli()
.release(tagName)
.container()
}
create() 🔗
CreateRelease creates a new release for the given tag. If the tag doesn’t exist, it will be created - if you also provide a gitRef.
Return Type
String !
Arguments
Name | Type | Default Value | Description |
---|---|---|---|
gitRef | String | - | if the tag should be created, it will be created from this ref. can be a commit or a branch. |
Example
dagger -m github.com/vbehar/daggerverse/gitlab-cli@fe6e45ee7ce7ef44b0b15c906e4e936278f93fe6 call \
release --tag-name string \
create
func (m *myModule) example(ctx context.Context, tagName string) string {
return dag.
GitlabCli().
Release(tagName).
Create(ctx)
}
@function
async def example(tag_name: str) -> str:
return await (
dag.gitlab_cli()
.release(tag_name)
.create()
)
@func()
async example(tagName: string): Promise<string> {
return dag
.gitlabCli()
.release(tagName)
.create()
}
update() 🔗
UpdateRelease updates an existing release for the given tag.
Return Type
String !
Example
dagger -m github.com/vbehar/daggerverse/gitlab-cli@fe6e45ee7ce7ef44b0b15c906e4e936278f93fe6 call \
release --tag-name string \
update
func (m *myModule) example(ctx context.Context, tagName string) string {
return dag.
GitlabCli().
Release(tagName).
Update(ctx)
}
@function
async def example(tag_name: str) -> str:
return await (
dag.gitlab_cli()
.release(tag_name)
.update()
)
@func()
async example(tagName: string): Promise<string> {
return dag
.gitlabCli()
.release(tagName)
.update()
}