d2g

README

d2g

d2g is a go library for converting legacy Docker Worker tasks into native Generic Worker tasks.

This library is used internally by Generic Worker, in order to run tasks that were originally intended for Docker Worker. On detecting that a claimed task has a Docker Worker payload, Generic Worker will first convert it to its own native format before validating and executing the task.

For users wishing to convert Docker Worker tasks to Generic Worker tasks at source, please see the taskcluster d2g cli subcommand.

Documentation

Index

• func Convert(dwPayload *dockerworker.DockerWorkerPayload) (gwPayload *genericworker.GenericWorkerPayload, err error)
• func ConvertTaskDefinition(dwTaskDef json.RawMessage) (json.RawMessage, error)
• func Scopes(dwScopes []string, dwPayload *dockerworker.DockerWorkerPayload, ...) (gwScopes []string)
• type DockerImageArtifact
  • func (dia *DockerImageArtifact) FileMounts() ([]genericworker.FileMount, error)
  • func (dia *DockerImageArtifact) String() (string, error)
• type DockerImageName
  • func (din *DockerImageName) FileMounts() ([]genericworker.FileMount, error)
  • func (din *DockerImageName) String() (string, error)
• type Image
• type IndexedDockerImage
  • func (idi *IndexedDockerImage) FileMounts() ([]genericworker.FileMount, error)
  • func (idi *IndexedDockerImage) String() (string, error)
• type NamedDockerImage
  • func (ndi *NamedDockerImage) FileMounts() ([]genericworker.FileMount, error)
  • func (ndi *NamedDockerImage) String() (string, error)

Functions

func Convert

func Convert(dwPayload *dockerworker.DockerWorkerPayload) (gwPayload *genericworker.GenericWorkerPayload, err error)

Convert transforms a Docker Worker task payload into an equivalent Generic Worker Multiuser POSIX task payload. The resulting Generic Worker payload is a BASH script which uses Podman to contain the Docker Worker payload. Since scopes fall outside of the payload in a task definition, scopes need to be converted separately (see d2g.Scopes function).

func ConvertTaskDefinition

func ConvertTaskDefinition(dwTaskDef json.RawMessage) (json.RawMessage, error)

func Scopes

func Scopes(dwScopes []string, dwPayload *dockerworker.DockerWorkerPayload, taskQueueID string) (gwScopes []string)

Scopes takes a slice of Docker Worker task scopes and returns a slice of equivalent Generic Worker scopes. These scopes should be used together with a converted Docker Worker task payload (see d2g.Convert function) to run Docker Worker tasks under Generic Worker.

Types

type DockerImageArtifact

type DockerImageArtifact dockerworker.DockerImageArtifact

func (*DockerImageArtifact) FileMounts

func (dia *DockerImageArtifact) FileMounts() ([]genericworker.FileMount, error)

func (*DockerImageArtifact) String

func (dia *DockerImageArtifact) String() (string, error)

type DockerImageName

type DockerImageName string

func (*DockerImageName) FileMounts

func (din *DockerImageName) FileMounts() ([]genericworker.FileMount, error)

func (*DockerImageName) String

func (din *DockerImageName) String() (string, error)

type Image

type Image interface {
	FileMounts() ([]genericworker.FileMount, error)
	String() (string, error)
}

type IndexedDockerImage

type IndexedDockerImage dockerworker.IndexedDockerImage

func (*IndexedDockerImage) FileMounts

func (idi *IndexedDockerImage) FileMounts() ([]genericworker.FileMount, error)

func (*IndexedDockerImage) String

func (idi *IndexedDockerImage) String() (string, error)

type NamedDockerImage

type NamedDockerImage dockerworker.NamedDockerImage

func (*NamedDockerImage) FileMounts

func (ndi *NamedDockerImage) FileMounts() ([]genericworker.FileMount, error)

func (*NamedDockerImage) String

func (ndi *NamedDockerImage) String() (string, error)