Dagger
Search

ssh

Run a command on a remote machine using SSH and return the result

Installation

dagger install github.com/samalba/dagger-modules/ssh@296cf44af17649e435dce578b80e2c875b560051

Entrypoint

Return Type 
Ssh !
Arguments
NameTypeDescription
destinationString !Destination to connect to (SSH destination)
identityFileSecret !Private key to connect
cacheBoolean Enable caching of commands
Example
func (m *myModule) example(destination string, identityFile *Secret) *Ssh  {
	return dag.
			Ssh(destination, identityFile)
}
@function
def example(destination: str, identity_file: dagger.Secret, ) -> dag.Ssh:
	return (
		dag.ssh(destination, identity_file)
	)
@func()
example(destination: string, identityFile: Secret, ): Ssh {
	return dag
		.ssh(destination, identityFile)
}

Types

Ssh

baseCtr()

Return Type 
Container !
Example
dagger -m github.com/samalba/dagger-modules/ssh@296cf44af17649e435dce578b80e2c875b560051 call \
 --destination string --identity-file env:MYSECRET base-ctr
func (m *myModule) example(destination string, identityFile *Secret) *Container  {
	return dag.
			Ssh(destination, identityFile).
			BaseCtr()
}
@function
def example(destination: str, identity_file: dagger.Secret, ) -> dagger.Container:
	return (
		dag.ssh(destination, identity_file)
		.base_ctr()
	)
@func()
example(destination: string, identityFile: Secret, ): Container {
	return dag
		.ssh(destination, identityFile)
		.baseCtr()
}

destination()

Return Type 
String !
Example
dagger -m github.com/samalba/dagger-modules/ssh@296cf44af17649e435dce578b80e2c875b560051 call \
 --destination string --identity-file env:MYSECRET destination
func (m *myModule) example(ctx context.Context, destination string, identityFile *Secret) string  {
	return dag.
			Ssh(destination, identityFile).
			Destination(ctx)
}
@function
async def example(destination: str, identity_file: dagger.Secret, ) -> str:
	return await (
		dag.ssh(destination, identity_file)
		.destination()
	)
@func()
async example(destination: string, identityFile: Secret, ): Promise<string> {
	return dag
		.ssh(destination, identityFile)
		.destination()
}

opts()

Return Type 
[Sshopts ! ] !
Example
Function Ssh.opts is not accessible from the ssh module
func (m *myModule) example(destination string, identityFile *Secret) []*SshSshopts  {
	return dag.
			Ssh(destination, identityFile).
			Opts()
}
@function
def example(destination: str, identity_file: dagger.Secret, ) -> List[dag.SshSshopts]:
	return (
		dag.ssh(destination, identity_file)
		.opts()
	)
@func()
example(destination: string, identityFile: Secret, ): SshSshopts[] {
	return dag
		.ssh(destination, identityFile)
		.opts()
}

cache()

Return Type 
Boolean !
Example
dagger -m github.com/samalba/dagger-modules/ssh@296cf44af17649e435dce578b80e2c875b560051 call \
 --destination string --identity-file env:MYSECRET cache
func (m *myModule) example(ctx context.Context, destination string, identityFile *Secret) bool  {
	return dag.
			Ssh(destination, identityFile).
			Cache(ctx)
}
@function
async def example(destination: str, identity_file: dagger.Secret, ) -> bool:
	return await (
		dag.ssh(destination, identity_file)
		.cache()
	)
@func()
async example(destination: string, identityFile: Secret, ): Promise<boolean> {
	return dag
		.ssh(destination, identityFile)
		.cache()
}

command()

example usage: “dagger call –destination USER@HOST –identity-file file:${HOME}/.ssh/id_ed25519 command –args whoami stdout”

Return Type 
Container !
Arguments
NameTypeDefault ValueDescription
args[String ! ] !-No description provided
Example
dagger -m github.com/samalba/dagger-modules/ssh@296cf44af17649e435dce578b80e2c875b560051 call \
 --destination string --identity-file env:MYSECRET command --args string1 --args string2
func (m *myModule) example(destination string, identityFile *Secret, args []string) *Container  {
	return dag.
			Ssh(destination, identityFile).
			Command(args)
}
@function
def example(destination: str, identity_file: dagger.Secret, args: List[str]) -> dagger.Container:
	return (
		dag.ssh(destination, identity_file)
		.command(args)
	)
@func()
example(destination: string, identityFile: Secret, args: string[]): Container {
	return dag
		.ssh(destination, identityFile)
		.command(args)
}

script()

execute a remote script. similar to `command’, but the script is piped to ssh (shell escaping safe)

Return Type 
Container !
Arguments
NameTypeDefault ValueDescription
contentString !-No description provided
Example
dagger -m github.com/samalba/dagger-modules/ssh@296cf44af17649e435dce578b80e2c875b560051 call \
 --destination string --identity-file env:MYSECRET script --content string
func (m *myModule) example(destination string, identityFile *Secret, content string) *Container  {
	return dag.
			Ssh(destination, identityFile).
			Script(content)
}
@function
def example(destination: str, identity_file: dagger.Secret, content: str) -> dagger.Container:
	return (
		dag.ssh(destination, identity_file)
		.script(content)
	)
@func()
example(destination: string, identityFile: Secret, content: string): Container {
	return dag
		.ssh(destination, identityFile)
		.script(content)
}

Sshopts

identityFile()

Return Type 
Secret !
Example
Function SshSshopts.identityFile is not accessible from the ssh module
Function SshSshopts.identityFile is not accessible from the ssh module
Function SshSshopts.identityFile is not accessible from the ssh module
Function SshSshopts.identityFile is not accessible from the ssh module

port()

Return Type 
Integer !
Example
Function SshSshopts.port is not accessible from the ssh module
Function SshSshopts.port is not accessible from the ssh module
Function SshSshopts.port is not accessible from the ssh module
Function SshSshopts.port is not accessible from the ssh module

login()

Return Type 
String !
Example
Function SshSshopts.login is not accessible from the ssh module
Function SshSshopts.login is not accessible from the ssh module
Function SshSshopts.login is not accessible from the ssh module
Function SshSshopts.login is not accessible from the ssh module