Verify your Docker Environment

There are a few commands you can run to verify things are set up correctly:

Verify Docker environment. If these don’t work, you cannot run docker commands in your build tools. You can attempt to run the docker commands outside the container using BUILD_WITH_CONTAINER=0.

docker run -v /var/run/docker.sock:/var/run/docker.sock -it --rm docker docker ps, or
docker run -v /var/run/docker.sock.raw:/var/run/docker.sock -it --rm docker docker ps

Some docker installs require the .raw. If the first fails and the second succeeds, you can export an environment variable:

DOCKER_SOCKET_MOUNT=-v /var/run/docker.sock.raw:/var/run/docker.sock

Some users say they require sudo and then you will need to use sudo for your make commands as well.

docker run -v /var/run/docker.sock:/var/run/docker.sock -it -u 501: --rm docker docker ps

This is a common failing point for non Docker Desktop users on a Mac. If you have a way to make these work on podman, rancher desktop, let us know so we can add to the wiki. Verify various make targets:

make clean build docker.proxyv2 gen lint

In https://github.com/istio/istio.io, be able to run a test locally.

kind create cluster --name istio-testing --config $ISTIO/istio/prow/config/default.yaml --image gcr.io/istio-testing/kind-node:v1.27.0
TEST_ENV=kind ADDITIONAL_CONTAINER_OPTIONS="--network host" make doc.test.profile_none TEST=ops/ambient/getting-started/test.sh