Harbor

docker_exec(container_id::String, exec_cmd::Vector{String}; detach::Bool=false) -> String

Runs docker exec on the specified container. Returns the command output as a string.

docker_images() -> Vector{Image}

Runs docker images and returns a vector of Image structs.

docker_inspect_container(container_id::String) -> Dict

Runs docker inspect <container_id> and returns the parsed JSON as a Dict.

docker_kill(container_id::String; signal::Union{String,Int}="SIGTERM") -> Bool

Runs docker kill --signal=<signal> <container_id>. Returns true if successful.

docker_logs(container_id::String; follow::Bool=false, tail::Union{String,Int}="all") -> String

Runs docker logs with optional follow and tail parameters, returning the log output.

docker_ps(; all::Bool=false) -> Vector{String}

Runs docker ps (or docker ps -a if all is true) and returns a vector of container IDs.

docker_pull(image_name::String; tag::String="latest") -> Image

Runs docker pull <image_name>:<tag>. On success, returns an Image struct.

docker_restart(container_id::String; timeout::Int=10) -> Bool

Runs docker restart --time=<timeout> <container_id>. Returns true if successful.

docker_rm(container_id::String; force::Bool=false) -> Bool

Runs docker rm [--force] <container_id>. Returns true if the container is removed.

docker_rm_image(image::Image; force::Bool=false) -> Bool

Runs docker rmi [--force] <image>. Returns true on success.

docker_run(image::Image; name=nothing, ports=Dict{Int,Int}(),
           volumes=Dict{String,String}(), environment=Dict{String,String}(),
           command=nothing, detach::Bool=false) -> String

Runs docker run with the provided options and returns the container ID.

docker_start(container_id::String) -> Bool

Runs docker start <container_id>. Returns true if successful.

docker_stop(container_id::String; timeout::Int=10) -> Bool

Runs docker stop --time=<timeout> <container_id>. Returns true if successful.

images() -> Vector{Image}

Retrieves a list of available images.

inspect(container::Container) -> Dict

logs(container::Container) -> String

Retrieves the logs for the specified container.

ps(; all::Bool=true) -> Vector{Container}

Lists containers. If all is true, lists all containers; otherwise, only running ones.

pull(image::String; tag::String="latest") -> Image

Pulls an image from a registry and returns an Image instance.

remove!(container::Container) -> Bool

Removes a container from the system. Returns true if successful.

remove(image::Image; force::Bool=false) -> Bool

Removes the specified image.

run!(image::Image; name=nothing, ports=Dict{Int,Int}(), volumes=Dict{String,String}(), environment=Dict{String,String}(), command=nothing, detach::Bool=false) -> Container

Starts a container from the provided Image with the specified options. Returns a Container instance reflecting the running state.

stop!(container::Container; timeout::Int=10) -> Container

Gracefully stops a running container. Returns the Container with a new status.

wait_for(container::Container)

Waits until the given strategy condition is met or the timeout expires. Throws an error if the wait condition isn't satisfied in time.

with_container(image::Image; kw...) do container # operations on container end

Runs a container with the specified image and keyword options. The container is automatically stopped and removed after the block completes (even if an error occurs).