Paso 3: Instalar ASM

Instala ASM

Apigee Hybrid usa la distribución de Istio proporcionada con Anthos Service Mesh (ASM). Sigue estos pasos para instalar ASM en tu clúster.

Versiones de ASM admitidas

Para las nuevas instalaciones de la versión híbrida 1.4.4, instala la versión ASM 1.7.x.
Para actualizaciones de versiones anteriores de la versión híbrida, instala la versión 1.6.x de ASM.

Realiza los pasos de configuración y ajustes de ASM

Para completar la instalación de ASM, primero debes seguir los pasos de configuración y ajustes específicos de ASM en la documentación de ASM. Luego, debes regresar aquí para completar la configuración específica de la opción híbrida antes de aplicar la configuración al clúster.

Las instrucciones para instalar y configurar ASM varían según la plataforma. Elige los pasos para tu plataforma a continuación.

GKE

Sigue los pasos de configuración y ajustes de ASM:
Importante: Cuando sigas la documentación de ASM, no instales ni apliques el archivo de configuración YAML istio-operator.yaml cuando se te indique. En ese momento, debes volver a esta página para editar el archivo con más opciones de configuración específicas de nube híbrida antes de instalar o aplicar la configuración.
- Si se trata de una instalación nueva de Apigee Hybrid, instala la versión 1.7.x de ASM. Ve a Instalación nueva.
- Si estás actualizando desde una versión híbrida, usa la versión 1.6.x de ASM. Ve a: Introducción a la instalación y migración.
Cuando hayas completado los pasos de configuración y ajustes de ASM, ve a la siguiente sección para completar la configuración de nube híbrida y los pasos de instalación de ASM.

Realiza la configuración híbrida final e instala ASM

Por último, agrega configuraciones específicas de la nube híbrida al archivo istio-operator.yaml y, luego, instala ASM.

Asegúrate de que estás en el directorio raíz de la instalación de ASM. Por ejemplo: 1.7.3-asm.6.
Abre el archivo istio-operator.yaml en un editor.
- En ASM 1.7.x: ./asm/istio/istio-operator.yaml
- En ASM 1.6.x: ./asm/cluster/istio-operator.yaml

Agrega (o actualiza) la estrofa spec:components en el archivo istio-operator.yaml debajo de la sección meshConfig: e inmediatamente después de values:, en donde reserved_static_ip es una dirección IP de tu puerta de enlace de entorno de ejecución de entrada que se puede usar. Si no tienes una dirección IP estática reservada, para esta guía de inicio rápido, puedes omitir la propiedad LoadBalancerIP.

Texto que se debe copiar

  components:
    ingressGateways:
    - name: istio-ingressgateway
      enabled: true
      k8s:
        service:
          type: LoadBalancer
          loadBalancerIP: static_ip # If you do not have a reserved static IP, leave this out.
          ports:
          - name: status-port
            port: 15021 # for ASM 1.7.x and above, else 15020
            targetPort: 15021 # for ASM 1.7.x and above, else 15020
          - name: http2
            port: 80
            targetPort: 8080
          - name: https
            port: 443
            targetPort: 8443

Ejemplo en el que se muestra la posición

Se insertan saltos de línea para facilitar la lectura

apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
metadata:
  clusterName: "hybrid-example/us-central1/example-cluster" # {"$ref":"#/definitions/io.k8s.cli.substitutions.cluster-name"}
spec:
  profile: asm
  hub: gcr.io/gke-release/asm # {"$ref":"#/definitions/io.k8s.cli.setters.anthos.servicemesh.hub"}
  tag: 1.5.7-asm.0 # {"$ref":"#/definitions/io.k8s.cli.setters.anthos.servicemesh.tag"}
  meshConfig:
    defaultConfig:
      proxyMetadata:
        GCP_METADATA: "hybrid-example|123456789123|example-cluster|us-central1" #
          {"$ref":"#/definitions/io.k8s.cli.substitutions.gke-metadata"}

  components:
    pilot:
      k8s:
        hpaSpec:
          maxReplicas: 2
    ingressGateways:
    - name: istio-ingressgateway
      enabled: true
      k8s:
        service:
          type: LoadBalancer
          loadBalancerIP: 123.234.56.78
          ports:
          - name: status-port
            port: 15021 # for ASM 1.7.x and above, else 15020
            targetPort: 15021 # for ASM 1.7.x and above, else 15020
          - name: http2
            port: 80
            targetPort: 8080
          - name: https
            port: 443
            targetPort: 8443
        hpaSpec:
          maxReplicas: 2
  values:
    .
    .
    .

Regresa a la documentación de ASM que usaste antes y completa la instalación de ASM (instala o aplica el archivo istio-operator.yaml en el clúster). Si usas ASM 1.6 y puedes elegir, selecciona PERMISSIVE TLS.
Nota: Si estás en ASM 1.6, te recomendamos usar el comando asmctl validate para validar la configuración y el estado de los componentes instalados. Este comando se describe en la sección de la documentación de ASM sobre la validación de la instalación. Este comando solo es válido si usas ASM 1.6.

GKE On‑Prem

Cómo configurar y descargar los ASM

Usa la documentación de ASM para configurar tu entorno y descargar ASM.

Antes de comenzar, lee los siguientes pasos. Te pediremos que sigas algunos de los pasos que se indican en la documentación de ASM y, luego, regresa para completar la instalación.
Ve a la página Instala Anthos Service Mesh en entornos locales y realiza todos los pasos de ASM hasta Crea el espacio de nombres istio-system inclusive. Luego, detente y ve a la siguiente sección Aplica el manifiesto.
Importante: Después de completar los pasos de la sección Crea el espacio de nombres istio-system, detente y continúa con los pasos que se indican en la siguiente sección. Recomendamos que esperes para aplicar el archivo de manifiesto hasta que se te lo indique.

Aplica el manifiesto

Una vez que hayas descargado y descomprimido el archivo de instalación de ASM, continúa con los siguientes pasos:

Asegúrate de estar en el directorio de Istio que descargaste y descomprimiste. Por ejemplo, 1.7.3-asm.6.
Ejecuta el siguiente comando, en el que your_static_ip es una dirección IP estática que puede usar el componente Ingress de Istio. Si no tienes una dirección IP estática reservada, deja la línea --set values.gateways.istio-ingressgateway.loadBalancerIP como se indica a continuación:
```
./bin/istioctl install --set profile=asm-multicloud \
 --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
```
Por último, regresa a la documentación de ASM para verificar los componentes del plano de control a fin de validar la instalación.

Personaliza la instalación de ASM

La instalación de ASM que acabas de realizar es una instalación mínima, suficiente para probar y usar Apigee Hybrid en casos de uso básicos. Para obtener información sobre cómo abordar casos de uso más avanzados, como agregar, quitar o modificar números de puertos del balanceador de cargas, consulta Habilita funciones opcionales.

Resumen

Ahora tienes instalado cert-manager y ASM, y estás listo para instalar la herramienta de línea de comandos híbrida de Apigee en tu máquina local.

AKS

Cómo configurar y descargar los ASM

Usa la documentación de ASM para configurar tu entorno y descargar ASM.

Antes de comenzar, lee los siguientes pasos. Te pediremos que sigas algunos de los pasos que se indican en la documentación de ASM y, luego, regresa para completar la instalación.
Ve a la página Instala Anthos Service Mesh en clústeres vinculados y realiza todos los pasos de ASM hasta Crea el espacio de nombres istio-system inclusive. Luego, detente y ve a la siguiente sección Aplica el manifiesto.
Importante: Después de completar los pasos de la sección Crea el espacio de nombres istio-system, detente y continúa con los pasos que se indican en la siguiente sección. Recomendamos que esperes para aplicar el archivo de manifiesto hasta que se te lo indique.

Aplica el manifiesto

Una vez que hayas descargado y descomprimido el archivo de instalación de ASM, continúa con los siguientes pasos:

Asegúrate de estar en el directorio de Istio que descargaste y descomprimiste. Por ejemplo, 1.7.3-asm.6.
Ejecuta el siguiente comando, en el que your_static_ip es una dirección IP estática que puede usar el componente Ingress de Istio. Si no tienes una dirección IP estática reservada, deja la línea --set values.gateways.istio-ingressgateway.loadBalancerIP como se indica a continuación:
```
./bin/istioctl install --set profile=asm-multicloud \
 --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
```
Por último, regresa a la documentación de ASM para verificar los componentes del plano de control a fin de validar la instalación.

Personaliza la instalación de ASM

Resumen

Ahora tienes instalado cert-manager y ASM, y estás listo para instalar la herramienta de línea de comandos híbrida de Apigee en tu máquina local.

GKE on AWS

Cómo configurar y descargar los ASM

Usa la documentación de ASM para configurar tu entorno y descargar ASM.

Antes de comenzar, lee los siguientes pasos. Te pediremos que sigas algunos de los pasos que se indican en la documentación de ASM y, luego, regresa para completar la instalación.
Ve a la página Instala Anthos Service Mesh en GKE en AWS y realiza todos los pasos de ASM hasta Descarga el archivo de instalación inclusive. Luego, detente y ve a la siguiente sección Aplica el manifiesto.
Importante: Después de completar los pasos de la sección Descarga el archivo de instalación, detente y continúa con los pasos que se enumeran en la siguiente sección. Recomendamos que esperes para aplicar el archivo de manifiesto hasta que se te lo indique.

Aplica el manifiesto

Una vez que hayas descargado y descomprimido el archivo de instalación de ASM, continúa con los siguientes pasos:

Asegúrate de estar en el directorio de Istio que descargaste y descomprimiste. Por ejemplo, 1.7.3-asm.6.
Ejecuta el siguiente comando, en el que your_static_ip es una dirección IP estática que puede usar el componente Ingress de Istio. Si no tienes una dirección IP estática reservada, deja la línea --set values.gateways.istio-ingressgateway.loadBalancerIP como se indica a continuación:
```
./bin/istioctl install --set profile=asm-multicloud \
 --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
```
Por último, regresa a la documentación de ASM para verificar los componentes del plano de control a fin de validar la instalación.

Personaliza la instalación de ASM

Resumen

Ahora tienes instalado cert-manager y ASM, y estás listo para instalar la herramienta de línea de comandos híbrida de Apigee en tu máquina local.

EKS

Cómo configurar y descargar los ASM

Usa la documentación de ASM para configurar tu entorno y descargar ASM.

Antes de comenzar, lee los siguientes pasos. Te pediremos que sigas algunos de los pasos que se indican en la documentación de ASM y, luego, regresa para completar la instalación.
Ve a la página Instala Anthos Service Mesh en clústeres vinculados y realiza todos los pasos de ASM hasta Crea el espacio de nombres istio-system inclusive. Luego, detente y ve a la siguiente sección Aplica el manifiesto.
Importante: Después de completar los pasos de la sección Crea el espacio de nombres istio-system, detente y continúa con los pasos que se indican en la siguiente sección. Recomendamos que esperes para aplicar el archivo de manifiesto hasta que se te lo indique.

Aplica el manifiesto

Una vez que hayas descargado y descomprimido el archivo de instalación de ASM, continúa con los siguientes pasos:

Asegúrate de estar en el directorio de Istio que descargaste y descomprimiste. Por ejemplo, 1.7.3-asm.6.
Ejecuta el siguiente comando, en el que your_static_ip es una dirección IP estática que puede usar el componente Ingress de Istio. Si no tienes una dirección IP estática reservada, deja la línea --set values.gateways.istio-ingressgateway.loadBalancerIP como se indica a continuación:
```
./bin/istioctl install --set profile=asm-multicloud \
 --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
```
Por último, regresa a la documentación de ASM para verificar los componentes del plano de control a fin de validar la instalación.

Personaliza la instalación de ASM

Resumen

Ahora tienes instalado cert-manager y ASM, y estás listo para instalar la herramienta de línea de comandos híbrida de Apigee en tu máquina local.

Resumen

Ahora tienes instalado cert-manager y ASM, y estás listo para instalar la herramienta de línea de comandos híbrida de Apigee en tu máquina local.

Próximo paso

1 2 3 (SIGUIENTE) Paso 4: Instala apigeectl 5 6 7