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 command |
Helm command |
---|---|
apigeectl init |
The following commands mimic apigeectl init :
For example: kubectl apply -k apigee-operator/etc/crds/default/ |
apigeectl init when used to install or apply changes to istiod. |
For example: helm upgrade ingress-manager apigee-ingress-manager/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml |
apigeectl apply |
There is no single command to manage all hybrid components. Because each component has a specific chart, you must install or upgrade each chart individually. |
apigeectl apply --datastore |
For example: helm upgrade datastore apigee-datastore/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml |
apigeectl apply --redis |
For example: helm upgrade redis apigee-redis/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml |
apigeectl apply --org |
For example: helm upgrade ORG_NAME apigee-org/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml |
apigeectl apply --env ENV_NAME |
For example: helm upgrade ENV_NAME apigee-env/ \ --install \ --namespace apigee \ --set env=ENV_NAME \ --atomic \ -f overrides.yaml |
apigeectl apply --all-envs |
There is no single command to manage all environments at once. You must install or upgrade each environment individually. |
apigeectl apply --settings 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 |
For example: helm delete datastore -n apigee |
apigeectl delete orcode>apigeectl delete --all |
There is no single Helm command to delete all components at once. You must delete each component individually. |
apigeectl COMMAND --dry-run=client |
For example: helm upgrade datastore apigee-datastore/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml \ --dry-run |
apigeectl check-ready |
While there is no no equivalent Helm command, during installation You can use the Check cluster readiness process to perform many of the same tasks. |