gitea-ephemeral-instance
Installation
Entrypoint
Types
GiteaEphemeralInstance
- new()
GiteaEphemeralInstanceGitea

gitea-ephemeral-instance

Dagger Service in integration tests. It writes a deterministic config,
generates fresh secrets, seeds an admin user, and exposes the instance via
HTTP and a built-in SSH server.

Installation

dagger install gitea.com/gitea/daggerverse-gitea/gitea-ephemeral-instance@908b7793962b4f0336059c28e72f441c57062592

Entrypoint

Return Type

GiteaEphemeralInstance

Example

dagger -m gitea.com/gitea/daggerverse-gitea/gitea-ephemeral-instance@908b7793962b4f0336059c28e72f441c57062592 call \

func (m *MyModule) Example() *dagger.GiteaEphemeralInstance  {
	return dag.
			GiteaEphemeralInstance()
}

@function
def example() -> dagger.GiteaEphemeralInstance:
	return (
		dag.gitea_ephemeral_instance()
	)

@func()
example(): GiteaEphemeralInstance {
	return dag
		.giteaEphemeralInstance()
}

Types

GiteaEphemeralInstance 🔗

GiteaEphemeralInstance is the module entry point.

new() 🔗

New constructs a Gitea reference instance. The name scopes the session hostname; the optional tag overrides the default image tag.

Return Type

GiteaEphemeralInstanceGitea !

Arguments

Name	Type	Default Value	Description
name	String !	-	No description provided
tag	String	"docker.gitea.com/gitea:1-rootless"	No description provided

Example

dagger -m gitea.com/gitea/daggerverse-gitea/gitea-ephemeral-instance@908b7793962b4f0336059c28e72f441c57062592 call \
 new --name string

func (m *MyModule) Example(name string) *dagger.GiteaEphemeralInstanceGitea  {
	return dag.
			GiteaEphemeralInstance().
			New(name)
}

@function
def example(name: str) -> dagger.GiteaEphemeralInstanceGitea:
	return (
		dag.gitea_ephemeral_instance()
		.new(name)
	)

@func()
example(name: string): GiteaEphemeralInstanceGitea {
	return dag
		.giteaEphemeralInstance()
		.new(name)
}

GiteaEphemeralInstanceGitea 🔗

Gitea is a reference Gitea instance bootable in a Dagger pipeline.

tag() 🔗

Return Type

String !

Example

dagger -m gitea.com/gitea/daggerverse-gitea/gitea-ephemeral-instance@908b7793962b4f0336059c28e72f441c57062592 call \
 new --name string \
 tag

func (m *MyModule) Example(ctx context.Context, name string) string  {
	return dag.
			GiteaEphemeralInstance().
			New(name).
			Tag(ctx)
}

@function
async def example(name: str) -> str:
	return await (
		dag.gitea_ephemeral_instance()
		.new(name)
		.tag()
	)

@func()
async example(name: string): Promise<string> {
	return dag
		.giteaEphemeralInstance()
		.new(name)
		.tag()
}

adminPassword() 🔗

AdminPassword returns the admin password as a Dagger Secret.

Return Type

Secret !

Example

dagger -m gitea.com/gitea/daggerverse-gitea/gitea-ephemeral-instance@908b7793962b4f0336059c28e72f441c57062592 call \
 new --name string \
 admin-password

func (m *MyModule) Example(name string) *dagger.Secret  {
	return dag.
			GiteaEphemeralInstance().
			New(name).
			AdminPassword()
}

@function
def example(name: str) -> dagger.Secret:
	return (
		dag.gitea_ephemeral_instance()
		.new(name)
		.admin_password()
	)

@func()
example(name: string): Secret {
	return dag
		.giteaEphemeralInstance()
		.new(name)
		.adminPassword()
}

adminToken() 🔗

AdminToken returns the admin access token as a Dagger Secret.

Return Type

Secret !

Example

dagger -m gitea.com/gitea/daggerverse-gitea/gitea-ephemeral-instance@908b7793962b4f0336059c28e72f441c57062592 call \
 new --name string \
 admin-token

func (m *MyModule) Example(name string) *dagger.Secret  {
	return dag.
			GiteaEphemeralInstance().
			New(name).
			AdminToken()
}

@function
def example(name: str) -> dagger.Secret:
	return (
		dag.gitea_ephemeral_instance()
		.new(name)
		.admin_token()
	)

@func()
example(name: string): Secret {
	return dag
		.giteaEphemeralInstance()
		.new(name)
		.adminToken()
}

adminUsername() 🔗

AdminUsername returns the admin username.

Return Type

String !

Example

dagger -m gitea.com/gitea/daggerverse-gitea/gitea-ephemeral-instance@908b7793962b4f0336059c28e72f441c57062592 call \
 new --name string \
 admin-username

func (m *MyModule) Example(ctx context.Context, name string) string  {
	return dag.
			GiteaEphemeralInstance().
			New(name).
			AdminUsername(ctx)
}

@function
async def example(name: str) -> str:
	return await (
		dag.gitea_ephemeral_instance()
		.new(name)
		.admin_username()
	)

@func()
async example(name: string): Promise<string> {
	return dag
		.giteaEphemeralInstance()
		.new(name)
		.adminUsername()
}

bindTo() 🔗

BindTo attaches this Gitea service to a container under Hostname(), making InternalHttpURL and InternalSshURL reachable from that container.

Return Type

Container !

Arguments

Name	Type	Default Value	Description
ctr	Container !	-	No description provided

Example

dagger -m gitea.com/gitea/daggerverse-gitea/gitea-ephemeral-instance@908b7793962b4f0336059c28e72f441c57062592 call \
 new --name string \
 bind-to --ctr IMAGE:TAG

func (m *MyModule) Example(name string, ctr *dagger.Container) *dagger.Container  {
	return dag.
			GiteaEphemeralInstance().
			New(name).
			BindTo(ctr)
}

@function
def example(name: str, ctr: dagger.Container) -> dagger.Container:
	return (
		dag.gitea_ephemeral_instance()
		.new(name)
		.bind_to(ctr)
	)

@func()
example(name: string, ctr: Container): Container {
	return dag
		.giteaEphemeralInstance()
		.new(name)
		.bindTo(ctr)
}

container() 🔗

Container returns the configured, admin-seeded Gitea container (not started).

Return Type

Container !

Example

dagger -m gitea.com/gitea/daggerverse-gitea/gitea-ephemeral-instance@908b7793962b4f0336059c28e72f441c57062592 call \
 new --name string \
 container

func (m *MyModule) Example(name string) *dagger.Container  {
	return dag.
			GiteaEphemeralInstance().
			New(name).
			Container()
}

@function
def example(name: str) -> dagger.Container:
	return (
		dag.gitea_ephemeral_instance()
		.new(name)
		.container()
	)

@func()
example(name: string): Container {
	return dag
		.giteaEphemeralInstance()
		.new(name)
		.container()
}

hostname() 🔗

Hostname returns the Dagger-session hostname for this instance.

Return Type

String !

Example

dagger -m gitea.com/gitea/daggerverse-gitea/gitea-ephemeral-instance@908b7793962b4f0336059c28e72f441c57062592 call \
 new --name string \
 hostname

func (m *MyModule) Example(ctx context.Context, name string) string  {
	return dag.
			GiteaEphemeralInstance().
			New(name).
			Hostname(ctx)
}

@function
async def example(name: str) -> str:
	return await (
		dag.gitea_ephemeral_instance()
		.new(name)
		.hostname()
	)

@func()
async example(name: string): Promise<string> {
	return dag
		.giteaEphemeralInstance()
		.new(name)
		.hostname()
}

httpPort() 🔗

HttpPort returns the HTTP server port (3000).

Return Type

Integer !

Example

dagger -m gitea.com/gitea/daggerverse-gitea/gitea-ephemeral-instance@908b7793962b4f0336059c28e72f441c57062592 call \
 new --name string \
 http-port

func (m *MyModule) Example(ctx context.Context, name string) int  {
	return dag.
			GiteaEphemeralInstance().
			New(name).
			HttpPort(ctx)
}

@function
async def example(name: str) -> int:
	return await (
		dag.gitea_ephemeral_instance()
		.new(name)
		.http_port()
	)

@func()
async example(name: string): Promise<number> {
	return dag
		.giteaEphemeralInstance()
		.new(name)
		.httpPort()
}

internalHttpUrl() 🔗

InternalHttpURL returns the in-session HTTP base URL. It is reachable only from Dagger clients that start or bind this instance’s Service.

Return Type

String !

Example

dagger -m gitea.com/gitea/daggerverse-gitea/gitea-ephemeral-instance@908b7793962b4f0336059c28e72f441c57062592 call \
 new --name string \
 internal-http-url

func (m *MyModule) Example(ctx context.Context, name string) string  {
	return dag.
			GiteaEphemeralInstance().
			New(name).
			InternalHttpUrl(ctx)
}

@function
async def example(name: str) -> str:
	return await (
		dag.gitea_ephemeral_instance()
		.new(name)
		.internal_http_url()
	)

@func()
async example(name: string): Promise<string> {
	return dag
		.giteaEphemeralInstance()
		.new(name)
		.internalHttpUrl()
}

internalSshUrl() 🔗

InternalSshURL returns the in-session SSH URL. It is reachable only from Dagger clients that start or bind this instance’s Service.

Return Type

String !

Example

dagger -m gitea.com/gitea/daggerverse-gitea/gitea-ephemeral-instance@908b7793962b4f0336059c28e72f441c57062592 call \
 new --name string \
 internal-ssh-url

func (m *MyModule) Example(ctx context.Context, name string) string  {
	return dag.
			GiteaEphemeralInstance().
			New(name).
			InternalSshUrl(ctx)
}

@function
async def example(name: str) -> str:
	return await (
		dag.gitea_ephemeral_instance()
		.new(name)
		.internal_ssh_url()
	)

@func()
async example(name: string): Promise<string> {
	return dag
		.giteaEphemeralInstance()
		.new(name)
		.internalSshUrl()
}

service() 🔗

Service returns the running Gitea instance as a Dagger Service with a stable session hostname. Bind the service into client containers with BindTo before using InternalHttpURL or InternalSshURL from those containers.

Return Type

Service !

Example

dagger -m gitea.com/gitea/daggerverse-gitea/gitea-ephemeral-instance@908b7793962b4f0336059c28e72f441c57062592 call \
 new --name string \
 service

func (m *MyModule) Example(name string) *dagger.Service  {
	return dag.
			GiteaEphemeralInstance().
			New(name).
			Service()
}

@function
def example(name: str) -> dagger.Service:
	return (
		dag.gitea_ephemeral_instance()
		.new(name)
		.service()
	)

@func()
example(name: string): Service {
	return dag
		.giteaEphemeralInstance()
		.new(name)
		.service()
}

sshPort() 🔗

SshPort returns the built-in SSH server port (2222).

Return Type

Integer !

Example

dagger -m gitea.com/gitea/daggerverse-gitea/gitea-ephemeral-instance@908b7793962b4f0336059c28e72f441c57062592 call \
 new --name string \
 ssh-port

func (m *MyModule) Example(ctx context.Context, name string) int  {
	return dag.
			GiteaEphemeralInstance().
			New(name).
			SshPort(ctx)
}

@function
async def example(name: str) -> int:
	return await (
		dag.gitea_ephemeral_instance()
		.new(name)
		.ssh_port()
	)

@func()
async example(name: string): Promise<number> {
	return dag
		.giteaEphemeralInstance()
		.new(name)
		.sshPort()
}