From 715b282e229475828095d14170ea29c6b64e3229 Mon Sep 17 00:00:00 2001 From: Cristian Greco Date: Tue, 9 May 2023 11:03:49 +0100 Subject: [PATCH] Supported container runtimes tidy up (#560) --- docs/supported-container-runtimes.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/supported-container-runtimes.md b/docs/supported-container-runtimes.md index 8ae4770fd..87ecf2654 100644 --- a/docs/supported-container-runtimes.md +++ b/docs/supported-container-runtimes.md @@ -6,6 +6,8 @@ Works out of the box. ## Podman +### Usage + MacOS: ```bash {% raw %} @@ -24,9 +26,7 @@ export DOCKER_HOST=unix://${XDG_RUNTIME_DIR}/podman/podman.sock The resource reaper is a process which runs in the background and cleans up containers and images after they are no longer needed. It is not possible to run the resource reaper on MacOS with Podman due to permission limitations, it fails with "Operation not supported" errors. -Workarounds: - -Disable the resource reaper: +One workaround is to disable the resource reaper: ```bash export TESTCONTAINERS_RYUK_DISABLED=true @@ -34,6 +34,8 @@ export TESTCONTAINERS_RYUK_DISABLED=true ## Colima +### Usage + ```bash export DOCKER_HOST=unix://${HOME}/.colima/default/docker.sock export TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE=/var/run/docker.sock @@ -45,7 +47,7 @@ export TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE=/var/run/docker.sock When exposing a container port, Docker may provide an IPv4 _and_ an IPv6 binding, where the port may be different. Node versions < 18 default to resolve a hostname to an IPv4 address, while Node 18+ would default to an IPv6 address. Because Colima does not support IPv6, resolving a hostname to an IPv6 address results in connection refused. -Workarounds: +There are 2 workarounds: 1. Disable IPv6 in your environment. 2. Run Node with flags such that it prefers IPv4: @@ -75,6 +77,8 @@ const container = await new GenericContainer("redis") ## Rancher Desktop +### Usage + ```bash export DOCKER_HOST=unix://${HOME}/.rd/docker.sock export TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE=/var/run/docker.sock