Notable changes to this project will be documented in this file. The format is based on Keep a Changelog. Kubeclient release versioning follows SemVer.
-
Support
:resourceVersionparameter inget_foosmethods (similar to existing support inwatch_foosmethods). (#420) -
Relax dependency on
httpgem to allow both 3.x and 4.x. (#413)
- GCP configs with
user[auth-provider][name] == 'gcp'will execute credential plugin (normally thegcloud config config-helpersubcommand) when the config specifies it incmd-path,cmd-argsfields (similar toexecsupport). This code path works withoutgoogleauthgem. Otherwise,GoogleApplicationDefaultCredentialspath will be tried as before. (#410) AmazonEksCredentialshelper for obtaining a token to authenticate against Amazon EKS. This is not currently integrated inConfig, you will need to invoke it yourself. You'll need some aws gems that Kubeclient does not include. (#404, #406)
- OpenID Connect tokens which cannot be validaded because we cannot identify the key they were signed with will be considered expired and refreshed as usual. (#407)
GoogleApplicationDefaultCredentialswill now automatically be used byConfigif theuser[auth-provider][name] == 'gcp'in the provided context. Note thatuser[exec]is checked first in anticipation of this functionality being added to GCP sometime in the future. Kubeclient does not include the requiredgoogleauthgem, so you will need to include it in your calling application. (#394)
-
OpenID Connect credentials will automatically be used if the
user[auth-provider][name] == 'oidc'in the provided context. Note thatuser[exec]is checked first. Kubeclient does not include the requiredopenid_connectgem, so you will need to include it in your calling application. (#396) -
Support for
json_patch_#{entity}andmerge_patch_#{entity}.patch_#{entity}will continue to use strategic merge patch. (#390)
- New
http_max_redirectsoption (#374).
- Default max redirects for watch increased from 4 to 10, to match other verbs (#374).
- For resources that contain dashes in name, there will be an attempt to resolve the method name based on singular name prefix or by replacing the dash in names with underscores (#383).
- Support
user: exec: ...credential plugins like in Go client (#363, #375).
-
Really made
Kubeclient::Config.new(data, nil)prevent external file lookups. (#372) README documented this since 3.1.1 (#334) but alas that was a lie — absolute paths always worked. Now this also prevents credential plugin execution.Even in this mode, using config from untrusted sources is not recommended.
This release included all changes up to 4.1.1, but NOT 4.1.2 which was branched off later (4.2.1 does include same fix).
- For resources that contain dashes in name, there will be an attempt to resolve the method name based on singular name prefix or by replacing the dash in names with underscores (#382).
- Fixed method names for non-suffix plurals such as y -> ies (#377).
This version broke method names where plural is not just adding a suffix, notably y -> ies (bug #376).
- Support custom resources with lowercase
kind(#361). create_security_context_constraintnow works (#366).get_security_context_constraints.kind,get_endpoints.kindare now plural as in kubernetes (#366).
- Add support for retrieving large lists of objects in chunks (#356).
- Bumped officially supported kubernetes versions to >= 1.3.
- Specifically
proxy_urlno longer works for <= 1.2 (#323).
proxy_urlnow works for kubernetes 1.10 and later (#323).
- Switched
httpgem dependency from 2.y to 3.y (#321).
- Fixed
Kubeclient::Config.readregression, no longer crashes on YAML timestamps (#338).
In this version Kubeclient::Config.read raises Psych::DisallowedClass on legal yaml configs containing a timestamp, for example gcp access-token expiry (bug #337).
-
Changed
Kubeclient::Config.readto useYAML.safe_load(#334).Previously, could deserialize arbitrary ruby classes. The risk depends on ruby classes available in the application; sometimes a class may have side effects - up to arbitrary code execution - when instantiated and/or built up with
x[key] = valueduring YAML parsing.Despite this fix, using config from untrusted sources is not recommended.
- Fixed watch
.finishsometimes causedHTTP::ConnectionErrorexception from the reading loop (#315).
get_pod_lognow hastimestamps,since_time(#319) andtail_lines(#326) params.Kubeclient::Config::Context#namespacenow set, if present in kubeconfig file (#308).- Improved README directions for authenticating within a kubernetes cluster (#316).
Kubeclient::GoogleApplicationDefaultCredentialshelper for Google application default credentials (#213). Needsgoogleauthgem.- New
as: :parsedandas: :parsed_symbolizedformats (#306). - Allow setting default
as:format for the whole client (#299, #305). - Relaxed
recursive-open-structdependency to allow 1.1+ as well (#313).
- Dropped entity classes (
Kubeclient::Podetc.), onlyKubeclient::Resourceexists now (#292, #288). - Ruby 2.0, 2.1 no longer supported (#253, #291).
- Added missing singular
get_security_context_constraint, fixedget_security_context_constraintsto mean plural (#261). - Fixed
@http_proxy_uriundefined warning (#261). - Documentation fixes & improvements (#225, #229, #243, #296).
delete_options:parameter todelete_*methods, useful for cascade delete (#267).as: :rawoption for watch (#285).- Now raises
Kubeclient::HttpError. RescuingKubeExceptionstill works but is deprecated. (#195, #288)- 404 error raise
Kubeclient::ResourceNotFoundError, a subclass ofHttpError(#233).
- 404 error raise
- Include request info in exception message (#221).
- Ruby 2.4 and 2.5 are now supported & tested (#247, #295).
Kubeclient::Config#context(nonexistent_context_name)raisesKeyErrorinstead ofRuntimeError.update_*,delete_*,patch_*now all returnRecursiveOpenStructconsistently (#290).- Many dependencies bumped (#204, #231, #253, #269).
- Watch results are now
RecursiveOpenStructinside arrays too (#279). - Fixed watch
.finishsometimes causedErrno::EBADFexception from the reading loop (#280). - Easing dependency version (#287, #301)
No changes since 2.5.0, fixed packaging mistake.
as: rawoption forget_*methods returning a string (#262 via #271).