Troubleshooting etcdserver: request is too large error during OpenShift Image Build

Recently during image build process for one of the project, we encountered etcdserver: request is too large error.

In this post, we’ll see how we can troubleshoot and fix this issue.

Issue: Image build is failing with message similar to this

Pushing image docker-registry.default.svc:5000/project-build/project:12_30 …
Pushed 4/7 layers, 57% complete
Pushed 5/7 layers, 73% complete
Pushed 6/7 layers, 87% complete
Pushed 7/7 layers, 100% complete

error: build error: Failed to push image: received unexpected HTTP status: 500 Internal Server Error

Diagnostic: When we checked docker registry pod, we saw logs like this:

time="2020-10-09T07:44:32.146824866Z" level=error msg="error creating ImageStreamMapping: etcdserver: request is too large" go.version=go1.7.6 http.request.contenttype="application/vnd.docker.distribution.manifest.v1+prettyjws" http.request.host="docker-registry.default.svc:5000" http.request.id=36d8d304-348b-46dc-ab4d-1d90f3f41763 http.request.method=PUT http.request.remoteaddr="10.128.4.1:50714" http.request.uri="/v2/project-build/project/manifests/12_30" http.request.useragent="docker/1.12.6 go/go1.8.3 kernel/3.10.0-1127.el7.x86_64 os/linux arch/amd64 UpstreamClient(go-dockerclient)" instance.id=1ef9cf03-fa71-4025-8154-232c541cd66e…