Buildctl¶

buildctl [global options] command [command options] [arguments...]

ARG BUILDKIT_VER=v0.17.5
RUN url="https://github.com/moby/buildkit/releases/download/" \
    "${url}${BUILDKIT_VERSION}/buildkit-${BUILDKIT_VER}.linux-amd64.tar.gz" && \
    curl -sL $url -o buildkit.tar.gz && \
    tar xvf buildkit.tar.gz && \
    mv bin/buildctl /usr/local/bin/ && \
    rm -rf buildkit.tar.gz bin

docker build \
    . -f ./docker/linux/my-app.docker \
    --build-arg NAME=my-app \
    --no-cache --force-rm \
    -t docker.example.com/uat/my-app:0.1.0

buildctl build \
    --frontend dockerfile.v0 \
    --local context=. \
    --local dockerfile=./docker/linux/ \ # can only be a directory
    --opt filename=my-app.docker \       # the dockerfile name
    --opt build-arg:NAME=my-app \  
    --opt no-cache=true   
    --output type=image,name=docker.example.com/uat/my-app:0.1.0

--addr tcp://buildkitd:1234

# install wget
sudo apt update && sudo apt install wget

# install buildkit release
wget https://github.com/moby/buildkit/releases/download/v0.15.2/buildkit-v0.15.2.linux-amd64.tar.gz
tar xvf buildkit-v0.15.2.linux-amd64.tar.gz

# download a dockerfile
cd bin
wget --no-check-certificate https://raw.githubusercontent.com/courselabs/kubernetes/main/labs/docker/simple/Dockerfile
mkdir linux
mv ./Dockerfile ./linux/my-app.docker
cat ./linux/my-app.docker

# build the image
./buildctl --addr tcp://buildkitd:1234 build --frontend=dockerfile.v0 --local context=. --local dockerfile=./linux/ --opt filename=my-app.docker --output type=image,name=docker.example.com/dev/test,push=true

buildctl build \
    --frontend dockerfile.v0 \
    --local context=. \
    --local dockerfile=./docker/linux/ \ # can only be a directory
    --opt filename=my-app.docker \       # the dockerfile name
    --opt target=foo \
    --opt build-arg:name=my-app \

# to local folder
--output type=local,dest=path/to/output-dir
# to registry
--output type=image,name=docker.io/username/image,push=true

buildctl build \
  --frontend dockerfile.v0 \
  --local context=. \
  --local dockerfile=. \
  --output type=image,\"name=test/repo:tag1,test/repo:tag2\",push=true

# export cache to local directory
--export-cache type=local
# use azure blob storage
--import-cache type=azblob,account_url=https://myaccount.blob.core.windows.net,name=my_image \  
--export-cache type=azblob,account_url=https://myaccount.blob.core.windows.net,name=my_image \

--metadata-file metadata.json

{
  "containerimage.config.digest": "sha256:bf6010de5e36c4a6d2cefd562e65d25b8713c36575",
  "containerimage.descriptor": {
    "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
    "digest": "sha256:09423f01912c6cacd4363ac24bfd90760ce52606e8c71cf4f",
    "size": 891,
    "platform": {
      "architecture": "amd64",
      "os": "linux"
    }
  },
  "containerimage.digest": "sha256:09423f01912c6cacd4363ac24bfd90760ce52606e8c71cf4f",
  "image.name": "docker.example.com/dev/test"
}

BUILDKIT_HOST=tcp://<buildkitd-service-name>:<port>

error: listing workers for Build: failed to list workers: Unavailable: connection error:
desc = "transport: Error while dialing: dial tcp: lookup buildkitd on 10.255.0.9:53: server misbehaving"