Instala los componentes del entorno de ejecución de Apigee Hybrid
En este paso, usarás Helm para instalar los siguientes componentes de Apigee Hybrid:
- Operador de Apigee
- Almacén de datos de Apigee
- Telemetría de Apigee
- Apigee Redis
- Administrador de entrada de Apigee
- Organización de Apigee
- Tus entornos de Apigee
Instalarás los gráficos para cada entorno de a uno. La secuencia en la que instalas los componentes es importante.
Notas previas a la instalación
- Si aún no instalaste Helm v3.10+, sigue las instrucciones que se indican en Instala Helm.
-
Apigee Hybrid usa barreras de seguridad de Helm para verificar la configuración antes de instalar o actualizar un gráfico. Es posible que veas información específica de la barrera de seguridad en el resultado de cada uno de los comandos de esta sección, por ejemplo:
# Source: apigee-operator/templates/apigee-operators-guardrails.yaml apiVersion: v1 kind: Pod metadata: name: apigee-hybrid-helm-guardrail-operator namespace: apigee annotations: helm.sh/hook: pre-install,pre-upgrade helm.sh/hook-delete-policy: before-hook-creation,hook-succeeded labels: app: apigee-hybrid-helm-guardrail
Si alguno de los comandos
helm upgrade
falla, puedes usar el resultado de la barrera de seguridad para ayudar a diagnosticar la causa. Consulta Diagnostica problemas con barreras de seguridad. - Antes de ejecutar cualquiera de los comandos de actualización o instalación de Helm,
usa la función de prueba de validación de Helm; para ello, agrega
--dry-run
al final del comando. Consultahelm install --h
para enumerar los comandos, las opciones y el uso compatibles.
Pasos de instalación
- Si no lo hiciste, navega a tu directorio
APIGEE_HELM_CHARTS_HOME
. Ejecuta los siguientes comandos desde ese directorio. - Instala el operador o controlador de Apigee:
Prueba de validación:
helm upgrade operator apigee-operator/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f overrides.yaml \ --dry-run
Instala el gráfico:
helm upgrade operator apigee-operator/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f overrides.yaml
Verifica la instalación del operador de Apigee:
helm ls -n APIGEE_NAMESPACE
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION operator apigee 3 2023-06-26 00:42:44.492009 -0800 PST deployed apigee-operator-1.13.0 1.13.0
Para verificar que esté en funcionamiento, comprueba su disponibilidad:
kubectl -n APIGEE_NAMESPACE get deploy apigee-controller-manager
NAME READY UP-TO-DATE AVAILABLE AGE apigee-controller-manager 1/1 1 1 7d20h
-
Instala el almacén de datos de Apigee:
Prueba de validación:
helm upgrade datastore apigee-datastore/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml \ --dry-run=server
Instala el gráfico:
helm upgrade datastore apigee-datastore/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml
Verifica que
apigeedatastore
esté en funcionamiento; para ello, comprueba su estado antes de continuar con el siguiente paso:kubectl -n apigee get apigeedatastore default
NAME STATE AGE default running 2d
-
Instala la telemetría de Apigee:
Prueba de validación:
helm upgrade telemetry apigee-telemetry/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml \ --dry-run
Instala el gráfico:
helm upgrade telemetry apigee-telemetry/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml
Para verificar que esté en funcionamiento, comprueba su estado:
kubectl -n apigee get apigeetelemetry apigee-telemetry
NAME STATE AGE apigee-telemetry running 2d
-
Instala Apigee Redis:
Prueba de validación:
helm upgrade redis apigee-redis/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml \ --dry-run
Instala el gráfico:
helm upgrade redis apigee-redis/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml
Para verificar que esté en funcionamiento, comprueba su estado:
kubectl -n apigee get apigeeredis default
NAME STATE AGE default running 2d
-
Instala el administrador de entrada de Apigee:
Prueba de validación:
helm upgrade ingress-manager apigee-ingress-manager/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml \ --dry-run
Instala el gráfico:
helm upgrade ingress-manager apigee-ingress-manager/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml
Para verificar que esté en funcionamiento, comprueba su disponibilidad:
kubectl -n apigee get deployment apigee-ingressgateway-manager
NAME READY UP-TO-DATE AVAILABLE AGE apigee-ingressgateway-manager 2/2 2 2 2d
-
Instala la organización de Apigee. Si configuraste la variable de entorno $ORG_NAME en tu shell, puedes usarla en los siguientes comandos:
Ejecución de prueba:
helm upgrade $ORG_NAME apigee-org/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml \ --dry-run
Instala el gráfico:
helm upgrade $ORG_NAME apigee-org/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml
Para verificar que esté en funcionamiento, comprueba el estado de la organización correspondiente:
kubectl -n apigee get apigeeorg
NAME STATE AGE apigee-org1-xxxxx running 2d
-
Instala el entorno.
Debes instalar un entorno a la vez. Especifica el entorno con
--set env=
ENV_NAME. Si configuraste la variable de entorno $ENV_NAME en tu shell, puedes usarla en los siguientes comandos:Ejecución de prueba:
helm upgrade $ENV_NAME apigee-env/ \ --install \ --namespace apigee \ --atomic \ --set env=$ENV_NAME \ -f overrides.yaml \ --dry-run
Instala el gráfico:
helm upgrade $ENV_NAME apigee-env/ \ --install \ --namespace apigee \ --atomic \ --set env=$ENV_NAME \ -f overrides.yaml
Para verificar que esté en funcionamiento, comprueba el estado del entorno correspondiente:
kubectl -n apigee get apigeeenv
NAME STATE AGE GATEWAYTYPE apigee-org1-dev-xxx running 2d
-
Instala los grupos de entornos (
virtualhosts
).- Debes instalar un grupo de entornos (virtualhost) a la vez. Especifica el grupo de
entornos con
--set envgroup=
ENV_GROUP. Si configuraste la variable de entorno $ENV_GROUP en tu shell, puedes usarla en los siguientes comandos. Repite los siguientes comandos para cada grupo de entornos mencionado en tu archivooverrides.yaml
:Prueba de validación:
helm upgrade $ENV_GROUP apigee-virtualhost/ \ --install \ --namespace apigee \ --atomic \ --set envgroup=$ENV_GROUP \ -f overrides.yaml \ --dry-run
Instala el gráfico:
helm upgrade $ENV_GROUP apigee-virtualhost/ \ --install \ --namespace apigee \ --atomic \ --set envgroup=$ENV_GROUP \ -f overrides.yaml
- Verifica el estado de ApigeeRouter (AR).
La instalación de
virtualhosts
crea ApigeeRouteConfig (ARC), que crea de forma interna ApigeeRoute (AR) una vez que Apigee Watcher extrae detalles relacionados del grupo de entornos desde el plano de control. Por lo tanto, verifica que el estado de AR correspondiente esté en ejecución:kubectl -n apigee get arc
NAME STATE AGE apigee-org1-dev-egroup 2d
kubectl -n apigee get ar
NAME STATE AGE apigee-org1-dev-egroup-xxxxxx running 2d
- Debes instalar un grupo de entornos (virtualhost) a la vez. Especifica el grupo de
entornos con
Próximo paso
Instalaciones con Workload Identity
Si instalas Apigee Hybrid en GKE y configuras Workload Identity para autenticar cuentas de servicio, en el siguiente paso, configurarás las asociaciones entre las cuentas de servicio de Kubernetes y las cuentas de servicio de Google para tu clúster.
1 2 3 4 5 6 7 8 9 10 (SIGUIENTE) Paso 11: Configura Workload IdentityTodas las demás instalaciones
En el siguiente paso, configurarás la puerta de enlace de entrada de Apigee y, además, implementarás un proxy para probar tu instalación.
(SIGUIENTE) Paso 1: Expón la entrada de Apigee 2