move examples from new to examples folder

Author: bruelea

docs/examples/example1-getting-started/README.md

@@ -0,0 +1,61 @@
+# Example 1: Getting Started
+
+# 0.1 Create a local cluster with nebox-installed
+
+1. use the 'create-kind' target from the Makefile to create a kind cluster and deploy NetBox on it
+```bash
+make create-kind
+```
+
+# 0.2 Manually Create a Prefix in NetBox
+
+Before prefixes and ip addresses can be claimed with the NetBox operator, a prefix has to be created in NetBox.
+
+1. Port-forward NetBox:
+```bash
+kubectl port-forward deploy/netbox 8080:8080
+```
+2. Open <http://localhost:8080> in your favorite browser and log in with the username `admin` and password `admin`
+3. Create a new prefix '3.0.0.64/26' with custom field 'environment: prod'
+
+# 1.1 Claim a Prefix
+
+In this example, we use a `.spec.parentPrefix` that we know in advance. This is useful if you already know exactly from which prefix you want to claim from.
+
+Navigate to 'docs/examples/example1-getting-started' to run the following commands.
+
+1. Inspect the spec of the sample prefix claim CR
+```bash
+cat prefixclaim-simple.yaml
+```
+2. Apply  the manifest defining the prefix claim
+```bash
+kubectl apply  -f prefixclaim-simple.yaml
+```
+3. Check that the prefix claim CR got a prefix assigned
+```bash
+kubectl get  pxc,px
+```
+
+![Example 1.1](prefixclaim-simple.drawio.svg)
+
+# 1.2 Dynamically Claim a Prefix with a Parent Prefix Selector
+
+In this example, we use a `.spec.parentPrefixSelector`, which is a list of selectors that tell NetBox Operator from which parent prefixes to claim our Prefix from.
+
+Navigate to 'docs/examples/example1-getting-started' to run the following commands.
+
+1. Inspect the spec of the sample prefix claim CR
+```bash
+cat prefixclaim-dynamic.yaml
+```
+2. Apply  the manifest defining the prefix claim
+```bash
+kubectl apply   -f prefixclaim-dynamic.yaml
+```
+3. Check that the prefix claim CR got a prefix addigned
+```bash
+kubectl get  pxc,px
+```
+
+![Example 1.2](prefixclaim-dynamic.drawio.svg)

docs/examples/example1-getting-started/dynamic_prefixclaim-large-font.drawio.svg

@@ -0,0 +1,45 @@
+# Example 2: Glue NetBox CRs to MetalLB CRs
+
+## Introduction
+
+So we have Prefixes represented as Kubernetes Resources. Now what can we do with this?
+
+We use kro.run to glue this to MetalLB IPAddressPools
+
+Navigate to 'docs/examples/example2-krm-glue' to run the following commands.
+
+0. Install kro and metallb with the installation script `docs/examples/new/example2-krm-glue/prepare-demo-env.sh`
+Then navigate to 'docs/examples/example2-krm-glue' to follow the steps below.
+
+1. Inspect the spec of the sample prefix claim CR
+```bash
+cat kro-rdg-poolfromnetbox.yaml
+```
+2. Apply the manifests to create a deployment with a service and a metallb-ip-address-pool-netbox to create a metalLB IPAddressPool from the prefix claimed from NetBox
+```bash
+kubectl apply -f kro-rdg-poolfromnetbox.yaml
+```
+3. Check if the prefixclaim CR and the metalLB ipaddresspool CR got created
+```bash
+kubectl get pxc,ipaddresspool -A
+```
+4. Inspect the spec of the sample prefix claim CR
+```bash
+cat sample-deployment.yaml
+```
+5. Apply the manifests to createa deployment with a service that gets a ip assigned from the metalLB pool created in the prevoius step
+```bash
+kubectl apply -f sample-deployment.yaml
+```
+6. check if the service got an external ip address assigned
+```bash
+kubectl get svc my-nginx -n nginx
+```
+7. try to connect to your service with the external ip
+```bash
+k exec curl -it -- sh
+curl <external-ip>
+```
+
+
+![Example 2](metallb-ipaddresspool-netbox.drawio.svg)

docs/examples/new/example1-getting-started/prefixclaim-dynamic.drawio.svg renamed to docs/examples/example1-getting-started/prefixclaim-dynamic.drawio.svg

@@ -1,7 +1,7 @@
 apiVersion: kro.run/v1alpha1
 kind: ResourceGraphDefinition
 metadata:
-  name: metallb-ip-address-pool--netbox
+  name: metallb-ip-address-pool-netbox
 spec:
   schema:
     apiVersion: v1alpha1
@@ -10,7 +10,6 @@ spec:
       name: string
       tenant: string
       prefixLength: string
-      preserveInNetbox: boolean
       parentPrefixSelector:
         tenant: string
         environment: string
@@ -29,7 +28,6 @@ spec:
           tenant: ${schema.spec.tenant}
           prefixLength: ${schema.spec.prefixLength}
           parentPrefixSelector: ${schema.spec.parentPrefixSelector}
-          preserveInNetbox: ${schema.spec.preserveInNetbox}
 
     - id: ipaddresspool
       template: