Layer7 Operator

The Layer7 Operator, built using the Operator SDK covers all aspects of deploying, maintaining and upgrading Layer7 API Gateways in Kubernetes. The Layer7 Operator is exclusive to Kubernetes and utilizes the Container Gateway with specific emphasis on running in Ephemeral mode (without an external MySQL policy database).

Prerequisites

• Kubernetes
• Gateway v10/11.x License (can be requested via support)
• cert-manager if using cluster install

Index

• Getting Started
• Gateway
• Repository
• L7Portal
• L7Api
• Additional Examples

The Layer7 Operator manages the following Custom Resources

• Gateway
  • Represents the Layer7 API Gateway
• Repository
  • Represents a Git or File repository
• L7Portal (alpha)
  • Integrate a Layer7 Developer Portal
• L7Api (alpha)
  • Represents a Layer7 API

Upgrading to v1.1.1 and beyond

The labels for the cluster-wide deployment have been updated, you will receive an error about this when you attempt to upgrade to v1.1.1 from v1.1.0. If you are using the Operator in namespaced mode then you will not receive this error and can upgrade as normal.

If you are using the Layer7 Operator for the first time, we recommend using the latest version otherwise you can either force the upgrade or delete the Operator deployment prior to upgrading.

kubectl apply -f https://github.com/CAAPIM/layer7-operator/releases/download/v1.2.1/cw-bundle.yaml --force

Compatibility Matrix

The Layer7 Operator graphman client is strongly typed, meaning changes to the Graphman Schema can cause breaking changes between versions of the Operator/Gateways.

Operator Version	Gateway Versions
v1.2.1	11.1.2
v1.2.0	11.1.2
v1.1.1	11.1.1
v1.1.0	11.1.1
v1.0.7	11.1.1
v1.0.6	11.1.00
v1.0.5	10.1.00_CR4, 11.0.00_CR2
v1.0.4	10.1.00_CR3, 11.0.00_CR1

The guides in this documentation assume that you have access to a Kubernetes Cluster. These examples have a Kind (Kubernetes in Docker) option if you have access to a Docker Engine.