CHANGELOG.md

TODO: This document was manually maintained so might be incomplete. The automation effort is tracked in kubernetes#234.

Changes in k8s.io/api and k8s.io/apimachinery are mentioned here because k8s.io/client-go depends on them.

v6.0.0

Breaking Changes:

• If you upgrade your client-go libs and use the AppsV1() or Apps() interface, please note that the default garbage collection behavior is changed.

  • kubernetes/kubernetes#55148

• Swagger 1.2 retriever DiscoveryClient.SwaggerSchema was removed from the discovery client

  • kubernetes/kubernetes#53441

• Informers got a NewFilteredSharedInformerFactory to e.g. filter by namespace

  • kubernetes/kubernetes#54660

• [k8s.io/api] The dynamic admission webhook is split into two kinds, mutating and validating. The kinds have changed completely and old code must be ported to admissionregistration.k8s.io/v1beta1 - MutatingWebhookConfiguration and ValidatingWebhookConfiguration

  • kubernetes/kubernetes#55282

• [k8s.io/api] Renamed core/v1.ScaleIOVolumeSource to ScaleIOPersistentVolumeSource

  • kubernetes/kubernetes#54013

• [k8s.io/api] Renamed core/v1.RBDVolumeSource to RBDPersistentVolumeSource

  • kubernetes/kubernetes#54302

• [k8s.io/api] Removed core/v1.CreatedByAnnotation

  • kubernetes/kubernetes#54445

• [k8s.io/api] Renamed core/v1.StorageMediumHugepages to StorageMediumHugePages

  • kubernetes/kubernetes#54748

• [k8s.io/api] core/v1.Taint.TimeAdded became a pointer

  • kubernetes/kubernetes#43016

• [k8s.io/api] core/v1.DefaultHardPodAffinitySymmetricWeight type changed from int to int32

  • kubernetes/kubernetes#53850

• [k8s.io/apimachinery] ObjectCopier interface was removed (requires switch to new generators with DeepCopy methods)

  • kubernetes/kubernetes#53525

New Features:

• Certificate manager was moved from kubelet to k8s.io/client-go/util/certificates

  • kubernetes/kubernetes#49654

• [k8s.io/api] Workloads api types are promoted to apps/v1 version

  • kubernetes/kubernetes#53679

• [k8s.io/api] Added storage.k8s.io/v1alpha1 API group

  • kubernetes/kubernetes#54463

• [k8s.io/api] Added support for conditions in StatefulSet status

  • kubernetes/kubernetes#55268

• [k8s.io/api] Added support for conditions in DaemonSet status

  • kubernetes/kubernetes#55272

• [k8s.io/apimachinery] Added polymorphic scale client in k8s.io/client-go/scale, which supports scaling of resources in arbitrary API groups

  • kubernetes/kubernetes#53743

• [k8s.io/apimachinery] meta.MetadataAccessor got API chunking support

  • kubernetes/kubernetes#53768

• [k8s.io/apimachinery] unstructured.Unstructured got getters and setters

  • kubernetes/kubernetes#51940

Bug fixes and Improvements:

• The body in glog output is not truncated with log level 10

  • kubernetes/kubernetes#54801

• [k8s.io/api] Unset creationTimestamp field is output as null if encoded from an unstructured object

  • kubernetes/kubernetes#53464

• [k8s.io/apimachinery] Redirect behavior is restored for proxy subresources

  • kubernetes/kubernetes#52933

• [k8s.io/apimachinery] Random string generation functions are optimized

  • kubernetes/kubernetes#53720

v5.0.1

Bug fix: picked up a security fix kubernetes/kubernetes#53443 for PodSecurityPolicy.

v5.0.0

New features:

• Added paging support

  • kubernetes/kubernetes#51876

• Added support for client-side spam filtering of events

  • kubernetes/kubernetes#47367

• Added support for http etag and caching

  • kubernetes/kubernetes#50404

• Added priority queue support to informer cache

  • kubernetes/kubernetes#49752

• Added openstack auth provider

  • kubernetes/kubernetes#39587

• Added metrics for checking reflector health

  • kubernetes/kubernetes#48224

• Client-go now includes the leaderelection package

  • kubernetes/kubernetes#39173

API changes:

• Promoted Autoscaling v2alpha1 to v2beta1

  • kubernetes/kubernetes#50708

• Promoted CronJobs to batch/v1beta1

  • kubernetes/kubernetes#41901

• Promoted rbac.authorization.k8s.io/v1beta1 to rbac.authorization.k8s.io/v1

  • kubernetes/kubernetes#49642

• Added a new API version apps/v1beta2

  • kubernetes/kubernetes#48746

• Added a new API version scheduling/v1alpha1

  • kubernetes/kubernetes#48377

Breaking changes:

• Moved pkg/api and pkg/apis to k8s.io/api. Other kubernetes repositories also import types from there, so they are composable with client-go.

• Removed helper functions in pkg/api and pkg/apis. They are planned to be exported in other repos. The issue is tracked here. During the transition, you'll have to copy the helper functions to your projects.

• The discovery client now fetches the protobuf encoded OpenAPI schema and returns openapi_v2.Document

  • kubernetes/kubernetes#46803

• Enforced explicit references to API group client interfaces in clientsets to avoid ambiguity.

  • kubernetes/kubernetes#49370

• The generic RESTClient type (k8s.io/client-go/rest) no longer exposes LabelSelectorParam or FieldSelectorParam methods - use VersionedParams with metav1.ListOptions instead. The UintParam method has been removed. The timeout parameter will no longer cause an error when using Param().

  • kubernetes/kubernetes#48991

v4.0.0

No significant changes since v4.0.0-beta.0.

v4.0.0-beta.0

New features:

• Added OpenAPISchema support in the discovery client

  • kubernetes/kubernetes#44531

• Added mutation cache filter: MutationCache is able to take the result of update operations and stores them in an LRU that can be used to provide a more current view of a requested object.

  • https://github.com/kubernetes/kubernetes/pull/45838

• Moved the remotecommand package (used by kubectl exec/attach) to client-go

  • kubernetes/kubernetes#41331

• Added support for following redirects to the SpdyRoundTripper

  • kubernetes/kubernetes#44451

• Added Azure Active Directory plugin

  • kubernetes/kubernetes#43987

Usability improvements:

• Added several new examples and reorganized client-go/examples

  • Related PRs

API changes:

• Added networking.k8s.io/v1 API

  • kubernetes/kubernetes#39164

• ControllerRevision type added for StatefulSet and DaemonSet history.

  • kubernetes/kubernetes#45867

• Added support for initializers

  • kubernetes/kubernetes#38058

• Added admissionregistration.k8s.io/v1alpha1 API

  • kubernetes/kubernetes#46294

Breaking changes:

• Moved client-go/util/clock to apimachinery/pkg/util/clock

  • https://github.com/kubernetes/kubernetes/pull/45933

• Some API helpers were removed.

• Dynamic client takes GetOptions as an input parameter

  • kubernetes/kubernetes#47251

Bug fixes:

• PortForwarder: don't log an error if net.Listen fails. kubernetes/kubernetes#44636

• oidc auth plugin not to override the Auth header if it's already exits. kubernetes/kubernetes#45529

• The --namespace flag is now honored for in-cluster clients that have an empty configuration. kubernetes/kubernetes#46299

• GCP auth plugin no longer overwrites existing Authorization headers. kubernetes/kubernetes#45575

v3.0.0

Bug fixes:

• Use OS-specific libs when computing client User-Agent in kubectl, etc. (kubernetes/kubernetes#44423)
• kubectl commands run inside a pod using a kubeconfig file now use the namespace specified in the kubeconfig file, instead of using the pod namespace. If no kubeconfig file is used, or the kubeconfig does not specify a namespace, the pod namespace is still used as a fallback. (kubernetes/kubernetes#44570)
• Restored the ability of kubectl running inside a pod to consume resource files specifying a different namespace than the one the pod is running in. (kubernetes/kubernetes#44862)

v3.0.0-beta.0

• Added dependency on k8s.io/apimachinery. The impacts include changing import path of API objects like ListOptions from k8s.io/client-go/pkg/api/v1 to k8s.io/apimachinery/pkg/apis/meta/v1.
• Added generated listers (listers/) and informers (informers/)
• Kubernetes API changes:
  • Added client support for:
    • authentication/v1
    • authorization/v1
    • autoscaling/v2alpha1
    • rbac/v1beta1
    • settings/v1alpha1
    • storage/v1
  • Changed client support for:
    • certificates from v1alpha1 to v1beta1
    • policy from v1alpha1 to v1beta1
  • Deleted client support for:
    • extensions/v1beta1#Job
• CHANGED: pass typed options to dynamic client (kubernetes/kubernetes#41887)

v2.0.0

• Included bug fixes in k8s.io/kuberentes release-1.5 branch, up to commit bde8578d9675129b7a2aa08f1b825ec6cc0f3420

v2.0.0-alpha.1

• Removed top-level version folder (e.g., 1.4 and 1.5), switching to maintaining separate versions in separate branches.
• Clientset supported multiple versions per API group
• Added ThirdPartyResources example
• Kubernetes API changes
  • Apps API group graduated to v1beta1
  • Policy API group graduated to v1beta1
  • Added support for batch/v2alpha1/cronjob
  • Renamed PetSet to StatefulSet

v1.5.0

• Included the auth plugin (kubernetes/kubernetes#33334)
• Added timeout field to RESTClient config (kubernetes/kubernetes#33958)