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: descriptor.md
+4-1Lines changed: 4 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -155,13 +155,16 @@ Note that `[A-F]` MUST NOT be used here.
155
155
156
156
In many contexts, such as when downloading content over a network, resolving a descriptor to its content has a measurable fixed "roundtrip" latency cost.
157
157
For large blobs, the fixed cost is usually inconsequental, as the majority of time will be spent actually fetching the content.
158
-
For very small blobs, the fixed cost will be quite significant.
158
+
For very small blobs, the fixed cost can be quite significant.
159
159
160
160
Implementations MAY choose to embed small pieces of content directly within a descriptor to avoid roundtrips.
161
161
162
162
Implementations SHOULD NOT populate the `data` field in situations where doing so would unexpectedly modify content identifiers.
163
163
For example, a registry SHOULD NOT arbitrarily populate `data` fields within uploaded manifests, as that would modify the content address of those manifests.
164
164
165
+
Implementations SHOULD consider limitations of storage systems when deciding whether or not to embed data.
166
+
Many implementations will refuse to accept or parse manifests that violate the limitations of their storage systems, so descriptors concerned with portability SHOULD avoid embedding large amounts of data.
167
+
165
168
## Examples
166
169
167
170
The following example describes a [_Manifest_](manifest.md#image-manifest) with a content identifier of "sha256:5b0bcabd1ed22e9fb1310cf6c2dec7cdef19f0ad69efa1f392e94a4333501270" and a size of 7682 bytes:
0 commit comments