Skip to content

Commit 217d058

Browse files
committed
Add instructions on using snapshotter with docker
Signed-off-by: Amal Thundiyil <[email protected]>
1 parent 1323623 commit 217d058

File tree

1 file changed

+44
-0
lines changed

1 file changed

+44
-0
lines changed

cpt-containers.rst

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -294,6 +294,50 @@ Pulling this 9GB (4.3GB compressed) image usually takes about two minutes, with
294294

295295
See also the `cvmfs documentation page in nerdctl. <https://github.com/containerd/nerdctl/blob/main/docs/cvmfs.md>`_.
296296

297+
Running with docker
298+
^^^^^^^^^^^^^^^^^^^
299+
300+
.. note::
301+
The containerd image store is an experimental feature of Docker Engine.
302+
303+
The snapshotter can be tested and used with docker (> 24.0).
304+
305+
1. Write the following configuration to `/etc/docker/daemon.json`
306+
307+
.. code-block:: json
308+
309+
{
310+
"storage-driver": "cvmfs-snapshotter",
311+
"features": {
312+
"containerd-snapshotter": true
313+
}
314+
}
315+
316+
317+
2. Restart the deamon
318+
319+
::
320+
321+
systemctl restart docker
322+
323+
3. Verify if you're using the containerd storage driver:
324+
325+
::
326+
327+
$ docker info -f '{{ .DriverStatus }}'
328+
[[driver-type io.containerd.snapshotter.v1]]
329+
$ docker info -f '{{ .Driver }}'
330+
cvmfs-snapshotter
331+
332+
4. Then run or pull images:
333+
334+
::
335+
336+
docker pull clelange/cms-higgs-4l-full:latest
337+
docker run -it --rm clelange/cms-higgs-4l-full:latest
338+
339+
Pulling this image should be done in few seconds with the snapshotter. See also the `containerd image store manual page in docker. <https://docs.docker.com/engine/storage/containerd/>`_.
340+
297341
Running with k3s
298342
^^^^^^^^^^^^^^^^
299343
To configure k3s, edit ``/var/lib/rancher/k3s/agent/etc/containerd/config.toml.tmpl`` with the following content:

0 commit comments

Comments
 (0)