Skip to content

Latest commit

 

History

History
511 lines (397 loc) · 43.7 KB

CHANGELOG.md

File metadata and controls

511 lines (397 loc) · 43.7 KB
Raw

v17.0.0-snapshot

Kubernetes API Version: 1.17.13

Important Information:

  • The Kubernetes Python client versioning scheme has changed. The version numbers used till Kubernetes Python Client v12.y.z lagged behind the actual Kubernetes minor version numbers. From this release, the client is moving a version format vY.Z.P where Y and Z are respectively from the Kubernetes version v1.Y.Z and P would incremented due to changes on the Python client side itself. Ref: kubernetes-client#1244
  • Python 2 had reached End of Life on January 1, 2020. The Kubernetes Python Client will drop support for Python 2 from the next release (v18.0.0) and will no longer provide support to older clients as per the Kubernetes support policy.

API Change:

  • Fixed: log timestamps now include trailing zeros to maintain a fixed width (#91207, @iamchuckss) [SIG Apps and Node]
  • Resolve regression in metadata.managedFields handling in update/patch requests submitted by older API clients (#92008, @apelisse) [SIG API Machinery and Testing]
  • Fix bug where sending a status update completely wipes managedFields for some types. (#90032, @apelisse) [SIG API Machinery and Testing]
  • Fixes a regression with clients prior to 1.15 not being able to update podIP in pod status, or podCIDR in node spec, against >= 1.16 API servers (#88505, @liggitt) [SIG Apps and Network]
  • CustomResourceDefinitions now validate documented API semantics of x-kubernetes-list-type and x-kubernetes-map-type atomic to reject non-atomic sub-types. (#84722, @sttts)
  • Kube-apiserver: The AdmissionConfiguration type accepted by --admission-control-config-file has been promoted to apiserver.config.k8s.io/v1 with no schema changes. (#85098, @liggitt)
  • Fixed EndpointSlice port name validation to match Endpoint port name validation (allowing port names longer than 15 characters) (#84481, @robscott)
  • CustomResourceDefinitions introduce x-kubernetes-map-type annotation as a CRD API extension. Enables this particular validation for server-side apply. (#84113, @enxebre)

To read the full CHANGELOG visit here.

v12.0.1

Kubernetes API Version: 1.16.15

Breaking Change:

  • kubernetes.config.Configuration() will now return the default "initial" configuration, kubernetes.config.Configuration.get_default_copy() will return the default configuration if there is a default set via Configuration.set_default(c), otherwise, it will also return the default "initial" configuration. OpenAPITools/openapi-generator#4485, OpenAPITools/openapi-generator#5315. **Note: ** This change also affects v12.0.0a1, v12.0.0b1 and v12.0.0.

Bug Fix:

v12.0.0

Kubernetes API Version: 1.16.15

New Feature:

v12.0.0b1

Kubernetes API Version: 1.16.14

New Feature:

Bug Fix:

v12.0.0a1

Kubernetes API Version: 1.16.14

API Change:

  • Resolve regression in metadata.managedFields handling in update/patch requests submitted by older API clients (#91748, @apelisse) [SIG API Machinery and Testing]
  • Fix bug where sending a status update completely wipes managedFields for some types. (#90033, @apelisse) [SIG API Machinery and Testing]
  • The MutatingWebhookConfiguration and ValidatingWebhookConfiguration APIs have been promoted to admissionregistration.k8s.io/v1:
    • failurePolicy default changed from Ignore to Fail for v1
    • matchPolicy default changed from Exact to Equivalent for v1
    • timeout default changed from 30s to 10s for v1
    • sideEffects default value is removed, and the field made required, and only None and NoneOnDryRun are permitted for v1
    • admissionReviewVersions default value is removed and the field made required for v1 (supported versions for AdmissionReview are v1 and v1beta1)
    • The name field for specified webhooks must be unique for MutatingWebhookConfiguration and ValidatingWebhookConfiguration objects created via admissionregistration.k8s.io/v1
  • The AdmissionReview API sent to and received from admission webhooks has been promoted to admission.k8s.io/v1. Webhooks can specify a preference for receiving v1 AdmissionReview objects with admissionReviewVersions: ["v1","v1beta1"], and must respond with an API object in the same apiVersion they are sent. When webhooks use admission.k8s.io/v1, the following additional validation is performed on their responses:
    • response.patch and response.patchType are not permitted from validating admission webhooks
    • apiVersion: "admission.k8s.io/v1" is required
    • kind: "AdmissionReview" is required
    • response.uid: "<value of request.uid>" is required
    • response.patchType: "JSONPatch" is required (if response.patch is set) (#80231, @liggitt)
  • The CustomResourceDefinition API type is promoted to apiextensions.k8s.io/v1 with the following changes:
    • Use of the new default feature in validation schemas is limited to v1
    • spec.scope is no longer defaulted to Namespaced and must be explicitly specified
    • spec.version is removed in v1; use spec.versions instead
    • spec.validation is removed in v1; use spec.versions[*].schema instead
    • spec.subresources is removed in v1; use spec.versions[*].subresources instead
    • spec.additionalPrinterColumns is removed in v1; use spec.versions[*].additionalPrinterColumns instead
    • spec.conversion.webhookClientConfig is moved to spec.conversion.webhook.clientConfig in v1
    • spec.conversion.conversionReviewVersions is moved to spec.conversion.webhook.conversionReviewVersions in v1
    • spec.versions[*].schema.openAPIV3Schema is now required when creating v1 CustomResourceDefinitions
    • spec.preserveUnknownFields: true is disallowed when creating v1 CustomResourceDefinitions; it must be specified within schema definitions as x-kubernetes-preserve-unknown-fields: true
    • In additionalPrinterColumns items, the JSONPath field was renamed to jsonPath in v1 (fixes kubernetes/kubernetes#66531) The apiextensions.k8s.io/v1beta1 version of CustomResourceDefinition is deprecated and will no longer be served in v1.19. (#79604, @liggitt)
  • The ConversionReview API sent to and received from custom resource CustomResourceDefinition conversion webhooks has been promoted to apiextensions.k8s.io/v1. CustomResourceDefinition conversion webhooks can now indicate they support receiving and responding with ConversionReview API objects in the apiextensions.k8s.io/v1 version by including v1 in the conversionReviewVersions list in their CustomResourceDefinition. Conversion webhooks must respond with a ConversionReview object in the same apiVersion they receive. apiextensions.k8s.io/v1 ConversionReview responses must specify a response.uid that matches the request.uid of the object they were sent. (#81476, @liggitt)
  • Add scheduling support for RuntimeClasses. RuntimeClasses can now specify nodeSelector constraints & tolerations, which are merged into the PodSpec for pods using that RuntimeClass. (#80825, @tallclair)
  • Kubelet should now more reliably report the same primary node IP even if the set of node IPs reported by the CloudProvider changes. (#79391, @danwinship)
  • Omit nil or empty field when calculating container hash value to avoid hash changed. For a new field with a non-nil default value in the container spec, the hash would still get changed. (#57741, @dixudx)
  • Property conditions in apiextensions.v1beta1.CustomResourceDefinitionStatus and apiextensions.v1.CustomResourceDefinitionStatus is now optional instead of required. (#64996, @roycaihw)
  • When the status of a CustomResourceDefinition condition changes, its corresponding lastTransitionTime is now updated. (#69655, @CaoShuFeng)

New Feature:

Bug Fix:

OpenAPI Generator Changes:

OpenAPI Generator has been updated to v4.3.0 from v3.3.4. Following are links to Python client related changes throughout the OpenAPI releases above v3.3.4 to v4.3.0:

v11.0.0

Kubernetes API Version: 1.15.10

API Change:

New Feature:

Bug Fix:

Deprecation Notice v11.0.0 of the client follows the Kubernetes deprecation policy and will be deprecated as and when Kubernetes version v1.15 gets deprecated.

v11.0.0b2

Bug Fix:

v11.0.0b1

Bug Fix:

New Feature:

v11.0.0a1

New Feature:

Breaking Change:

  • The Python client will be generated by openapi-generator, with the following breaking changes kubernetes-client/gen#97
  • kubernetes.client.apis package is renamed to kubernetes.client.api
  • kubernetes package code now uses absolute import instead of relative import
  • The swagger_types attribute in all models is renamed to openapi_types
  • Python3.4 is no longer supported kubernetes-client/python#807

API Change:

  • Introduce ExtensionsV1beta1RuntimeClassStrategyOptions and PolicyV1beta1RuntimeClassStrategyOptions. Add RuntimeClass restrictions & defaulting to PodSecurityPolicy kubernetes/kubernetes#73795
  • Introduce V1WindowsSecurityContextOptions. Add Windows specific options in Pod Security Context and Container Security Context kubernetes/kubernetes#77147
  • Split V1beta1Webhook into V1beta1MutatingWebhook and V1beta1ValidatingWebhook kubernetes/kubernetes#78491
  • Introduce parameter allow_watch_bookmarks in list options for requesting watch bookmarks from apiserver. The implementation in apiserver is hidden behind feature gate WatchBookmark (currently in Alpha stage) kubernetes/kubernetes#74074
  • Add V1DeleteOptions parameters (dry_run, grace_period_seconds, orphan_dependents, propagation_policy) to delete collection APIs kubernetes/kubernetes#77843
  • Add ListMeta.RemainingItemCount. When responding a LIST request, if the server has more data available, and if the request does not contain label selectors or field selectors, the server sets the ListOptions.RemainingItemCount to the number of remaining objects kubernetes/kubernetes#75993
  • Add controller_expand_secret_ref in V1SecretReference to store CSI volume expansion secrets kubernetes/kubernetes#77516
  • Introduce preemption_policy field to V1PriorityClass kubernetes/kubernetes#74614
  • Add port configuration to service reference in Admission webhook configuration, AuditSink webhook configuration, CRD Conversion webhook configuration and kube-aggregator kubernetes/kubernetes#74855
  • Introduce inline_volume_spec to V1PersistentVolumeSpec kubernetes/kubernetes#77703
  • Add fields x_kubernetes_embedded_resource, x_kubernetes_int_or_string, x_kubernetes_preserve_unknown_fields to V1beta1JSONSchemaProps kubernetes/kubernetes#77207

Bug Fix:

v10.1.0

Bug Fix:

  • Fixed issue in __del__ method of the ApiClient that caused an indefinite hang during garbage collection. Note The ApiClient ThreadPool will no longer be cleaned up automatically during garbage collection, instead the close method must be invoked directly, or the ApiClient can be used as a context manager. kubernetes-client/python#1073

v10.0.1

Bug Fix:

Security Fix:

v10.0.0

Bug Fix:

New Feature:

v10.0.0a1

Bug Fix:

New Feature:

API Change:

  • Remove the AdmissionregistrationV1alpha1 API group, containing only the InitializationConfiguration type kubernetes/kubernetes#72972
  • Promote Lease API to v1 kubernetes/kubernetes#72239
  • The Ingress API is now available via NetworkingV1beta1Api. ExtensionsV1beta1Api Ingress objects are deprecated and will no longer be served in Kubernetes v1.18 kubernetes/kubernetes#74057
  • Introduce RuntimeClass to NodeV1alpha1Api and NodeV1beta1Api kubernetes/kubernetes#74433
  • Graduate PriorityClass API to GA SchedulingV1Api kubernetes/kubernetes#73555
  • Introduce CSINodeInfo and CSIDriver to StorageV1beta1Api kubernetes/kubernetes#74283
  • The alpha Initializers feature, admissionregistration.k8s.io/v1alpha1 API version, Initializers admission plugin, and use of the metadata.initializers API field have been removed. Discontinue use of the alpha feature and delete any existing InitializerConfiguration API objects before upgrading. The metadata.initializers field will be removed in a future release. The parameter include_uninitialized has been removed. kubernetes/kubernetes#72972

v9.0.0

Bug Fix:

v9.0.0b1

Breaking Change:

Bug Fix:

API Change:

New Feature:

v9.0.0a1

Bug Fix:

Security Fix:

API Change:

  • Add dynamic audit configuration api: AuditregistrationV1alpha1Api kubernetes/kubernetes#67547
  • CSIPersistentVolume feature, i.e. PersistentVolumes with CSIPersistentVolumeSource, is GA. CSIPersistentVolume feature gate is now deprecated and will be removed according to deprecation policy. kubernetes/kubernetes#69929
  • Add support for CRD conversion webhook kubernetes/kubernetes#67006
  • CRD supports multi-version Schema, Subresources and AdditionalPrintColumns (NOTE that CRDs created prior to 1.13 populated the top-level additionalPrinterColumns field by default. To apply an update that changes to per-version additionalPrinterColumns, the top-level additionalPrinterColumns field must be explicitly set to null). kubernetes/kubernetes#70211
  • Add ability to control primary GID of containers through Pod Spec and PodSecurityPolicy kubernetes/kubernetes#67802
  • Refactor GlusterFS PV spec. This patch introduces glusterfsPersistentVolumeSource addition to glusterfsVolumeSource. All fields remains same as glusterfsVolumeSource with an addition of a new field called EndpointsNamespace to define namespace of endpoint in the spec. kubernetes/kubernetes#60195
  • Delete request's body parameter is optional kubernetes/kubernetes#70032
  • Make service environment variables optional kubernetes/kubernetes#68754
  • TokenReview now supports audience validation of tokens with audiences other than the kube-apiserver. kubernetes/kubernetes#62692

Breaking Change:

  • Model v1beta1WebhookClientConfig is renamed to AdmissionregistrationV1beta1WebhookClientConfig, to avoid naming conflict with ApiextensionsV1beta1WebhookClientConfig introduced in: kubernetes/kubernetes#67006
  • Delete request's body parameter is optional kubernetes/kubernetes#70032

v8.0.1

Bug Fix:

Security Fix:

v7.0.1

Security Fix:

v6.1.0

  • Python 3.7 support
  • Update to Kubernetes 1.10.10 API

Breaking Change:

  • ACTION REQUIRED Rename the currently being-used async parameter to async_req to support Python 3.7 because async is a reserved keyword in Python 3.7 kubernetes-client/gen#67
  • NOTE Python 3.7 was released after v6.0.0 release. It's not necessary to upgrade your client to v6.1.0 if you do not use Python 3.7+.

API change:

v8.0.0

New Feature:

v8.0.0b1

Bug Fix:

API Change:

v8.0.0a1

New Feature:

Bug Fix:

API Change:

  • Upon receiving a LIST request with expired continue token, the apiserver now returns a continue token together with the 410 "the from parameter is too old " error. If the client does not care about getting a list from a consistent snapshot, the client can use this token to continue listing from the next key, but the returned chunk will be from the latest snapshot kubernetes/kubernetes#67284
  • Introduces autoscaling/v2beta2 and custom_metrics/v1beta2, which implement metric selectors for Object and Pods metrics, as well as allowing AverageValue targets on Objects, similar to External metrics kubernetes/kubernetes#64097
  • Create "coordination.k8s.io" api group with "Lease" api in it kubernetes/kubernetes#64246
  • Added support to restore a volume from a volume snapshot data source: adds TypedLocalObjectReference in the core API and adds DataSource in PersistentVolumeClaimSpec kubernetes/kubernetes#67087
  • ProcMount added to SecurityContext and AllowedProcMounts added to PodSecurityPolicy to allow paths in the container's /proc to not be masked kubernetes/kubernetes#64283
  • Support both directory and block device for local volume plugin FileSystem VolumeMode kubernetes/kubernetes#63011
  • SCTP is now supported as additional protocol (alpha) alongside TCP and UDP in Pod, Service, Endpoint, and NetworkPolicy kubernetes/kubernetes#64973
  • RuntimeClass is a new API resource for defining different classes of runtimes that may be used to run containers in the cluster. Pods can select a RunitmeClass to use via the RuntimeClassName field. This feature is in alpha, and the RuntimeClass feature gate must be enabled in order to use it kubernetes/kubernetes#67737
  • The PodShareProcessNamespace feature to configure PID namespace sharing within a pod has been promoted to beta kubernetes/kubernetes#66507
  • To address the possibility dry-run requests overwhelming admission webhooks that rely on side effects and a reconciliation mechanism, a new field is being added to admissionregistration.k8s.io/v1beta1.ValidatingWebhookConfiguration and admissionregistration.k8s.io/v1beta1.MutatingWebhookConfiguration so that webhooks can explicitly register as having dry-run support. If a dry-run request is made on a resource that triggers a non dry-run supporting webhook, the request will be completely rejected, with "400: Bad Request". Additionally, a new field is being added to the admission.k8s.io/v1beta1.AdmissionReview API object, exposing to webhooks whether or not the request being reviewed is a dry-run kubernetes/kubernetes#66936
  • Add custom object status and scale api kubernetes-client/gen#72
  • dry-run: DELETE operations now support dryRun parameter kubernetes/kubernetes#65105
  • Default extensions/v1beta1 Deployment's ProgressDeadlineSeconds to MaxInt32 kubernetes/kubernetes#66581

v7.0.0

New Features:

v7.0.0b1

New Features:

v7.0.0a1

Breaking Change:

  • ACTION REQUIRED Rename the currently being-used async parameter to async_req to support Python 3.7 because it's a reserved keyword in Python 3.7 kubernetes-client/gen#67

Bug Fix:

API Change:

v6.0.0

v6.0.0b1

API change:

  • CustomObjectsApi: Add PATCH to CustomObjectsApi kubernetes-client/gen#53
  • Promoting the apiregistration.k8s.io (aggregation) to GA (ApiregistrationV1Api) kubernetes/kubernetes#58393
  • CoreV1Api: remove /proxy legacy API (deprecated since kubernetes v1.2). Use the /proxy subresources on objects that support HTTP proxying kubernetes/kubernetes#59884
  • The PodSecurityPolicy API has been moved to the policy/v1beta1 API group. The PodSecurityPolicy API in the extensions/v1beta1 API group is deprecated and will be removed in a future release. Authorizations for using pod security policy resources should change to reference the policy API group after upgrading to 1.11 kubernetes/kubernetes#54933
  • StorageV1beta1Api: Introduce new VolumeAttachment API Object kubernetes/kubernetes#54463
  • V1FlexPersistentVolumeSource: PersistentVolume flexVolume sources can now reference secrets in a namespace other than the PersistentVolumeClaim's namespace kubernetes/kubernetes#56460
  • ACTION REQUIRED: VolumeScheduling and LocalPersistentVolume features are beta and enabled by default. The PersistentVolume NodeAffinity alpha annotation is deprecated and will be removed in a future release kubernetes/kubernetes#59391
  • Allows HorizontalPodAutoscaler to use global metrics not associated with any Kubernetes object (for example metrics from a hoster service running outside of Kubernetes cluster) kubernetes/kubernetes#60096
  • v1.Pod now has a field to configure whether a single process namespace should be shared between all containers in a pod. This feature is in alpha preview. kubernetes/kubernetes#58716
  • delete_namespaced_service() now takes an required body (delete option) parameter. Refactor service storage to remove registry wrapper kubernetes/kubernetes#59510

Documentation update:

v5.0.0

  • No changes. The same as v5.0.0b1.

v5.0.0b1

  • Update to Kubernetes 1.9 cluster
  • Label selector for pods is now required and must match the pod template's labels for v1beta2 StatefulSetSpec, ReplicaSetSpec, DaemonSetSpec and DeploymentSpec kubernetes/kubernetes#55357
  • 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
  • DaemonSet, Deployment, ReplicaSet, and StatefulSet have been promoted to GA and are available in the apps/v1 group version kubernetes/kubernetes#53679
  • Introduce new storage.k8s.io/v1alpha1 VolumeAttachment object kubernetes/kubernetes#54463
  • Introduce core/v1 RBDPersistentVolumeSource kubernetes/kubernetes#54302
  • StatefulSet status now has support for conditions kubernetes/kubernetes#55268
  • DaemonSet status now has support for conditions kubernetes/kubernetes#55272

v4.0.0

  • api change V1PersistentVolumeSpec to V1ScaleIOPersistentVolumeSource #397.

v4.0.0b1

  • Make sure PyPI source distribution is complete with all files from the root directory

v4.0.0a1

  • Update to Kubernetes 1.8 cluster
  • IntOrString is now object thus it can be int or string. #18 #359
  • Adding stream package to support calls like exec. The old way of calling them is deprecated. See Troubleshooting).
  • config.http_proxy_url is deprecated. use configuration.proxy instead.
  • Configuration is not a singleton object anymore. Please use Configuraion.set_default to change default configuration.
  • Configuration class does not support ws_streaming_protocol anymore. In ApiClient.set_default_header set sec-websocket-protocol to the preferred websocket protocol.

v3.0.0

v3.0.0b1

v3.0.0a1

  • Update client to kubernetes 1.7
  • Support ThirdPartyResources (TPR) and CustomResourceDefinitions (CRD). Note that TPR is deprecated in kubernetes #251 #201
  • Better dependency management #136
  • Add support for python3.6 #244

v1.0.2

  • Bugfix: support RFC6902 'json-patch' operations #187

v2.0.0

  • No changes. The same as v2.0.0b1.

v2.0.0b2

  • Bugfix: support RFC6902 'json-patch' operations #187

v1.0.1

  • Bugfix: urllib3 1.21 fails tests, Excluding version 1.21 from dependencies #197

v2.0.0b1

  • Add support for attach API calls #180
  • Bugfix: token file should not be decoded #182
  • Inline primitive models (e.g. v1.Time and resource.Quantity) #179
  • Bugfix: urllib3 1.21 fails tests, Excluding version 1.21 from dependencies #197

v2.0.0a1

  • Update to kubernetes 1.6 spec #169

v1.0.0

  • Bugfix: blocking exec call should remove channel metadata #140
  • Add close method to websocket api of interactive exec #145

v1.0.0b3

  • Bugfix: Missing websocket-client dependency #131

v1.0.0b2

  • Support exec calls in both interactive and non-interactive mode #58

v1.0.0b1

  • Support insecure-skip-tls-verify config flag #99
  • Added example for using yaml files as models #63
  • Added end to end tests #41, #94
  • Bugfix: Fix ValueError in list_namespaced_config_map #104
  • Bugfix: Export missing models #101
  • Bugfix: Patch operations #93

v1.0.0a5

v1.0.0a4

  • Bugfix: Fixed broken config loader #77

v1.0.0a3

  • Add context switch to kube config loader #46
  • Add default kube config location #64
  • Add suport for accessing multiple clusters #7
  • Bugfix: Python client does not resolve relative paths in kubeconfig #68
  • Bugfix: read_namespaced_pod_log get None response #57
  • Improved test coverage #54
  • Improved client generator #49

v1.0.0-alpha2

  • auto-generated client from K8s OpenAPI spec
  • kube-config support
  • in-cluster config support: Run scripts inside kubernetes cluster
  • watch support

v1.0.0-alpha1

Skipped because of a failed initial release.