feat: Add function set-standard-labels

examples/set-stanrdard-labels-abstract/.expected/diff.patch

@@ -0,0 +1,24 @@
+diff --git a/resources.yaml b/resources.yaml
+index 1e641f7..bb4be90 100644
+--- a/resources.yaml
++++ b/resources.yaml
+@@ -2,6 +2,9 @@ apiVersion: v1
+ kind: ConfigMap
+ metadata:
+   name: the-map
++  labels:
++    color: orange
++    fruit: apple
+ data:
+   some-key: some-value
+ ---
+@@ -10,6 +13,9 @@ kind: MyResource
+ metadata:
+   name: the-service
+   namespace: the-namespace
++  labels:
++    color: orange
++    fruit: apple
+ spec:
+   selector:
+     labels:

examples/set-stanrdard-labels-abstract/Kptfile

@@ -0,0 +1,9 @@
+apiVersion: kpt.dev/v1
+kind: Kptfile
+metadata:
+  name: base-app
+  annotations:
+    config.kubernetes.io/local-config: "true"
+pipeline:
+  mutators:
+    - image: gcr.io/kpt-fn/set-standard-labels:unstable

examples/set-stanrdard-labels-abstract/README.md

@@ -0,0 +1,42 @@
+# set-standard-labels: Abstract Example
+
+### Overview
+
+This example demonstrates how to add kubernetes recommended labels to kpt Abstract (or Catalog) packages
+by running the [`set-starndard-labels`] function.
+
+### Fetch the example package
+
+Get the example package by running the following commands:
+
+```shell
+$ kpt pkg get https://github.com/GoogleContainerTools/kpt-functions-catalog.git/examples/set-stanrdard-labels-abstract
+```
+
+We use the following `Kptfile` to configure the function.
+
+```yaml
+apiVersion: kpt.dev/v1
+kind: Kptfile
+metadata:
+  name: base-app
+  annotations:
+    config.kubernetes.io/local-config: "true"
+pipeline:
+  mutators:
+    - image: gcr.io/kpt-fn/set-standard-labels:unstable
+```
+
+### Function invocation
+
+Invoke the function by running the following commands:
+
+```shell
+$ kpt fn render set-stanrdard-labels-abstract
+```
+
+### Expected result
+
+Check the deployment has label `app.kubernetes.io/name: base-app` added.
+
+[`set-labels`]: https://catalog.kpt.dev/set-standard-labels/v0.1/

examples/set-stanrdard-labels-abstract/resources.yaml

@@ -0,0 +1,14 @@
+
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: base-app
+  namespace: example
+spec:
+  selector:
+    matchLabels:
+      test: abstract-base-app
+  template:
+    metadata:
+      labels:
+        test: abstract-base-app

examples/set-stanrdard-labels-blueprint/.expected/diff.patch

@@ -0,0 +1,24 @@
+diff --git a/resources.yaml b/resources.yaml
+index 1e641f7..bb4be90 100644
+--- a/resources.yaml
++++ b/resources.yaml
+@@ -2,6 +2,9 @@ apiVersion: v1
+ kind: ConfigMap
+ metadata:
+   name: the-map
++  labels:
++    color: orange
++    fruit: apple
+ data:
+   some-key: some-value
+ ---
+@@ -10,6 +13,9 @@ kind: MyResource
+ metadata:
+   name: the-service
+   namespace: the-namespace
++  labels:
++    color: orange
++    fruit: apple
+ spec:
+   selector:
+     labels:

examples/set-stanrdard-labels-blueprint/Kptfile

@@ -0,0 +1,9 @@
+apiVersion: kpt.dev/v1
+kind: Kptfile
+metadata:
+  name: frontend
+  annotations:
+    config.kubernetes.io/local-config: "true"
+pipeline:
+  mutators:
+    - image: gcr.io/kpt-fn/set-standard-labels:unstable

examples/set-stanrdard-labels-blueprint/README.md

@@ -0,0 +1,39 @@
+# set-standard-labels: Blueprint Example
+
+### Overview
+
+This example demonstrates how to add kubernetes recommended labels to kpt Blueprint packages
+by running the [`set-starndard-labels`] function.
+
+### Fetch the example package
+
+Get the example package by running the following commands:
+
+```shell
+$ kpt pkg get https://github.com/GoogleContainerTools/kpt-functions-catalog.git/examples/set-stanrdard-labels-blueprint
+```
+
+We use the following `Kptfile` to configure the function.
+
+```yaml
+apiVersion: kpt.dev/v1
+kind: Kptfile
+metadata:
+  name: frontend
+  annotations:
+    config.kubernetes.io/local-config: "true"
+```
+
+### Function invocation
+
+Invoke the function by running the following commands:
+
+```shell
+$ kpt fn render set-stanrdard-labels-blueprint
+```
+
+### Expected result
+
+Check the deployment has label `app.kubernetes.io/name: frontend` added.
+
+[`set-labels`]: https://catalog.kpt.dev/set-standard-labels/v0.1/

examples/set-stanrdard-labels-blueprint/resources.yaml

@@ -0,0 +1,18 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: base-app
+  namespace: example
+  labels:
+    test: abstract-base-app
+    app.kubernetes.io/name: base-app
+spec:
+  selector:
+    matchLabels:
+      test: abstract-base-app
+      app.kubernetes.io/name: base-app
+  template:
+    metadata:
+      labels:
+        test: abstract-base-app
+        app.kubernetes.io/name: base-app

examples/set-stanrdard-labels-deployment/.expected/diff.patch

@@ -0,0 +1,24 @@
+diff --git a/resources.yaml b/resources.yaml
+index 1e641f7..bb4be90 100644
+--- a/resources.yaml
++++ b/resources.yaml
+@@ -2,6 +2,9 @@ apiVersion: v1
+ kind: ConfigMap
+ metadata:
+   name: the-map
++  labels:
++    color: orange
++    fruit: apple
+ data:
+   some-key: some-value
+ ---
+@@ -10,6 +13,9 @@ kind: MyResource
+ metadata:
+   name: the-service
+   namespace: the-namespace
++  labels:
++    color: orange
++    fruit: apple
+ spec:
+   selector:
+     labels:

examples/set-stanrdard-labels-deployment/Kptfile

@@ -0,0 +1,9 @@
+apiVersion: kpt.dev/v1
+kind: Kptfile
+metadata:
+  name: frontend-dev
+  annotations:
+    config.kubernetes.io/local-config: "true"
+pipeline:
+  mutators:
+    - image: gcr.io/kpt-fn/set-standard-labels:unstable

examples/set-stanrdard-labels-deployment/README.md

@@ -0,0 +1,40 @@
+# set-standard-labels: Deployment Example
+
+### Overview
+
+This example demonstrates how to add kubernetes recommended labels to kpt Deployment packages
+by running the [`set-starndard-labels`] function.
+
+### Fetch the example package
+
+Get the example package by running the following commands:
+
+```shell
+$ kpt pkg get https://github.com/GoogleContainerTools/kpt-functions-catalog.git/examples/set-stanrdard-labels-deployment
+```
+
+We use the following `Kptfile` to configure the function.
+
+```yaml
+apiVersion: kpt.dev/v1
+kind: Kptfile
+metadata:
+  name: frontend
+  annotations:
+    config.kubernetes.io/local-config: "true"
+```
+
+### Function invocation
+
+Invoke the function by running the following commands:
+
+```shell
+$ kpt fn render set-stanrdard-labels-deployment
+```
+
+### Expected result
+
+Check the deployment has label `app.kubernetes.io/instance: frontend-dev` added, and the
+ existing upstream label `app.kubernetes.io/name: frontend` is preserved.
+
+[`set-labels`]: https://catalog.kpt.dev/set-standard-labels/v0.1/

examples/set-stanrdard-labels-deployment/resources.yaml

@@ -0,0 +1,27 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: kptfile.kpt.dev
+  annotations:
+    config.kubernetes.io/local-config: "true"
+data:
+  name: frontend-dev
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: base-app
+  namespace: example
+  labels:
+    test: abstract-base-app
+    app.kubernetes.io/name: frontend
+spec:
+  selector:
+    matchLabels:
+      test: abstract-base-app
+      app.kubernetes.io/name: frontend
+  template:
+    metadata:
+      labels:
+        test: abstract-base-app
+        app.kubernetes.io/name: frontend

examples/set-stanrdard-labels-manual-force/.expected/diff.patch

@@ -0,0 +1,24 @@
+diff --git a/resources.yaml b/resources.yaml
+index 1e641f7..bb4be90 100644
+--- a/resources.yaml
++++ b/resources.yaml
+@@ -2,6 +2,9 @@ apiVersion: v1
+ kind: ConfigMap
+ metadata:
+   name: the-map
++  labels:
++    color: orange
++    fruit: apple
+ data:
+   some-key: some-value
+ ---
+@@ -10,6 +13,9 @@ kind: MyResource
+ metadata:
+   name: the-service
+   namespace: the-namespace
++  labels:
++    color: orange
++    fruit: apple
+ spec:
+   selector:
+     labels:

examples/set-stanrdard-labels-manual-force/Kptfile

@@ -0,0 +1,11 @@
+apiVersion: kpt.dev/v1
+kind: Kptfile
+metadata:
+  name: custom-frontend
+  annotations:
+    config.kubernetes.io/local-config: "true"
+pipeline:
+  mutators:
+    - image: gcr.io/kpt-fn/set-standard-labels:unstable
+      configMap:
+        isDeployment: false

examples/set-stanrdard-labels-manual-force/README.md

@@ -0,0 +1,46 @@
+# set-standard-labels: Manual Force Example
+
+### Overview
+
+This example demonstrates how to add kubernetes recommended labels to a kpt package via manually 
+forcing the package (with package-context.yaml) to be treated as a blueprint package. 
+by running the [`set-starndard-labels`] function.
+
+### Fetch the example package
+
+Get the example package by running the following commands:
+
+```shell
+$ kpt pkg get https://github.com/GoogleContainerTools/kpt-functions-catalog.git/examples/set-stanrdard-labels-manual-force
+```
+
+We use the following `Kptfile` to configure the function.
+
+```yaml
+apiVersion: kpt.dev/v1
+kind: Kptfile
+metadata:
+  name: custom-frontend
+  annotations:
+    config.kubernetes.io/local-config: "true"
+pipeline:
+  mutators:
+    - image: gcr.io/kpt-fn/set-standard-labels:unstable
+      configMap:
+        isDeployment: false
+```
+
+### Function invocation
+
+Invoke the function by running the following commands:
+
+```shell
+$ kpt fn render set-stanrdard-labels-manual-force
+```
+
+### Expected result
+
+Check the label is changed from `app.kubernetes.io/name: frontend` to 
+`app.kubernetes.io/name: custom-frontend`.
+
+[`set-labels`]: https://catalog.kpt.dev/set-standard-labels/v0.1/