llbutil

func FilterLocalFiles ¶

func FilterLocalFiles(localPath string, includePatterns, excludePatterns []string) (localPaths []string, err error)

func FirstUpInterface ¶

func FirstUpInterface() (string, error)

FirstUpInterface returns the mac address for the first "UP" network interface.

func LocalID ¶

func LocalID(ctx context.Context, absPath string, opts ...llb.LocalOption) (string, error)

LocalID returns a consistent hash for this local (path + options) so that the same content doesn't get transported multiple times when referenced repeatedly.

func LocalUniqueID ¶

func LocalUniqueID(cwd string) (string, error)

LocalUniqueID returns a consistent string that is unique per host + cwd

func NewSession ¶

func NewSession(ctx context.Context, opts ...SessionOption) (*session.Session, error)

func OutputFromWriter ¶

func OutputFromWriter(w io.WriteCloser) func(map[string]string) (io.WriteCloser, error)

func PositionFromLexer ¶

func PositionFromLexer(pos lexer.Position) pb.Position

func SSHID ¶

func SSHID(paths ...string) string

func SecretID ¶

func SecretID(path string) string

func ShimReadonlyMountpoints ¶

func ShimReadonlyMountpoints(opts []llb.RunOption) error

ShimReadonlyMountpoints will modify the source for readonly mounts so subsequent mounts that mount onto the readonly-mounts will have the mountpoint present.

For example if we have this code:

```hlb

run "make" with option {
	dir "/src"
	mount fs {
		local "."
	} "/src" with readonly
		mount scratch "/src/output" as buildOutput
		# ^^^^^ FAIL cannot create `output` directory for mount on readonly fs
		secret "./secret/foo.pem" "/src/secret/foo.pem"
		# ^^^^^ FAIL cannot create `./secret/foo.pm` for secret on readonly fs
	}
}

```

When containerd tries to mount /src/output on top of the /src mountpoint it will fail because /src is mounted as readonly. The work around for this is to inline create the mountpoints so that they pre-exist and containerd will not have to create them.

It can be done with HLB like:

```hlb

run "make" with option {
	dir "/src"
	mount fs {
		local "."
		mkdir "output" 0o755 # <-- this is added to ensure mountpoint exists
		mkdir "secret" 0o755            # <-- added so the secret can be mounted
		mkfile "secret/foo.pm" 0o644 "" # <-- added so the secret can be mounted
	} "/src" with readonly
		mount scratch "/src/output" as buildOutput
	}
}

```

So this function is effectively automatically adding the `mkdir` and `mkfile` instructions when it detects that a mountpoint is required to be on a readonly fs.

func WithDir ¶

func WithDir(dir string) llb.RunOption

func WithEnv ¶

func WithEnv(name, value string) llb.RunOption

func WithExtraHost ¶

func WithExtraHost(host string, ip net.IP) llb.RunOption

func WithNetwork ¶

func WithNetwork(netMode pb.NetMode) llb.RunOption

func WithReadonlyRootFS ¶

func WithReadonlyRootFS() llb.RunOption

func WithSSHSocket ¶

func WithSSHSocket(target string, opts ...llb.SSHOption) llb.RunOption

func WithSecret ¶

func WithSecret(dest string, opts ...llb.SecretOption) llb.RunOption

func WithSecurity ¶

func WithSecurity(securityMode pb.SecurityMode) llb.RunOption

func WithUser ¶

func WithUser(user string) llb.RunOption