lab

func DockerGateway ¶

func DockerGateway() string

DockerGateway returns the gateway IP reachable from running pik lab containers. It inspects pik-managed containers to find the actual network gateway instead of assuming the default bridge (172.17.0.1).

func IsRunning ¶

func IsRunning(ctx context.Context, name string) bool

IsRunning checks if a lab has running containers.

func Start ¶

func Start(ctx context.Context, name string, services []sdk.Service) error

Start creates and starts containers for the given lab services.

Each service gets a network alias matching its Name so services can reference each other by short name (like docker compose). Services with a healthcheck are waited on before starting the next service, giving dependencies time to become ready.

func Stop ¶

func Stop(ctx context.Context, name string) error

Stop tears down all containers and the network for a lab.

func Target ¶

func Target(ctx context.Context, name string) string

Target queries Docker for the actual mapped port of a running lab. Since labs use random host ports, we can't read from static config.

func WaitProbe ¶

func WaitProbe(ctx context.Context, timeout time.Duration, fn func() error) error

WaitProbe retries fn until it returns nil or timeout expires. Use with the module's Check() as fn to wait for the application layer to be fully ready (not just TCP).

func WaitReady ¶

func WaitReady(ctx context.Context, addr string, timeout time.Duration) error

WaitReady polls a TCP address until it accepts connections.