kubernetes-client

Bugs

• Fix #2905: NullPointerException when attempting to generate non-parameterized CustomResources
• Fix #2900: Improve handling of complex CR hierarchies, falling back to ignoring status replicas instead of skipping CRD generation altogether

Bugs

• Fix #2802: NullPointerException in HasMetadataOperation patch/replace when using KubernetesMockServer
• Fix #2828: Remove automatic instantiation of CustomResource spec and status as this feature was causing more issues than it was solving
• Fix #2857: Fix the log of an unexpected error from an Informer's EventHandler
• Fix #2853: Cannot change the type of the Service from ClusterIP to ExternalName with PATCH
• Fix #2855: .withPropagationPolicy and .withGracePeriod DSL methods can't be combined for Resource API deletion operations
• Fix #2783: OpenIDConnectionUtils#persistKubeConfigWithUpdatedToken persists access token instead of refresh token
• Fix #2871: Change longFileMode to LONGFILE_POSIX for creating tar in PodUpload, improve exception handling in PodUpload.
• Fix #2746: SharedInformerFactory should use key formed from OperationContext
• Fix #2736: Move CRD annotations to kubernetes-model-common module for greater coherence
• Fix #2836: Make CRD generation usable at runtime, split the generator into api and apt modules,
  the crd-generator-apt artifact corresponding to the previous crd-generator artifact, while the
  crd-generator-api artifact can be consumed directly to generate the CRDs at runtime.

Improvements

• Fix #2781: RawCustomResourceOperationsImpl#delete now returns a boolean value for deletion status
• Fix #2780: Refactor RawCustomResourceOperationsImpl#delete(String)

New Features

• Fix #2818: Update chaos-mesh extension to v1.1.1. Add PodIoChaos, JVMChaos, HTTPChaos and DNSChaos.
• Fix #2699: Add support for @EnableOpenShiftMockClient for OpenShiftClient
• Fix #2588: Support for Server side dry runs

Bugs

• Fix #2747: Apiextensions DSL should use NonNamespaceOperation for CustomResourceDefinitions
• Fix #2819: simple enums are now supported when generating CRDs
• Fix #2827: CNFE when initialzing CustomResource instances
• Fix #2815: client.isAdaptable(OpenShiftClient.class) doesn't work on OpenShift 4
• Fix #2833: Knative model genrator is now aligned with all other generators

Bugs

• Fix #2748: Pass custom headers in kubernetes-client to watch api by modify WatchConnectionManager
• Fix #2745: Filtering Operations can't configure PropagationPolicy
• Fix #2672: WaitUntilReady for Service resource throws IllegalArgumentException

Improvements

• Fix #2717: Remove edit() methods from RawCustomResourceOperationsImpl taking InputStream arguments
• Fix #2757: add storage and served to Version annotation
• Fix #2759: add ShortNames annotation to specify short names for CRD generation
• Fix #2694: Remove deprecated methods from KubernetesClient DSL
• Fix #2716: Add a property to disable BackwardCompatibilityInterceptor

Dependency Upgrade

• Fix #2706: update Tekton Triggers model to v0.11.1
• Fix #2684: Upgrade Kubernetes Model to v1.20.2

New Features

• Fix #2702: Add support for discovery.k8s.io/v1beta1 EndpointSlice in KubernetesClient DSL
• Fix #2703: Add support for certificates.k8s.io v1 and v1beta1 API in KubernetesClient DSL
• Fix #2708: Update CSI Volume Snapshot API to v1
• Fix #2789: Use thread context class loader instead of Class.forName
• Fix #2779: Add DSL support for scheduling.k8s.io v1 and v1beta1 to SchedulingAPIGroupDSL
• Fix #2776: Preview release of CRD generator based on annotations
  • Classes extending the CustomResource class can now be used as the basis for CRD generation
  • Several annotations are available to override the default behavior if it doesn't fit your needs
  • Validation schema is automatically derived from your class' spec implementation (or from the CR
    class, if no spec is present)
  • CRDs are automatically generated at compile-time if you include the io.fabric8:crd-generator
    dependency to your project (with the suggested compile scope)
  • CRDs are generated for both v1beta1 and v1 versions of the specification at this point
  • One CRD manifest is generated per CRD using the CRD name (e.g. mycrplural.group.example.com)
    suffixed with the specification version, e.g. mycrplural.group.example.com-v1.yml
  • The CRD files are generated in the target/META-INF/fabric8 directory of your project

Note: Breaking changes in the API

DSL Changes:

• client.settings() DSL has been removed since PodPreset v1alpha1 API is no longer present in Kubernetes 1.20.x
• client.customResourceDefinitions() has been removed. Use client.apiextensions().v1beta1().customResourceDefinitions() instead
• client.events() has been removed. Use client.v1().events() instead
• client.customResource(...) method is removed. Use client.customResources(...) with CustomResource configuration in annotations inside POJOs

Model Changes:

• Classes in io.fabric8.kubernetes.api.model.scheduling have been moved to io.fabric8.kubernetes.api.model.scheduling.v1 and io.fabric8.kubernetes.api.model.scheduling.v1beta1
• Classes in io.fabric8.kubernetes.api.model.admission have been moved to io.fabric8.kubernetes.api.model.admission.v1 and io.fabric8.kubernetes.api.model.admission.v1beta1
• Classes in io.fabric8.kubernetes.api.model.certificates have been moved to io.fabric8.kubernetes.api.model.certificates.v1 and io.fabric8.kubernetes.api.model.certificates.v1beta1
• Classes in io.fabric8.kubernetes.api.model.events have been moved to io.fabric8.kubernetes.api.model.events.v1 and io.fabric8.kubernetes.api.model.events.v1beta1

Bugs

• Fix #2715: CVE-2021-20218 vulnerable to a path traversal leading to integrity and availability compromise

Bugs

• Fix #2715: CVE-2021-20218 vulnerable to a path traversal leading to integrity and availability compromise

Bugs

• Fix #2715: CVE-2021-20218 vulnerable to a path traversal leading to integrity and availability compromise

Bugs

• Fix #2715: CVE-2021-20218 vulnerable to a path traversal leading to integrity and availability compromise

Bugs

• Fix #2687: RawCustomResourceOperationsImpl ignores config
• Fix #2612: add support for checking latest kubeconfig in Interceptor

Improvements

• Fix #2723: Dependency cleanup
• Remove javax.annotation-api
• Remove jaxb-api
• Remove jacson-module-jaxb-annotations
• Fix #2744: Automatically instantiates spec and status fields on CustomResource when possible.
  initSpec and initStatus methods are also provided to allow for overriding of the default implementation.

Dependency Upgrade

• Fix #2723: Upgrade sundrio.version to 0.24.1

Bugs

• Fix #2734: (Backport #2596) Add buildable ref for container, port and volume

Bugs

• Fix #2695: fromCustomResourceType should be of type CustomResource

Bugs

• Fix #2671: Reliability improvements to watchers
• Fix #2592: ConcurrentModificationException in CRUD KubernetesMockServer
• Fix #2519: Generated schemas contains a valid meta-schema URI reference (http://json-schema.org/draft-05/schema#)
• Fix #2631: Handle null values when getting current context on OIDC interceptors
• Fix #2510 : Yaml containing aliases rejected due to FasterXML bug
• Fix #2651: SharedInformers should ignore resync on zero resyncPeriod
• Fix #2656: Binding operations can be instantiated

Improvements

• Fix #2676: Allow specifying PropagationPolicy when using deleteExisting
• Fix #2678: Adds a convenience method for referring to Cache keys by namespace and name rather than item
• Fix #2665: CustomResourceDefinitionContext.fromCrd support for v1 CustomResourceDefinition
• Fix #2642: Update kubernetes-examples to use apps/v1 Deployment rather than extensions/v1beta1

New Features

• Fix #2611: Support for Custom Resource and Custom Resource Definitions has been improved
  • New annotations have been introduced for users to specify group, version, singular and plural
    properties for CustomResource instances
  • CustomResource instances must now be annotated with @ApiVersion and @ApiGroup so that the
    associated information can be automatically computed
  • HasMetadata provides default implementations for getApiVersion and getKind based on the
    presence (or not) of annotations on the target class
  • Static methods have been introduced on HasMetadata and CustomResource to encapsulate the
    logic used to resolve Kind, ApiVersion, Group, Version, Plural, Singular and CRD Name
    properties
  • New v1CRDFromCustomResourceType and v1beta1CRDFromCustomResourceType methods have been
    introduced on CustomResourceDefinitionContext to initialize a CustomResourceDefinitionBuilder
    with the information provided by a specific CustomResource implementation, making it much
    easier to create CRDs if you already have defined your custom resource type
  • CustomResource is now parameterized by the spec and status types that it uses which further
    removes boiler plate
• Rename @ApiVersion and @ApiGroup to simply @Version and @Group, respectively. This was done
  to unify annotations and also remove potential confusion between values provided to @ApiVersion
  and what is returned by HasMetadata#getApiVersion

Bugs

• Fix #2519: Generated schemas contains a valid meta-schema URI reference (http://json-schema.org/draft-05/schema#)
• Fix #2628: add isFinalizerValid to encapsulate validation logic
• Fix #2631: Handle null values when getting current context on OIDC interceptors
• Fix #2610: Remove deprecated module kubernetes-model-generator/model-generator-app

Improvements

• Fix #2628: Add isFinalizerValid method on HasMetadata to encapsulate validation logic
• Fix #2640: Edit method accepts Visitors

Dependency Upgrade

• Fix #2636: Upgrade sundrio.version to 0.23.0

Improvements

• Fix #2614: Watcher.onClose has dedicated WatcherException as parameter.

Bugs

• Fix #2596: Add buildable references for Container, Port and Volume

Improvements

• Fix #2571: Eliminated the use of Doneables and simplified the internal DSL implementation.
• Fix #2607: add isMarkedForDeletion and finalizer-related default methods to HasMetadata (@metacosm)
• Fix #2605: Provide a customResources alternative that simply accepts the resource type as an argument.

Bugs

• Fix #2517: Replace does not work in CRUD mockwebserver
• Fix #2537: Checking for Readiness of DeploymentConfig
• Fix #2300: Remove job extensions/v1beta1 from backward compatibiliy interceptor
• Fix #2514: SharedIndexInformer watches only pods of its own namespace when run in the cluster

Improvements

• Fix #2507: Add a test for creating a Job with generateName
• Fix #2509: Reversed order + Add Kubernetes 1.16.0 + OpenShift 4.5.14 to Compatibility matrix
• Add cache in github actions for integration tests

Dependency Upgrade

• Fix #2513: Update Kubernetes Model to v1.19.1

New Features

• Fix #2531: Allow setting the maximum concurrent requests via system property / environment variable
• Fix #2534: Tekton model based on Tekton Pipeline 0.17.0
• Fix #2574: Add support for Condition type

Note: Breaking changes in the API

• Tekton Pipeline v1beta1 sidecars field from a task step is now a list of io.fabric8.tekton.pipeline.v1beta1.Sidecar instead of a list of io.fabric8.tekton.pipeline.v1beta1.Step

• NetworkPolicy moved to io.fabric8.kubernetes.api.model.networking.v1.NetworkPolicy from
  io.fabric8.kubernetes.api.model.networking.NetworkPolicy

• Fix #2557: add missing OpenShiftReadiness.isReadinessApplicable

Bugs

• Fix #2442: Wrong resource kind in ProjectRequestHandler causes ClassCastException when handling Project resources.
• Fix #2467: OpenShiftClient cannot replace existing resource with API version =! v1
• Fix #2458: Creating new instance of the DefaultKubernetesClient is hanging
• Fix #2474: Config.fromKubeconfig throws NullPointerException
• Fix #2399: Cannot change the type of the Service from ClusterIP to ExternalName
• Fix #2479: KuberentesDeserializer works on OSGi runtime environments
• Fix #2488: Unable to derive module descriptors for kubernetes-model jars

Improvements

• Enable user to select custom address and port for KubernetesMockServer
• Fix #2473: Removed unused ValidationMessages.properties
• Fix #2408: Add documentation for Pod log options
• Fix #2141: Decouple OpenShift Model from Kubernetes Client
• Fix #2452: Make Readiness.isReady publicly available from a wrapper method in KubernetesResourceUtil

Dependency Upgrade

• Bump Knative Serving to v0.17.2 & Knative Eventing to v0.17.3

New Features

• Fix #2340: Adding support for Knative Eventing Contrib
• Fix #2111: Support automatic refreshing for expired OIDC tokens
• Fix #2146: Add Support for specifying CustomResourceDefinitionContext while initializing KubernetesServer
• Fix #2314: Fetch logs should wait for the job's associated pod to be ready
• Fix #2043: Support for Tekton Triggers
• Fix #2460: Querying for an event based on InvolvedObject fields

Note Minor breaking changes:

• PR #2424 (#2414) slightly changes the API by adding the new WatchAndWaitable "combiner" interface.
  Most projects shouldn't require any additional changes.

Bugs

• Fix #2445: ConfigMap and other resources are replaced

Bugs

• Fix #2373: Unable to create a Template on OCP3
• Fix #2308: Fix kubernetes client Config loading KUBECONFIG with external authentication command
• Fix #2316: Cannot load resource from stream without apiVersion
• Fix #2354: Fix NullPointerException in ResourceCompare when no resource is returned from fromServer.get()
• Fix #2389: KubernetesServer does not use value from https in crud mode
• Fix #2306: Make KubernetesServer CRUD mode work with informers
• Fix #2418: CertificateSigningRequest doesn't implement Namespaced
• Fix #2265: InAnyNamespace uses invalid api endpoint for SelfSubjectAccessReviews
• Fix #2404: Readiness.isReady doesn't handle extensions/v1beta1 Deployment
• Fix #2389: KubernetesServer JUnit rule ignores value of https when using crud mode

Improvements

• Fix #2331: Fixed documentation for namespaced informer for all custom types implementing Namespaced interface
• Fix #2406: Add documentation for serializing resources to YAML

Dependency Upgrade

• Fix #2360: bump mockito-core from 3.4.0 to 3.4.2
• Fix #2355: bump jandex from 2.1.3.Final to 2.2.0.Final
• Fix #2353: chore: bump workflow action-setup versions + kubernetes to 1.18.6
• Fix #2292: Update createOrReplace to do replace when create fails with conflict
• Fix: Bump SnakeYaml to version 1.26 (as required for OSGi bundle for jackson-dataformat-yaml)
• Fix #2401: bump maven-resources-plugin from 3.1.0 to 3.2.0
• Fix #2405: bump mockito-core from 3.4.4 to 3.5.0

New Features

• CSI Volume Snapshot extension
• Fix #2311: Add Support for creating bootstrap project template
• Fix #2287: Add support for V1 and V1Beta1 CustomResourceDefinition
• Fix #2319: Create Config without using auto-configure functionality or setting env variables
• Fix #2284: Supports create and run a particular image in a pod operation using client
• Fix #2321: Add Support for new resources in OpenShift Model

Note: Some classes have been moved to other packages:

• CustomResourceDefinition has been moved to io.fabric8.kubernetes.api.model.apiextensions.v1 and io.fabric8.kubernetes.api.model.apiextensions.v1beta1
• SubjectAccessReview, SelfSubjectAccessReview, LocalSubjectAccessReview and SelfSubjectRulesReview have been moved to io.fabric8.kubernetes.api.model.authorization.v1 and io.fabric8.kubernetes.api.model.authorization.v1beta1
• io.fabric8.tekton.pipeline.v1beta1.WorkspacePipelineDeclaration is now io.fabric8.tekton.pipeline.v1beta1.PipelineWorkspaceDeclaration

Bugs

• Fix #2285: Raw CustomResource API createOrReplace does not propagate exceptions from create
• Fix Raw CustomResource API path generation to not having trailing slash
• Fix #2131: Failing to parse CustomResourceDefinition with OpenAPIV3Schema using JSONSchemaPropOr* fields
• Fix #2297: Resuscitate ProjectRequestHandler in openshift-client
• Fix #2328: Failure in deserialization while watching events
• Fix #2299: Improve error handling of RejectedExecutionException from ExecutorService
• Fix KubernetesAttributesExctractor to extract metadata from unregistered custom resources, such when using Raw CustomResource API
• Fix #2296: No adapter available for type:interface io.fabric8.kubernetes.client.dsl.V1APIGroupDSL
• Fix #2269: Setting a grace period when deleting resource using withPropagationPolicy()
• Fix #2342: watchLogs for deployment is broken
• Fix #2309: Move HasMetadataComparator to exported package

Improvements

• Fix #2233: client.service().getUrl(..) should be able to fetch URL for ClusterIP based services
• Fix #2278: Added type parameters for KubernetesList in KubernetesClient + test verifying waitUntilCondition always retrieves resource from server
• Fix #2336: Test and fix for the wrong "Kind" declared on KubernetesListHandler
• Fix #2320: Added JUnit5 extension for mocking KubernetesClient in tests using @EnableKubernetesMockClient
• Fix #2332: Added PodExecOptions model
• Improve error handling on stream closing errors in S2I binary builds(#2032)
• Fix #2288: Adds configurable serializers and deserializers to json schema codegen

Dependency Upgrade

• Fix #2333: bump bouncycastle.version from 1.65 to 1.66
• Fix #2262: bump maven-shade-plugin from 3.2.3 to 3.2.4
• Fix #2261: bump exec-maven-plugin from 1.6.0 to 3.0.0
• Fix #2345: bump mockito-core from 3.3.3 to 3.4.0
• Fix #2260: Bump tektoncd pipeline to v0.12.1

New Features

• Fix #1868: Add Support for rolling update
• Fix #2266: Support for APIServices in Kubernetes Client
• Fix #2215: io.fabric8.kubernetes.client.Config should expose all and the current context defined in kubeconfig