This document lists the Kubernetes resources and custom resources that are used by Apigee
installations. Users installing Apigee should have role-based access control (RBAC) for these
resources, in most cases `Create`, `Delete`, `Update`, and
`Patch`.

## Third party resources

### Cert Manager

| CRD |
|---|
| `ClusterIssuer` |
| `Issuer` |
| `Certificate` |

## Kubernetes and variants

### Kubernetes

| Resource |
|---|
| `StorageClass` (Optional, if the default StorageClass is not used. For information on changing the default and creating a custom storage class, see [StorageClass configuration](https://docs.cloud.google.com/apigee/docs/hybrid/latest/cassandra-config).) |
| `PriorityClass` (Required for `apigeectl` only) |
| `Namespace` |
| `ServiceAccount` |
| `ClusterRole` |
| `ClusterRoleBinding` |
| `Role` |
| `RoleBinding` |
| `CustomResourceDefinition` |
| `MutatingWebhookConfiguration` |
| `ValidatingWebhookConfiguration` |
| `Secret` |
| `ConfigMap` |
| `Deployment` |
| `Job` |
| `CronJob` |

### OpenShift

| Resource |
|---|
| `SecurityContextConstraints` |

## Apigee resources

### Apigee

| CRD | Definition |
|---|---|
| `ApigeeDatastore` | `ApigeeDatastore` manages Cassandra StatefulSet and ensures the Apigee hybrid setup has a reliable Cassandra database to store all its configurations, keys, and tokens. The `ApigeeDatastore` is not associated with any of the organizations and environments. |
| `ApigeeDeployment` | `ApigeeDeployment` is a CRD in Apigee hybrid used to configure and manage the Apigee runtime components (like Message Processor, Router) deployed within a Kubernetes cluster. It acts as a blueprint defining which components to deploy, their configurations, and desired state, making it a central tool for managing Apigee in a hybrid setup. |
| `ApigeeOrganization` | `ApigeeOrganization` is a CRD used in Apigee hybrid to represent an Apigee organization within the hybrid runtime plane. This CRD allows you to create and manage Apigee organizations directly within your Kubernetes cluster, enabling you to configure and control various aspects of your Apigee environment, including API proxies, products, developers, and other organizational settings. The `ApigeeOrganization` resources can support multiple environments within an organization (org-wide scope). Starting in versions 1.15.10, 1.16.13, and 1.17.3, the `redisRef` field of `ApigeeOrganization` is deprecated. Use the `valkeyRef` field instead. This field names an `ApigeeValkey` resource. The runtime uses `valkeyRef` only when the Apigee operator runs with `ao.args.valkeyBackend` set to `true` and the named `ApigeeValkey` resource has the state `running`. Otherwise, it uses `redisRef`. See `ao.args.valkeyBackend` in the configuration property reference for [v1.15](https://docs.cloud.google.com/apigee/docs/hybrid/v1.15/config-prop-ref.md.txt#ao-args-valkeybackend), [v1.16](https://docs.cloud.google.com/apigee/docs/hybrid/v1.16/config-prop-ref.md.txt#ao-args-valkeybackend), and [v1.17](https://docs.cloud.google.com/apigee/docs/hybrid/v1.17/config-prop-ref.md.txt#ao-args-valkeybackend). |
| `ApigeeEnvironment` | `ApigeeEnvironment` is a CRD used in Apigee hybrid to represent an Apigee environment within a Kubernetes cluster. It enables the creation and management of Apigee environments directly within the cluster, allowing for control over environment-specific settings, deployments, and configurations. This facilitates better organization and management of different deployment stages (e.g., dev, test, prod) within the hybrid Apigee setup. The `ApigeeEnvironment` resources support one environment and are therefore created for each environment separately. |
| `ApigeeRedis` | `ApigeeRedis` is a CRD used in Apigee hybrid to provision and manage a Redis instance specifically for Apigee components within a Kubernetes cluster. `ApigeeRedis` is used for storing cluster-level rate limit counts used for distributed rate limiting in Apigee and Apigee hybrid. This applies only if SpikeArrest policy has the option [UseEffectiveCount](https://docs.cloud.google.com/apigee/docs/api-platform/reference/policies/spike-arrest-policy.md.txt#useeffectivecount) enabled. This dedicated `ApigeeRedis` instance serves as a high-performance data store, enabling functionalities like caching, session management, and rate limiting for the Apigee runtime plane. |
| `ApigeeValkey` | `ApigeeValkey` is a CRD that Apigee hybrid uses to provision and manage a Valkey instance for Apigee components within a Kubernetes cluster. It replaces `ApigeeRedis` and supports the same configuration. The `apigee-valkey` Helm chart creates the `ApigeeValkey` resource from the `valkey` configuration properties. Apigee hybrid versions 1.15.10, 1.16.13, and 1.17.3 add the `ApigeeValkey` CRD. In version 1.17, `ApigeeValkey` serves API versions `v1alpha1` and `v1beta1`, the same as `ApigeeRedis`. In versions 1.15 and 1.16, it serves `v1alpha1`, the same as `ApigeeRedis`. For more information, see Upgrading Apigee hybrid to version [1.15](https://docs.cloud.google.com/apigee/docs/hybrid/v1.15/upgrade.md.txt#valkey-patch-sequence), [1.16](https://docs.cloud.google.com/apigee/docs/hybrid/v1.16/upgrade.md.txt#valkey-patch-sequence), or [1.17](https://docs.cloud.google.com/apigee/docs/hybrid/v1.17/upgrade.md.txt#valkey-patch-sequence). |
| `ApigeeRoute` | `ApigeeRoute` is a CRD used in Apigee hybrid to define and manage routing configurations for external traffic to reach Apigee services running within a Kubernetes cluster. This CRD allows you to specify ingress rules, load balancing, and other routing policies to direct incoming requests to the appropriate Apigee components, ensuring efficient and secure access to your APIs. |
| `ApigeeRouteConfig` | `ApigeeRouteConfig` is a CRD in Apigee hybrid used to configure routing rules for external traffic to access Apigee services running in a Kubernetes cluster. It enables you to define hostnames, paths, and associated backend services to direct incoming requests to the correct Apigee components, providing flexibility and control over how external clients interact with your Apigee deployment. |
| `ApigeeTelemetry` | `ApigeeTelemetry` is a CRD in Apigee hybrid used to configure the collection and export of telemetry data (logs, metrics, traces) from the Apigee runtime plane components running in a Kubernetes cluster. This CRD allows you to specify destinations like Google Cloud Operations or other compatible systems, enabling centralized monitoring, analysis, and troubleshooting of your Apigee deployment. |
| `ApigeeIssues` | `ApigeeIssues` is a CRD in Apigee hybrid used to track and manage known issues or problems within the Apigee platform deployment. It serves as a centralized repository for recording, categorizing, and resolving issues, facilitating collaboration between teams and ensuring efficient troubleshooting and problem resolution within the hybrid environment. |
| `CassandraDataReplication` | `CassandraDataReplication` CRD in Apigee Hybrid is specifically designed for managing data replication between different Cassandra clusters in a multi-region Apigee hybrid deployment. |