feat: Contribute an NGINX Gateway Fabric example and article

README.md

@@ -18,6 +18,7 @@ The following examples are provided:
 | [Preview Stack Testing](examples/preview-testing) | Rollout which launches an experiment that tests a preview stack (which receives no production traffic) |
 | [Canary with istio (1)](examples/istio) | Rollout which uses host-level traffic splitting during update |
 | [Canary with istio (2)](examples/istio-subset) | Rollout which uses subset-level traffic splitting during update |
+| [Canary Analysis with NGINX Gateway Fabric](examples/nginx-gateway-fabric) | Rollout which performs canary analysis as part of the update. Uses the prometheus metric provider, and requires the [Argo Rollouts Gateway API Plugin](https://rollouts-plugin-trafficrouter-gatewayapi.readthedocs.io/en/latest/) |
 
 Before running an example:
 

examples/nginx-gateway-fabric/README.md

@@ -0,0 +1,3 @@
+# Argo Rollouts Example for NGINX Gateway Fabric
+
+This directory contains a [walkthrough article](ARTICLE.md) and example manifests to perform a Canary rollout (with Analysis) of the demo application using NGINX Gateway Fabric.

examples/nginx-gateway-fabric/analysis-success-rate.yaml

@@ -0,0 +1,29 @@
+apiVersion: argoproj.io/v1alpha1
+kind: AnalysisTemplate
+metadata:
+  name: success-rate
+spec:
+  args:
+  - name: namespace
+  - name: service-name
+  - name: service-port
+  metrics:
+  - name: success-rate
+    interval: 1m
+    successCondition: len(result) == 0 || result[0] >= 0.99
+    failureLimit: 0
+    provider:
+      prometheus:
+        address: http://prometheus-server.prometheus
+        query: >+
+          sum(rate(
+            nginx_gateway_fabric_upstream_server_responses{upstream="{{args.namespace}}_{{args.service-name}}_{{args.service-port}}", 
+            code!~"[4-5].*"}[1m])
+          ) by (upstream)
+          /
+          sum(rate(
+            nginx_gateway_fabric_upstream_server_responses{upstream="{{args.namespace}}_{{args.service-name}}_{{args.service-port}}"}[1m])
+          ) by (upstream)
+          unless sum(rate(
+            nginx_gateway_fabric_upstream_server_responses{upstream="{{args.namespace}}_{{args.service-name}}_{{args.service-port}}"}[1m])
+          ) by (upstream) == 0

examples/nginx-gateway-fabric/canary-service.yaml

@@ -0,0 +1,12 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: rollouts-demo-canary-service
+spec:
+  ports:
+    - port: 8080
+      targetPort: 8080
+      protocol: TCP
+      name: http
+  selector:
+    app: rollouts-demo

examples/nginx-gateway-fabric/gateway.yaml

@@ -0,0 +1,10 @@
+apiVersion: gateway.networking.k8s.io/v1beta1
+kind: Gateway
+metadata:
+  name: rollouts-demo-gateway
+spec:
+  gatewayClassName: nginx
+  listeners:
+    - protocol: HTTP
+      name: web
+      port: 80

examples/nginx-gateway-fabric/httproute.yaml

@@ -0,0 +1,18 @@
+---
+apiVersion: gateway.networking.k8s.io/v1
+kind: HTTPRoute
+metadata:
+  name: rollouts-demo-httproute
+spec:
+  parentRefs:
+  - name: rollouts-demo-gateway
+  rules:
+  - matches:
+    - path:
+        type: PathPrefix
+        value: /
+    backendRefs:
+    - name: rollouts-demo-stable-service
+      port: 8080
+    - name: rollouts-demo-canary-service
+      port: 8080

examples/nginx-gateway-fabric/rollout.yaml

@@ -0,0 +1,57 @@
+apiVersion: argoproj.io/v1alpha1
+kind: Rollout
+metadata:
+  name: rollouts-demo
+spec:
+  replicas: 5
+  revisionHistoryLimit: 1
+  selector:
+    matchLabels:
+      app: rollouts-demo
+  strategy:
+    canary:
+      analysis:
+        templates:
+          - templateName: success-rate
+        args:
+          - name: namespace
+            value: default
+          - name: service-name
+            value: rollouts-demo-canary-service
+          - name: service-port
+            value: "8080"
+      canaryService: rollouts-demo-canary-service # our created canary service
+      stableService: rollouts-demo-stable-service # our created stable service
+      trafficRouting:
+        plugins:
+          argoproj-labs/gatewayAPI:
+            httpRoute: rollouts-demo-httproute # our created httproute
+            namespace: default # namespace where this rollout resides
+      steps:
+        - setWeight: 30
+        - pause: {}
+        - setWeight: 40
+        - pause:
+            duration: 1m
+        - setWeight: 60
+        - pause:
+            duration: 1m
+        - setWeight: 80
+        - pause:
+            duration: 1m
+  template:
+    metadata:
+      labels:
+        app: rollouts-demo
+    spec:
+      containers:
+        - name: rollouts-demo
+          image: argoproj/rollouts-demo:blue
+          ports:
+            - name: http
+              containerPort: 8080
+              protocol: TCP
+          resources:
+            requests:
+              memory: 32Mi
+              cpu: 5m

examples/nginx-gateway-fabric/stable-service.yaml

@@ -0,0 +1,12 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: rollouts-demo-stable-service
+spec:
+  ports:
+    - port: 8080
+      targetPort: 8080
+      protocol: TCP
+      name: http
+  selector:
+    app: rollouts-demo