In Apigee hybrid version 1.11, you have the choice of installing and
managing your clusters with either Helm charts or apigeectl
. You cannot manage a
cluster with both.
- New installations:
Start your installation with the instructions in The big picture
, and then choose the instructions for either Helm or
apigeectl
in Part 2: Hybrid runtime setup . - Existing installations:
If you want to manage an existing hybrid cluster with Helm
and the cluster is already managed with
apigeectl
, migrate the cluster to Helm management with The Apigee hybrid Helm migration tool .
Helm charts supported version
Apigee hybrid supports Helm charts v3.10+.
Helm charts for Apigee hybrid components
The hybrid components are installed and managed by the following Helm charts. The table is arranged in the order you will typically install them in during a fresh installation.
Scope | Components | Helm chart |
---|---|---|
Apigee operator
|
Apigee operator | apigee-operator
|
Storage
|
Cassandra | apigee-datastore
|
In‑memory storage
|
Redis | apigee-redis
|
Reporting
|
Logger Metrics |
apigee-telemetry
|
Ingress
|
Apigee Ingress gateway | apigee-ingress-manager
|
Organization
|
Apigee Connect Agent MART Watcher |
apigee-org
|
Environment
|
Runtime Synchronizer UDCA |
apigee-env
|
Environment group
|
virtualhost | apigee-virtualhost
|
apigeectl
/ Helm command cross reference
The following table lists the Helm equivalents for common apigeectl
commands:
apigeectl
commandapigeectl init
apigeectl init
: -
kubectl apply -k apigee-operator/etc/crds/default/
-
helm install operator apigee-operator/
or
helm upgrade operator apigee-operator/
-
helm install ingress-manager apigee-ingress-manager/
or
helm upgrade ingress-manager apigee-ingress-manager/
For example:
kubectl apply -k apigee-operator/etc/crds/default/helm install operator apigee-operator/ --namespace apigee \ --atomic \ -f overrides .yaml
helm install ingress-manager apigee-ingress-manager/ --namespace apigee \ --atomic \ -f overrides .yaml
apigeectl init
when used to install or apply changes to istiod.-
helm install ingress-manager apigee-ingress-manager/
-
helm upgrade ingress-manager apigee-ingress-manager/
For example:
helm upgrade ingress-manager apigee-ingress-manager/ \ --install \ --namespace apigee \ --atomic \ -f overrides .yaml
apigeectl apply
apigeectl apply --datastore
-
helm install datastore apigee-datastore/
-
helm upgrade datastore apigee-datastore/
For example:
helm upgrade datastore apigee-datastore/ \ --install \ --namespace apigee \ --atomic \ -f overrides .yaml
apigeectl apply --redis
-
helm install redis apigee-redis/
-
helm upgrade redis apigee-redis/
For example:
helm upgrade redis apigee-redis/ \ --install \ --namespace apigee \ --atomic \ -f overrides .yaml
apigeectl apply --org
-
helm install ORG_NAME apigee-org/
-
helm upgrade ORG_NAME apigee-org/
For example:
helm upgrade ORG_NAME apigee-org/ \ --install \ --namespace apigee \ --atomic \ -f overrides .yaml
apigeectl apply --env ENV_NAME
-
helm install ENV_NAME apigee-env/
-
helm upgrade ENV_NAME apigee-env/
For example:
helm upgrade ENV_NAME apigee-env/ \ --install \ --namespace apigee \ --set env= ENV_NAME \ --atomic \ -f overrides .yaml
apigeectl apply --all-envs
apigeectl apply --settings virtualhosts
-
helm install ENV_GROUP_NAME apigee-virtualhosts/
-
helm upgrade ENV_GROUP_NAME apigee-virtualhosts/
For example:
helm upgrade ENV_GROUP_NAME apigee-virtualhosts/ \ --install \ --namespace apigee \ --set envgroup=ENV_GROUP_NAME \ --atomic \ -f overrides .yaml
apigeectl delete COMPONENT
-
helm delete RELEASE_NAME
For example:
helm delete datastore -n apigee
apigeectl delete
orapigeectl delete --all
apigeectl COMMAND
--dry-run=client
-
helm COMMAND --dry-run
For example:
helm upgrade datastore apigee-datastore/ \ --install \ --namespace apigee \ --atomic \ -f overrides .yaml \ --dry-run
apigeectl check-ready