add simple installation

Signed-off-by: craig <[email protected]>

rh-pre-commit.version: 2.2.0
rh-pre-commit.check-secrets: ENABLED

more detailed installation guide and examples

rh-pre-commit.version: 2.2.0
rh-pre-commit.check-secrets: ENABLED

config/install/configure/aws/kustomization.yaml

@@ -4,7 +4,8 @@ kind: Kustomization
 ## NOTE YOU NEED TO CREATE A aws-provider-credentials.env file first!
 
 resources:
-  - ../standard
+  - https://github.com/Kuadrant/kuadrant-operator//config/install/standard
+  # - https://github.com/Kuadrant/kuadrant-operator//config/install/openshift # use this one if installing on OCP
   - cluster-issuer.yaml
 
 generatorOptions:
@@ -17,7 +18,7 @@ secretGenerator:
   - name: aws-provider-credentials
     namespace: cert-manager
     envs:
-      - aws-credentials.env
+      - aws-credentials.env # you will need to setup this file locally
     type: 'kuadrant.io/aws'
   - name: aws-provider-credentials
     namespace: gateway-system

config/install/configure/redis-storage/kustomization.yaml

@@ -14,4 +14,4 @@ secretGenerator:
     namespace: kuadrant-system
     envs:
       - redis-credentials.env
-    type: 'kuadrant.io/aws'
+    type: 'kuadrant.io/redis'

config/install/full-example-aws/configure/aws-credentials.env.sample

@@ -0,0 +1,5 @@
+# If using this you will need to rename the file and remove the .sample suffix and remove this comment
+
+KUADRANT_AWS_ACCESS_KEY_ID=xxx
+KUADRANT_AWS_SECRET_ACCESS_KEY=xxx
+KUADRANT_AWS_REGION=eu-west-1

config/install/full-example-aws/configure/cluster-issuer.yaml

@@ -0,0 +1,20 @@
+# example lets-encrypt cluster issuer that will work with the credentials we will add
+apiVersion: cert-manager.io/v1
+kind: ClusterIssuer
+metadata:
+  name: lets-encrypt-aws
+spec:
+  acme:
+    privateKeySecretRef:
+      name: le-secret
+    server: https://acme-v02.api.letsencrypt.org/directory
+    solvers:
+      - dns01:
+          route53:
+            accessKeyIDSecretRef:
+              key: AWS_ACCESS_KEY_ID
+              name: aws-provider-credentials #notice this matches the name of the secret we created.
+            region: us-east-1 #override if needed
+            secretAccessKeySecretRef:
+              key: AWS_SECRET_ACCESS_KEY
+              name: aws-provider-credentials

config/install/full-example-aws/configure/kustomization.yaml

@@ -0,0 +1,29 @@
+apiVersion: kustomize.config.k8s.io/v1beta1
+kind: Kustomization
+resources:
+  - https://github.com/Kuadrant/kuadrant-operator//config/install/configure/standard?ref=v1.0.1 #change this version as needed (see https://github.com/Kuadrant/kuadrant-operator/releases)
+  - cluster-issuer.yaml #(comment if you dont want to use it. The issuer yaml is defined below).
+  - limitador.yaml
+
+generatorOptions:
+  disableNameSuffixHash: true
+  labels:
+    app.kubernetes.io/part-of: kuadrant
+    app.kubernetes.io/managed-by: kustomize
+
+secretGenerator:
+  - name: aws-provider-credentials
+    namespace: cert-manager # assumes cert-manager namespace exists.
+    envs:
+      - aws-credentials.env # notice this matches the .env file above. You will need to setup this file locally
+    type: 'kuadrant.io/aws'
+  - name: aws-provider-credentials
+    namespace: gateway-system # this is the namespace where your gateway will be provisioned
+    envs:
+      - aws-credentials.env #notice this matches the .env file above. you need to set up this file locally first.
+    type: 'kuadrant.io/aws'
+  - name: redis-credentials
+    namespace: kuadrant-system
+    envs:
+      - redis-credentials.env
+    type: 'kuadrant.io/redis'

config/install/full-example-aws/configure/limitador.yaml

@@ -0,0 +1,11 @@
+apiVersion: limitador.kuadrant.io/v1alpha1
+kind: Limitador
+metadata:
+  name: limitador
+  namespace: kuadrant-system
+spec:
+  storage:
+    redis:
+      configSecretRef:
+        name: redis-credentials
+

config/install/full-example-aws/configure/redis-credentials.env.sample

@@ -0,0 +1,3 @@
+# If using this you will need to rename the file and remove the .sample suffix and remove this comment
+
+URL=redis://xxxx

config/install/full-example-aws/install/kustomization.yaml

@@ -0,0 +1,17 @@
+apiVersion: kustomize.config.k8s.io/v1beta1
+kind: Kustomization
+resources:
+  - https://github.com/Kuadrant/kuadrant-operator//config/install/standard?ref=v1.0.1 #change this version as needed (see https://github.com/Kuadrant/kuadrant-operator/releases)
+  #- https://github.com/Kuadrant/kuadrant-operator//config/install/openshift?ref=v1.0.1 #use if targeting an OCP cluster. Change this version as needed (see https://github.com/Kuadrant/kuadrant-operator/releases).
+
+patches: # remove the subscription patch if you are installing a development version. It will then use the "preview" channel
+  - patch: |-
+      apiVersion: operators.coreos.com/v1alpha1
+      kind: Subscription
+      metadata:
+        name: kuadrant
+      spec:
+        source: kuadrant-operator-catalog
+        sourceNamespace: kuadrant-system
+        name: kuadrant-operator
+        channel: 'stable' #set to preview if not using a release (for example if using main)

config/install/no-gateway-provider/kustomization.yaml

@@ -0,0 +1,9 @@
+apiVersion: kustomize.config.k8s.io/v1beta1
+kind: Kustomization
+
+# note by default this will install the version of kuadrant you checkout from v1 onwards
+# if you want to install a different released version you can use the patch options below.
+# If you want to install the latest development tag, remove the subscription patch
+resources:
+  - https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.1.0/standard-install.yaml
+  - ../../deploy/olm

config/install/standard/kustomization.yaml

@@ -2,15 +2,9 @@ apiVersion: kustomize.config.k8s.io/v1beta1
 kind: Kustomization
 
 # note by default this will install the version of kuadrant you checkout from v1 onwards
-# if you want to install a different version you can use the patch option below
+# if you want to install a different released version you can use the patch options below.
+# If you want to install the latest development tag, remove the subscription patch
 resources:
   - https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.1.0/standard-install.yaml
   - sail-operator.yaml
   - ../../deploy/olm
-# patches:
-#   - target:
-#       group: operators.coreos.com
-#       version: v1alpha1
-#       kind: CatalogSource
-#       name: kuadrant-operator-catalog
-#     path: kuadrant-version.yaml