kubernetes / component-base

Shared code for kubernetes core components

Kubernetes (K8s)

---

Kubernetes, also known as K8s, is an open source system for managing containerized applications across multiple hosts. It provides basic mechanisms for the 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.

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.

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 the 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.

component-base's Issues

Upgrade go.opentelemetry.io dependencies

The go.opentelemetry.io dependencies are still on some older versions.

The sig-storage upgraded these libs in our csi-lib-utils(kubernetes-csi/csi-lib-utils#140) but the versions are not compatible with what is in the component-base under certain dependency chain.

This causes upgrading dependencies in the csi sidecars failed. For example, the external-provisioner is depending on both csi-lib-utils and component base, in this scenario there is conflict in upgrading.

Similar issue in other repos: open-telemetry/opentelemetry-go#2938
Can component-base update the libs to newer versions?

Upgrade github.com/moby/term to v0.5.0

Upgrade github.com/moby/term to a tagged release: v0.5.0.

$ go get github.com/moby/[email protected] && go mod tidy

Migrate `component-base` to use Lease API

Support for endpoints and configmaps is removed in K8s 1.24 with kubernetes/kubernetes#106852.
More details about the motivation to switch to leases - ref kubernetes/kubernetes#80289.

To preserve the backwards-compatibility, resource lock for migration purposes (endpointsleases, configmapsleases) should be used when switching from the legacy resource locks (endpoints, configmaps)

component-base is currently using endpoints . We want to migrate this to endpointsleases and finally to leases.

Information About Issues

From @stealthybox
component-base is an automated staging repository from k/k, so most of the issues end up on kubernetes/kubernetes or their associated component's repo's.
See:

• Project Board
• k/k Issues/PR's needing Review
  The wg label has also been used in other orgs and repos such as kubernetes-sigs/kubebuilder.
  For repos outside of the kubernetes org, I've just been adding links to the respective issues on the Project Board.

build error : cannot use nil as type logr.Logger

when I use this module in my project, go build give me this error:
go version: go 1.17

pkg/mod/k8s.io/[email protected]/logs/config.go:41:22: cannot use nil as type logr.Logger
 in argument to LogRegistry.Register
pkg/mod/k8s.io/[email protected]/logs/registry.go:56:3: cannot use nil as type logr.Logger
 in return argument

Missing kube-api can be configured in the command line

traces utils.go

The most fundamental is that TracingConfiguration does not yet provide a complete configuration

func NewProvider(ctx context.Context, baseSampler sdktrace.Sampler, resourceOpts []resource.Option, opts ...otlpgrpc.Option) trace.TracerProvider {
 opts = append(opts, otlpgrpc.WithInsecure())

 driver := otlpgrpc.NewDriver(opts...)
 exporter, err := otlp.NewExporter(ctx, driver)
 if err != nil {
  klog.Fatalf("Failed to create OTLP exporter: %v", err)
 }

 res, err := resource.New(ctx, resourceOpts...)
 if err != nil {
  klog.Fatalf("Failed to create resource: %v", err)
 }

 // TODO Missing customization
 bsp := sdktrace.NewBatchSpanProcessor(exporter)

 return sdktrace.NewTracerProvider(
  // TODO Missing customization
  sdktrace.WithSampler(sdktrace.ParentBased(baseSampler)),
  sdktrace.WithSpanProcessor(bsp),
  sdktrace.WithResource(res),
 )
}

Upgrade opentelemetry to new version

There's breaking changes in opentelemetry new version, see https://github.com/open-telemetry/opentelemetry-go/blob/main/CHANGELOG.md

That is to say a project does not work if it depend on this repo and there's also direct/indirect dependencies on the new version of opentelemetry