Skip to content

Commit 4103be7

Browse files
authored
tweak image pull flag config and docs (#2378)
Update the max concurrent value based on some testing. Add recommendations about EBS throughput to docs.
1 parent e89ffc6 commit 4103be7

File tree

2 files changed

+4
-3
lines changed

2 files changed

+4
-3
lines changed

nodeadm/doc/examples.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -96,14 +96,15 @@ spec:
9696

9797
When the `AggressiveImagePull` feature gate is enabled, `nodeadm` will configure the container runtime to pull and unpack container images in parallel.
9898

99-
This has the benefit of potentially decreasing image pull time, at the cost of increased CPU and memory usage during image pull.
99+
This has the benefit of potentially decreasing image pull time, at the cost of increased CPU, memory and EBS usage during image pull.
100100

101101
⚠️ **Note**: This flag will be ignored on instance sizes below a certain vCPU and memory threshold.
102102

103103
### To enable this feature:
104104
1. Ensure your instance type is a larger instance type. Currently we recommend a 2xlarge instance or larger, but that value may change.
105105
2. Make sure your workloads can tolerate the increased CPU and memory usage during image pull. This makes the most sense when you need to pull a very large container image early in a node's lifecycle, before other workloads are running.
106-
3. Enable the feature gate in your user data:
106+
3. Ensure you've configured additional EBS throughput for your instance root volume. We recommend at least 600MiB/s throughput. Below that value, you may see longer image pull times with this flag. Higher values up to 1000MiB/s and 16k IOPs may result in better performance.
107+
4. Enable the feature gate in your user data:
107108
```
108109
---
109110
apiVersion: node.eks.aws/v1alpha1

nodeadm/internal/containerd/snapshotter/soci-snapshotter.config.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ enable = true
1212
concurrent_download_chunk_size = "16mb"
1313
discard_unpacked_layers = true
1414
max_concurrent_downloads = -1
15-
max_concurrent_downloads_per_image = 32
15+
max_concurrent_downloads_per_image = 20
1616
max_concurrent_unpacks = -1
1717
max_concurrent_unpacks_per_image = 12
1818

0 commit comments

Comments
 (0)