版本支持
client version | 1.13 | 1.14 | 1.15 | 1.16 | 1.17 | 1.18 |
---|---|---|---|---|---|---|
5.0.0 | ✓ | - | - | x | x | x |
6.0.1 | + | ✓ | - | - | x | x |
7.0.0 | + | + | ✓ | - | - | x |
8.0.2 | + | + | + | ✓ | - | - |
9.0.2 | + | + | + | + | ✓ | - |
10.0.0 | + | + | + | + | + | ✓ |
例子:
/*
Copyright 2020 The Kubernetes Authors.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package io.kubernetes.client.examples;
import io.kubernetes.client.custom.V1Patch;
import io.kubernetes.client.openapi.ApiException;
import io.kubernetes.client.openapi.Configuration;
import io.kubernetes.client.openapi.apis.AppsV1Api;
import io.kubernetes.client.openapi.models.V1Deployment;
import io.kubernetes.client.util.ClientBuilder;
import io.kubernetes.client.util.PatchUtils;
import java.io.IOException;
/**
* A simple Example of how to use the Java API.<br>
* This example demonstrates patching of deployment using Json Patch and Strategic Merge Patch.<br>
* For generating Json Patches, refer <a href="http://jsonpatch.com/">http://jsonpatch.com</a>. For
* generating Strategic Merge Patches, refer <a
* href="https://github.com/kubernetes/community/blob/master/contributors/devel/sig-api-machinery/strategic-merge-patch.md">strategic-merge-patch.md</a>.
*
* <ul>
* <li>Creates deployment hello-node with <b>terminationGracePeriodSeconds</b> value as 30 and a
* finalizer.
* <li>Json-Patches deployment hello-node with <b>terminationGracePeriodSeconds</b> value as 27.
* <li>Strategic-Merge-Patches deployment hello-node removing the finalizer.
* </ul>
*
* <p>Easiest way to run this: mvn exec:java
* -Dexec.mainClass="io.kubernetes.client.examples.PatchExample"
*
* <p>From inside $REPO_DIR/examples
*/
public class PatchExample {
static String jsonPatchStr =
"[{\"op\":\"replace\",\"path\":\"/spec/template/spec/terminationGracePeriodSeconds\",\"value\":27}]";
static String strategicMergePatchStr =
"{\"metadata\":{\"$deleteFromPrimitiveList/finalizers\":[\"example.com/test\"]}}";
static String jsonDeploymentStr =
"{\"kind\":\"Deployment\",\"apiVersion\":\"apps/v1\",\"metadata\":{\"name\":\"hello-node\",\"finalizers\":[\"example.com/test\"],\"labels\":{\"run\":\"hello-node\"}},\"spec\":{\"replicas\":1,\"selector\":{\"matchLabels\":{\"run\":\"hello-node\"}},\"template\":{\"metadata\":{\"creationTimestamp\":null,\"labels\":{\"run\":\"hello-node\"}},\"spec\":{\"terminationGracePeriodSeconds\":30,\"containers\":[{\"name\":\"hello-node\",\"image\":\"hello-node:v1\",\"ports\":[{\"containerPort\":8080,\"protocol\":\"TCP\"}],\"resources\":{}}]}},\"strategy\":{}},\"status\":{}}";
static String applyYamlStr =
"{\"kind\":\"Deployment\",\"apiVersion\":\"apps/v1\",\"metadata\":{\"name\":\"hello-node\",\"finalizers\":[\"example.com/test\"],\"labels\":{\"run\":\"hello-node\"}},\"spec\":{\"replicas\":1,\"selector\":{\"matchLabels\":{\"run\":\"hello-node\"}},\"template\":{\"metadata\":{\"creationTimestamp\":null,\"labels\":{\"run\":\"hello-node\"}},\"spec\":{\"terminationGracePeriodSeconds\":30,\"containers\":[{\"name\":\"hello-node\",\"image\":\"hello-node:v2\",\"ports\":[{\"containerPort\":8080,\"protocol\":\"TCP\"}],\"resources\":{}}]}},\"strategy\":{}},\"status\":{}}";
public static void main(String[] args) throws IOException {
try {
AppsV1Api api = new AppsV1Api(ClientBuilder.standard().build());
V1Deployment body =
Configuration.getDefaultApiClient()
.getJSON()
.deserialize(jsonDeploymentStr, V1Deployment.class);
// create a deployment
V1Deployment deploy1 = api.createNamespacedDeployment("default", body, null, null, null);
System.out.println("original deployment" + deploy1);
// json-patch a deployment
V1Deployment deploy2 =
PatchUtils.patch(
V1Deployment.class,
() ->
api.patchNamespacedDeploymentCall(
"hello-node",
"default",
new V1Patch(jsonPatchStr),
null,
null,
null, // field-manager is optional
null,
null),
V1Patch.PATCH_FORMAT_JSON_PATCH,
api.getApiClient());
System.out.println("json-patched deployment" + deploy2);
// strategic-merge-patch a deployment
V1Deployment deploy3 =
PatchUtils.patch(
V1Deployment.class,
() ->
api.patchNamespacedDeploymentCall(
"hello-node",
"default",
new V1Patch(strategicMergePatchStr),
null,
null,
null, // field-manager is optional
null,
null),
V1Patch.PATCH_FORMAT_STRATEGIC_MERGE_PATCH,
api.getApiClient());
System.out.println("strategic-merge-patched deployment" + deploy3);
// apply-yaml a deployment, server side apply is available by default after kubernetes v1.16
// or opt-in by turning on the feature gate for v1.14 or v1.15.
// https://kubernetes.io/docs/reference/using-api/api-concepts/#server-side-apply
V1Deployment deploy4 =
PatchUtils.patch(
V1Deployment.class,
() ->
api.patchNamespacedDeploymentCall(
"hello-node",
"default",
new V1Patch(applyYamlStr),
null,
null,
"example-field-manager", // field-manager is required for server-side apply
true,
null),
V1Patch.PATCH_FORMAT_APPLY_YAML,
api.getApiClient());
System.out.println("application/apply-patch+yaml deployment" + deploy4);
} catch (ApiException e) {
System.out.println(e.getResponseBody());
e.printStackTrace();
}
}
}