Apigee hybrid Helm reference

Helm supported version

Apigee hybrid supports Helm v3.14.2+.

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.

ScopeComponentsHelm chart
Apigee operatorApigee operatorapigee-operator
StorageCassandraapigee-datastore
In‑memory storageRedisapigee-redis
ReportingLogger
Metrics		apigee-telemetry
IngressApigee Ingress gatewayapigee-ingress-manager
OrganizationApigee Connect Agent
MART
UDCA
Watcher		apigee-org
EnvironmentRuntime
Synchronizer		apigee-env
Environment groupvirtualhostapigee-virtualhost

apigeectl / Helm command cross reference

The following table lists the Helm equivalents for common apigeectl commands:

apigeectl commandHelm command
apigeectl initThe following commands mimic 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_NAMESPACE \
  --atomic \
  -f overrides.yaml
helm install ingress-manager apigee-ingress-manager/
  --namespace APIGEE_NAMESPACE \
  --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_NAMESPACE \
  --atomic \
  -f overrides.yaml
apigeectl applyThere 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
  • helm install datastore apigee-datastore/
  • helm upgrade datastore apigee-datastore/

For example:

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --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_NAMESPACE \
  --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_NAMESPACE \
  --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_NAMESPACE \
  --set env=ENV_NAME \
	--atomic \
  -f overrides.yaml
apigeectl apply --all-envsThere is no single command to manage all environments at once. You must install or upgrade each environment individually.
apigeectl apply --settings virtualhosts
  • helm install ENV_GROUP apigee-virtualhosts/
  • helm upgrade ENV_GROUP apigee-virtualhosts/

For example:

helm upgrade $ENV_GROUP apigee-virtualhosts/ \
  --install \
  --namespace APIGEE_NAMESPACE \
	--set envgroup=$ENV_GROUP \
  --atomic \
  -f overrides.yaml
apigeectl delete COMPONENT
  • helm delete RELEASE_NAME

For example:

helm delete datastore -n APIGEE_NAMESPACE
apigeectl delete or
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
  • helm COMMAND --dry-run

For example:

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f overrides.yaml \
  --dry-run=server
apigeectl check-readyThere is no equivalent Helm command.