Docker

Remote build/cache using DOCKER_HOST

1. Create a new workspace with Docker installed (How-to).
2. Make sure you are connected to the DevZero network:

dz net connect

3. Set DOCKER_HOST environment variable on your machine to match the DevBox hostname:

export DOCKER_HOST=ssh://devzero@your-devbox-hostname

4. Verify the installation by running:

docker info

When you run the docker build command, the build context will be sent to the DevBox and the build process will run.

Remote build using BuildKit

1. Create a new workspace with Docker installed (How-to).
2. Inside your DevBox, run the BuildKit container:

docker run -d --rm --name=remote-buildkitd --privileged -p 1234:1234 moby/buildkit:latest --addr tcp://0.0.0.0:1234

See Remote driver docs for all available options.

3. On your machine, create a new buildx instance:

docker buildx create --name remote-container --driver remote tcp://your-devbox-hostname:1234

4. Build an image using remote driver (and download it locally):

docker buildx build --builder=remote-container -t test --load .

Remote cache using Docker Registry

1. Create a new workspace with Docker installed (How-to).
2. Inside your DevBox, install the Docker Registry:

docker run -d -p 5000:5000 --name registry registry:2

See CNCF Distribution guide for available options.

3. Make sure your machine is connected to the DevZero network:

dz net connect

4. Verify you can access the registry from your machine:

curl http://your-devbox-hostname:5000/v2/_catalog

5. Build and push your image to the registry

With Docker:

docker build --push -t your-devbox-hostname:5000/<image> .

With BuildKit remote cache (see previous section):

docker buildx build --push -t your-devbox-hostname:5000/<image> \
  --cache-to type=registry,ref=your-devbox-hostname:5000/<cache-image> \
  --cache-from type=registry,ref=your-devbox-hostname:5000/<cache-image>

6. Verify the image is available in the registry:\

curl http://your-devbox-hostname:5000/v2/_catalog

insecure-registries": ["your-devbox-hostname:5000"]