Skip to content

Commit a057a9b

Browse files
authored
Merge pull request #28978 from stefan8/docs/clarify-partial-pulling
docs: clarify partial vs lazy pulling of images
2 parents 835c8f2 + 1abe0a8 commit a057a9b

1 file changed

Lines changed: 5 additions & 3 deletions

File tree

docs/tutorials/performance.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -180,21 +180,23 @@ $ podman info -f '{{.Host.RootlessNetworkCmd}}'
180180
pasta
181181
```
182182

183-
### Lazy pulling of container images
183+
### Partial pulling of container images
184184

185-
Podman supports lazy pulling for the following container image formats:
185+
Podman supports partial pulling for the following container image formats:
186186

187187
* __zstd:chunked__
188188

189189
* __eStargz__
190190

191191
__zstd:chunked__ has better performance than __eStargz__.
192192

193+
Partial pulling downloads only the layer contents that are missing locally, but the image is still fully pulled before its containers run. Lazy pulling, where the image is mounted before it is fully downloaded, is out of scope for Podman itself and requires an additional snapshotter such as the [stargz-snapshotter](https://github.com/containerd/stargz-snapshotter) configured as an additional layer store.
194+
193195
See the article [_Pull container images faster with partial pulls_](https://www.redhat.com/sysadmin/faster-container-image-pulls) by Giuseppe Scrivano and Dan Walsh.
194196

195197
### Choosing a host file system
196198

197-
Lazy pulling of container images can run more efficiently when the file system has reflink support. The file systems XFS and BTRFS have reflink support.
199+
Partial pulling of container images can run more efficiently when the file system has reflink support. The file systems XFS and BTRFS have reflink support.
198200

199201
### Option --log-driver
200202

0 commit comments

Comments
 (0)