Add page on airfaas, remove page on federated gateway

Signed-off-by: Alex Ellis (OpenFaaS Ltd) <[email protected]>

Author: alexellis

docs/deployment/pro.md

@@ -120,7 +120,7 @@ Then add the Helm chart repo, update it and deploy the chart, running `helm repo
 ```sh
 helm repo update
 
-helm upgrade openfaas \
+helm upgrade --install openfaas \
   --install openfaas/openfaas \
   --namespace openfaas \
   -f ./values-custom.yaml

docs/openfaas-pro/airgap.md

@@ -0,0 +1,72 @@
+## Airgapped OpenFaaS
+
+OpenFaaS Standard and OpenFaaS for Enterprises are licensed for use within an airgap when purchased on an annual basis via invoice.
+
+You can use your own choice of tooling to mirror images and bundle the Helm chart(s) required for your installations, or you can use our own purpose-built airfaas tool.
+
+### Mirror OpenFaaS images into your own registry
+
+If your organisation has a policy of mirroring all consumed images from vendors into a private registry, then `airfaas mirror` can help you with this, even if you don't install OpenFaaS into an airgapped environment.
+
+```bash
+faas-cli plugin get airfaas
+```
+
+Mirror all images for the given chart/index to a custom registry:
+
+```bash
+airfaas download images \
+        openfaas/openfaas \
+        --registry-prefix ttl.sh
+```
+
+Mirror the Kafka-connector's images:
+
+```bash
+airfaas download images \
+        openfaas/kafka-connector \
+        --registry-prefix ttl.sh
+```
+
+The `--url` flag can be used to specify a different Helm chart repository. The only requirement is that images are stored in the same format as OpenFaaS: i.e. `image:` or `componentName.image:`.
+
+After the mirroring is complete, you'll receive output in the format of a values.yaml file, which you can add to your `helm upgrade --install` command.
+
+```bash
+$ faas-cli airfaas mirror openfaas/openfaas --to https://aws_account_id.dkr.ecr.us-west-2.amazonaws.com/openfaas
+Mirrored 18 images in 3m7.242s
+```
+
+Then copy the below to i.e. `values-mirror.yaml`:
+
+```yaml
+gatewayPro:
+  image: aws_account_id.dkr.ecr.us-west-2.amazonaws.com/openfaas/openfaasltd/gateway:0.4.27
+alertmanager:
+  image: aws_account_id.dkr.ecr.us-west-2.amazonaws.com/openfaas/prom/alertmanager:v0.27.0
+autoscaler:
+  image: aws_account_id.dkr.ecr.us-west-2.amazonaws.com/openfaas/openfaasltd/autoscaler:0.3.6
+```
+
+Your final OpenFaaS Pro installation may look something like, where you use the standard `values-pro.yaml` file, your own settings in `values-staging.yaml`, then finally the mirrored images overlaid over that in `values-mirror.yaml`:
+
+```bash
+helm upgrade --install openfaas \
+  --install openfaas/openfaas \
+  --namespace openfaas \
+  -f values-pro.yaml \
+  -f values-staging.yaml \
+  -f values-mirror.yaml
+```
+
+### Perform an offline installation
+
+Airfaas can perform an offline installation of OpenFaaS into an airgapped environment. It will bundle the Helm chart(s) and images required for the installation, then restore the images into an offline registry, and install OpenFaaS using the Helm chart(s) from the local filesystem.
+
+![Conceptual download process](https://www.openfaas.com/images/2024-04-airgap/download.png)
+> The download process
+
+![Conceptual upload process](https://www.openfaas.com/images/2024-04-airgap/restore.png)
+> The upload / installation process
+
+Follow the instructions in: [Deploy airgapped Serverless Functions with OpenFaaS](https://www.openfaas.com/blog/airgap-serverless-functions/)

docs/openfaas-pro/introduction.md

@@ -18,7 +18,7 @@ Efficiency and redundancy:
 * [Scale idle functions to zero](/openfaas-pro/scale-to-zero) to save on compute costs, increase efficiency and lower your threat profile
 * [Retry failed invocations for functions](/openfaas-pro/retries) to handle issues with downstream APIs and back-pressure on concurrency-limited functions
 * CPU and RAM usage metrics for every function to measure usage and fine-tune limits
-* GitOps compatibility with the Function CustomResource, with Helm, ArgoCD and FluxCD.
+* [GitOps compatibility with the Function CustomResource, with Helm, ArgoCD and FluxCD](/openfaas-pro/function-crd)
 
 [![Scaling that works for various types of functions](https://pbs.twimg.com/media/FJ9EBVdWQAM9DeW?format=jpg&name=medium)](/architecture/autoscaling/)
 > Scaling that works for various types of functions
@@ -38,7 +38,8 @@ The OpenFaaS dashboard integrates with CPU & RAM usage metrics, and container lo
 Event-driven programming and triggers:
 
 * [Trigger functions via Kafka](/openfaas-pro/kafka-events) for event-driven functions and to integrate with your existing systems
-* [Trigger functions from AWS SQS](/openfaas-pro/sqs-events) to integrate with events from AWS.
+* [Trigger functions from AWS SQS](/openfaas-pro/sqs-events) to integrate with events from AWS services via a managed queue.
+* [Trigger functions from AWS SNS](/openfaas-pro/sns-events) to integrate with events from AWS managed services via pub/sub.
 
 ### Workload tuning
 
@@ -50,14 +51,15 @@ To avoid errors when scaling up or down, you may need to tune your function's co
 * Custom TerminationGracePeriod for draining work for long running functions
 * Custom support for probing Istio endpoints during scale from zero
 
-Read more: [OpenFaaS workloads](https://docs.openfaas.com/reference/workloads/) and [Custom Profiles](https://docs.openfaas.com/reference/profiles/#use-an-alternative-runtimeclass)
+Read more: [OpenFaaS workloads](/reference/workloads/) and [OpenFaaS Profiles](/reference/profiles/#use-an-alternative-runtimeclass)
 
 ### Enterprise security
 
-* Identity and Access Management (IAM)
-* Single Sign On with OpenID Connect (OIDC)
+* [Airgapped/offline installations and image mirroring](/openfaas-pro/airgap)
+* [Identity and Access Management (IAM)](/openfaas-pro/iam/overview)
+* [Single Sign On with OpenID Connect (OIDC)](/openfaas-pro/sso/overview)
 
-[Learn more about IAM for OpenFaaS](https://docs.openfaas.com/openfaas-pro/iam/overview/)
+[Learn more about IAM for OpenFaaS](/openfaas-pro/iam/overview)
 
 ### Platform building features
 
@@ -112,10 +114,9 @@ Recently released:
 * GPU scheduling support for functions via Profiles i.e. `nvidia.com/gpu: 1` (Mar 2024)
 
 Upcoming:
-
+* Built-in function authentication with IAM for OpenFaaS (in preview)
 * Conversion to structured/JSON logging of OpenFaaS Pro components (ongoing - 80% complete)
 * Dynamic, dedicated Async queues for each function, including queued-based scaling (R&D phase)
-* Function authentication with IAM for OpenFaaS
 * Go SDK for the Function Builder API
 * Additional event triggers i.e. AMQP event trigger for RabbitMQ and Azure Service Bus and Google PubSub (added upon request)
 
@@ -127,14 +128,12 @@ If you're already a customer, we welcome suggestions for the roadmap in [the Cus
 
 !!! info "Do we need the Community Edition or Pro?"
 
-    OpenFaaS Community Edition (CE) is meant for open-source developers and initial exploration of functions, OpenFaaS Pro is meant for production.
+    OpenFaaS Community Edition (CE) is licensed for open-source developers and initial exploration of functions, OpenFaaS Pro is licensed for production.
 
 OpenFaaS Pro is a distribution of OpenFaaS with additional features and configurations that we believe customers need to operate a product or service in production.
 
 As we tune OpenFaaS Pro for our existing customers, we improve it for everyone else at the same time - writing articles, tuning configuration and adding key features.
 
-We see it as the start of a two-way relationship and an opportunity to collaborate directly with our team.
-
 **Support**
 
 All the items below are included in the standard self-service/license-only package, unless specifically stated as requiring an Enterprise Service Agreement.

mkdocs.yml

@@ -161,7 +161,8 @@ nav:
       - Postgres events: ./openfaas-pro/postgres-events.md
       - AWS SQS events: ./openfaas-pro/sqs-events.md
       - AWS SNS events: ./openfaas-pro/sns-events.md
-      - Federated Gateway: ./openfaas-pro/federated-gateway.md
+      # - Federated Gateway: ./openfaas-pro/federated-gateway.md
+      - Airgapped installation: ./openfaas-pro/airgap.md
       - Function Builder API: ./openfaas-pro/builder.md
       - Billing metrics: ./openfaas-pro/billing-metrics.md
       - Grafana dashboards: ./openfaas-pro/grafana-dashboards.md