This project is the repo for registry.k8s.io, the production OCI registry service for Kubernetes' container image artifacts
Go to file
Caleb Woodbine 079c728c92
Remove BobyMCbobs from reviewers
2023-02-18 09:26:10 +13:00
cmd Merge pull request #151 from BenTheElder/geranos 2023-02-16 13:57:38 -08:00
hack Merge pull request #146 from upodroid/copy-sync-script-over 2023-02-15 14:44:59 -08:00
internal/integration drop unnecessary -short support 2022-04-21 00:02:12 -07:00
pkg refactor codegen and parse gcp data 2023-02-07 20:51:48 -08:00
.gitignore add makefile + boilerplate scripts 2022-01-26 22:41:25 -08:00
.go-version Bump Golang to 1.19.5 2023-01-18 20:23:43 +01:00
CONTRIBUTING.md Initial commit 2021-12-14 17:07:58 -05:00
LICENSE Initial commit 2021-12-14 17:07:58 -05:00
Makefile verify zz_generated_range_data.go is up to date 2022-04-20 16:35:42 -07:00
OWNERS Remove BobyMCbobs from reviewers 2023-02-18 09:26:10 +13:00
README.md clarify stability documentation, link to blogpost 2023-02-09 13:45:14 -08:00
SECURITY.md Initial commit 2021-12-14 17:07:58 -05:00
SECURITY_CONTACTS cleanup boilerplate files slightly 2022-01-27 16:51:32 -08:00
cloudbuild.yaml Add stage ids and wait for image build 2022-04-08 14:59:55 +12:00
code-of-conduct.md Initial commit 2021-12-14 17:07:58 -05:00
go.mod eliminate go.work and geranos module 2023-02-10 18:56:57 -08:00
go.sum eliminate go.work and geranos module 2023-02-10 18:56:57 -08:00

README.md

registry.k8s.io

This project implements the backend for registry.k8s.io, Kubernetes's container image registry.

For more details on the implementation see cmd/archeio

The community deployment configs are documented at in the k8s.io repo with the rest of the community infra deployments: https://github.com/kubernetes/k8s.io/tree/main/registry.k8s.io

For publishing to registry.k8s.io, refer to the docs at https://git.k8s.io/k8s.io/k8s.gcr.io#managing-kubernetes-container-registries

Stability

registry.k8s.io is GA and we ask that all users migrate from k8s.gcr.io as soon as possible.

However, unequivocally: DO NOT depend on the implementation details of this registry.

Other than registry.k8s.io serving an OCI compliant registry: API endpoints, IP addresses, and backing services used are subject to change at anytime as new resources become available or as otherwise necessary.

If you need to allow-list domains or IPs in your environment, we highly recommend mirroring images to a location you control instead.

The Kubernetes project is currently sending traffic to GCP and AWS thanks to their donations but we hope to redirect traffic to more sponsors and their respective API endpoints in the future to keep the project sustainable.

Please also note that there is No SLA as this is a free, volunteer managed service. We will however do our best to respond to issues and the system is designed to be reliable and low-maintenance.

See Also: https://kubernetes.io/blog/2022/11/28/registry-k8s-io-faster-cheaper-ga

Privacy

This project abides by the Linux Foundation privacy policy, as documented at https://registry.k8s.io/privacy

Background

Previously all of Kubernetes' image hosting has been out of gcr.io ("Google Container Registry").

We've incurred significant egress traffic costs from users on other cloud providers in particular in doing so, severely limiting our ability to use the infra budget for purposes other than hosting end-user downloads.

We're now moving to shift all traffic behind a community controlled domain, so we can quickly implement cost-cutting measures like serving the bulk of the traffic for AWS-users from AWS-local storage funded by Amazon, or potentially leveraging other providers in the future.

For additional context on why we did this and what we're changing about kubernetes images see https://github.com/kubernetes/k8s.io/wiki/New-Registry-url-for-Kubernetes-(registry.k8s.io)

Essentially, this repo implements the backend sources for the steps outlined there.

Community, discussion, contribution, and support

Learn how to engage with the Kubernetes community on the community page.

You can reach the maintainers of this project at:

Code of conduct

Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.