add examples

Signed-off-by: Steven Borrelli <[email protected]>

Author: stevendborrelli

examples/conditional-resources/README.md

@@ -0,0 +1,41 @@
+# Conditional Rendering of Individual Resources
+
+In this example, we show how each resource in a pipeline step can
+be individually rendered based on a condition. We will have a blue and a
+green deployment that the user can activate:
+
+```yaml
+apiVersion: nop.example.org/v1alpha1
+kind: XNopConditional
+metadata:
+  name: test-resource
+spec:
+  env: dev
+  render: true
+  deployment:
+    blue: true
+    green: false
+```
+
+In our Composition both the `blue-resource` and the `green-resource` have a
+`condition` that determines if they will be run.
+
+```yaml
+    resources:
+         - name: blue-resource
+           condition: observed.composite.resource.spec.deployment.blue == true
+           base:
+            apiVersion: nop.crossplane.io/v1alpha1
+            kind: NopResource
+            spec:
+              forProvider:
+```
+
+## Running this example
+
+- Install Crossplane version 1.14 or newer. See <https://docs.crossplane.io/v1.14/software/install/>
+- Install the nop provider in `kubectl apply -f provider.yaml`
+- Install the XRD & Composition in `kubectl apply -f definition.yaml -f composition.yaml`
+- Install the Function `kubectl apply -f functions.yaml`
+
+Finally install the xr: `kubectl apply -f xr`

examples/conditional-resources/composition.yaml

@@ -0,0 +1,69 @@
+---
+apiVersion: apiextensions.crossplane.io/v1
+kind: Composition
+metadata:
+  name: xnopconditionals.nop.example.org
+spec:
+  compositeTypeRef:
+    apiVersion: nop.example.org/v1alpha1
+    kind: XNopConditional
+  mode: Pipeline
+  pipeline:
+  - step: conditional-patch-and-transform
+    functionRef:
+      name: function-conditional-patch-and-transform
+    input:
+      apiVersion: conditional-pt.fn.crossplane.io/v1beta1
+      kind: Resources
+      resources:
+         - name: blue-resource
+           condition: observed.composite.resource.spec.deployment.blue == true
+           base:
+            apiVersion: nop.crossplane.io/v1alpha1
+            kind: NopResource
+            spec:
+              forProvider:
+                fields:
+                  integerField: 42
+                  stringField: "blue"
+                  objectField:
+                    stringField: "blueObject"
+                  arrayField:
+                  - stringField: "blueArray"
+                conditionAfter:
+                - time: 5s
+                  conditionType: Ready
+                  conditionStatus: "True"
+                connectionDetails:
+                - name: username
+                  value: fakeuser
+                - name: password
+                  value: verysecurepassword
+                - name: endpoint
+                  value: 127.0.0.1
+         - name: green-resource
+           condition: observed.composite.resource.spec.deployment.green == true
+           base:
+            apiVersion: nop.crossplane.io/v1alpha1
+            kind: NopResource
+            spec:
+              forProvider:
+                fields:
+                  integerField: 42
+                  stringField: "green"
+                  objectField:
+                    stringField: "greenObject"
+                  arrayField:
+                  - stringField: "greenArray"
+                conditionAfter:
+                - time: 5s
+                  conditionType: Ready
+                  conditionStatus: "True"
+                connectionDetails:
+                - name: username
+                  value: fakeuser
+                - name: password
+                  value: verysecurepassword
+                - name: endpoint
+                  value: 127.0.0.1
+

examples/conditional-resources/definition.yaml

@@ -0,0 +1,33 @@
+apiVersion: apiextensions.crossplane.io/v1
+kind: CompositeResourceDefinition
+metadata:
+  name: xnopconditionals.nop.example.org
+spec:
+  group: nop.example.org
+  names:
+    kind: XNopConditional
+    plural: xnopconditionals
+  versions:
+  - name: v1alpha1
+    referenceable: true
+    served: true
+    schema:
+      openAPIV3Schema:
+        type: object
+        properties:
+          spec:
+            type: object
+            properties:
+              env:
+                type: string
+              render:
+                type: boolean
+              deployment:
+                type: object
+                properties:
+                  blue:
+                    description: Activate the blue resource
+                    type: boolean
+                  green:
+                    description: Activate the green resource
+                    type: boolean

examples/conditional-resources/functions.yaml

@@ -0,0 +1,7 @@
+apiVersion: pkg.crossplane.io/v1beta1
+kind: Function
+metadata:
+  name: function-conditional-patch-and-transform
+spec:
+  package: xpkg.upbound.io/borrelli-org/function-conditional-patch-and-transform:v0.3.0
+  packagePullPolicy: Always

examples/conditional-resources/provider.yaml

@@ -0,0 +1,6 @@
+apiVersion: pkg.crossplane.io/v1
+kind: Provider
+metadata:
+  name: provider-nop
+spec:
+  package: xpkg.upbound.io/crossplane-contrib/provider-nop:v0.2.0

examples/conditional-resources/xr.yaml

@@ -0,0 +1,10 @@
+apiVersion: nop.example.org/v1alpha1
+kind: XNopConditional
+metadata:
+  name: test-resource
+spec:
+  env: dev
+  render: true
+  deployment:
+    blue: true
+    green: false