Registry server: plan for addressing message-size limits.

[timburks]

gRPC has a default message size limit of 4MB. This is easily raised, so for self-hosted instances, that is probably the easiest way to support specs and artifacts that are larger than 4MB. But when other constraints limits prevent this, we're currently unable to load specs that are larger than a certain size (when compressed).

Compression helps significantly - the OpenAPI spec for Kubernetes 1.26.3 is 4620955 bytes and gzips to 285726 bytes, approximately 1/16th its uncompressed size. Because of this, we support and recommend uploading and downloading specs with gzip encoding.

Is that enough? What is a reasonable upper limit on compressed spec size?

What other upload/download options might we support?

[timburks]

The Katamari Damacy of APIs