You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/stargz/stargz_guide.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,6 +5,8 @@ This guide describes how to run stargz images on a single-cluster node using Kna
5
5
## Creating stargz images
6
6
[eStargz](https://github.com/containerd/stargz-snapshotter/tree/cmd/v0.12.1) is a lazily-pullable image format developed to improve the performance of container boot-ups by making better usage of the layering structure of container images. The image format is compatible to [OCI](https://github.com/opencontainers/image-spec/)/[Docker](https://github.com/moby/moby/blob/master/image/spec/v1.2.md) images, therefore it allows pushing images to standard container registries.
7
7
8
+
Standard docker images store their layers as individual tars, one for each layer. This format does not allow to locate individual files without first unzipping the whole layer, which implies sending the tar layer first, and then unzipping it and finding the file. This inefficiency is resolved by the `stargz` format for layers, which instead takes each file and tars it on its own (with the exception of big files, which get split into chunks that get a tar on their own) and finally zips all the tars into a big tar, therefore ensuring it remains a valid tar. With the aid of an index file at the end of the list of files, one can use the stargz format to seek a specific file without going through all the files in the layer.
9
+
8
10
To build stargz images, we recommend following the [stargz snapshotter and stargz store guide](https://github.com/containerd/stargz-snapshotter/blob/cmd/v0.12.1/docs/INSTALL.md) and building images using the [ctr-remote](https://github.com/containerd/stargz-snapshotter/tree/cmd/v0.12.1#creating-estargz-images-using-ctr-remote) CLI tool. We recommend serving images through DockerHub.
0 commit comments