Production-Grade Container Scheduling and Management
Go to file
Patrick Ohly f131cabfa0 test: use go-uber/goleak for strict leak checking
It provides more readable output and has additional APIs for using it inside a
unit test. goleak.IgnoreCurrent is needed to filter out the goroutine that gets
started when importing go.opencensus.io/stats/view.

In order to handle background goroutines that get created on demand and cannot
be stopped (like the one for LogzHealth), a helper function ensures that those
are running before calling goleak.IgnoreCurrent. Keeping those goroutines
running is not a problem and thus not worth the effort of adding new APIs to
stop them.

Other goroutines are genuine leaks for which no fix is available. Those get
suppressed via IgnoreTopFunction, which works as long as that function
is unique enough.

Example output for the leak fixed in https://github.com/kubernetes/kubernetes/pull/115423:

    E0202 09:30:51.641841   74789 etcd.go:205] "EtcdMain goroutine check" err=<
        found unexpected goroutines:
        [Goroutine 4889 in state chan receive, with k8s.io/apimachinery/pkg/watch.(*Broadcaster).loop on top of the stack:
        goroutine 4889 [chan receive]:
        k8s.io/apimachinery/pkg/watch.(*Broadcaster).loop(0xc0076183c0)
        	/nvme/gopath/src/k8s.io/kubernetes/vendor/k8s.io/apimachinery/pkg/watch/mux.go:268 +0x65
        created by k8s.io/apimachinery/pkg/watch.NewBroadcaster
        	/nvme/gopath/src/k8s.io/kubernetes/vendor/k8s.io/apimachinery/pkg/watch/mux.go:77 +0x116
    >
2023-02-14 12:11:37 +01:00
.github Make root approval non-recursive 2022-10-10 08:26:53 -04:00
api Merge pull request #115434 from ehashman/requests-limits-ratio-docs 2023-02-02 11:02:53 -08:00
build [go] Bump images, dependencies and versions to go 1.20 2023-02-03 22:55:24 +01:00
CHANGELOG Merge pull request #114694 from yanggangtony/fix-typo 2023-01-26 12:06:26 -08:00
cluster etcd: Update to version 3.5.7 2023-01-27 17:24:00 +01:00
cmd Merge pull request #115315 from enj/enj/i/kas_kubelet_conn_close 2023-02-07 07:01:14 -08:00
docs Make root approval non-recursive 2022-10-10 08:26:53 -04:00
hack Merge pull request #115692 from liggitt/go1.20 2023-02-10 18:11:30 -08:00
LICENSES test: use go-uber/goleak for strict leak checking 2023-02-14 12:11:37 +01:00
logo logo: better alignment of layers 2022-10-19 12:17:25 -07:00
pkg Merge pull request #115617 from cyclinder/cyclinder1 2023-02-10 07:39:30 -08:00
plugin Merge pull request #114817 from TommyStarK/plugin-pkg-admission/replace-deprecated-pointer-function 2023-01-04 14:30:44 -08:00
staging test: use go-uber/goleak for strict leak checking 2023-02-14 12:11:37 +01:00
test test: use go-uber/goleak for strict leak checking 2023-02-14 12:11:37 +01:00
third_party Add gimme 2023-02-01 16:34:23 -05:00
vendor test: use go-uber/goleak for strict leak checking 2023-02-14 12:11:37 +01:00
.generated_files remove clearly unnecessary lingering BUILD file references 2022-10-04 16:47:25 -07:00
.gitattributes gitattributes: json and yaml files LF line endings 2022-12-22 11:36:07 +00:00
.gitignore Add helper script to install protoc 2023-01-26 18:00:08 -05:00
.go-version [go] Bump images, dependencies and versions to go 1.20 2023-02-03 22:55:24 +01:00
.golangci.yaml kubeadm: fix gocritic lint errors 2023-01-08 11:23:26 +08:00
CHANGELOG.md Revert "Add link to to file" 2023-01-05 15:53:04 +08:00
code-of-conduct.md
CONTRIBUTING.md
go.mod test: use go-uber/goleak for strict leak checking 2023-02-14 12:11:37 +01:00
go.sum test: use go-uber/goleak for strict leak checking 2023-02-14 12:11:37 +01:00
LICENSE
Makefile
OWNERS Add sig-architecture-approvers and dep-approvers to root dir 2022-10-10 13:43:04 -04:00
OWNERS_ALIASES Add cici37 as API reviewer 2023-02-02 12:11:09 +00:00
README.md remove gopkg widget 2022-10-18 16:52:38 -07:00
SECURITY_CONTACTS
SUPPORT.md

Kubernetes (K8s)

CII Best Practices


Kubernetes, also known as K8s, is an open source system for managing containerized applications across multiple hosts. It provides basic mechanisms for deployment, maintenance, and scaling of applications.

Kubernetes builds upon a decade and a half of experience at Google running production workloads at scale using a system called Borg, combined with best-of-breed ideas and practices from the community.

Kubernetes is hosted by the Cloud Native Computing Foundation (CNCF). If your company wants to help shape the evolution of technologies that are container-packaged, dynamically scheduled, and microservices-oriented, consider joining the CNCF. For details about who's involved and how Kubernetes plays a role, read the CNCF announcement.


To start using K8s

See our documentation on kubernetes.io.

Try our interactive tutorial.

Take a free course on Scalable Microservices with Kubernetes.

To use Kubernetes code as a library in other applications, see the list of published components. Use of the k8s.io/kubernetes module or k8s.io/kubernetes/... packages as libraries is not supported.

To start developing K8s

The community repository hosts all information about building Kubernetes from source, how to contribute code and documentation, who to contact about what, etc.

If you want to build Kubernetes right away there are two options:

You have a working Go environment.
mkdir -p $GOPATH/src/k8s.io
cd $GOPATH/src/k8s.io
git clone https://github.com/kubernetes/kubernetes
cd kubernetes
make
You have a working Docker environment.
git clone https://github.com/kubernetes/kubernetes
cd kubernetes
make quick-release

For the full story, head over to the developer's documentation.

Support

If you need support, start with the troubleshooting guide, and work your way through the process that we've outlined.

That said, if you have questions, reach out to us one way or another.

Community Meetings

The Calendar has the list of all the meetings in Kubernetes community in a single location.

Adopters

The User Case Studies website has real-world use cases of organizations across industries that are deploying/migrating to Kubernetes.

Governance

Kubernetes project is governed by a framework of principles, values, policies and processes to help our community and constituents towards our shared goals.

The Kubernetes Community is the launching point for learning about how we organize ourselves.

The Kubernetes Steering community repo is used by the Kubernetes Steering Committee, which oversees governance of the Kubernetes project.

Roadmap

The Kubernetes Enhancements repo provides information about Kubernetes releases, as well as feature tracking and backlogs.