Paso 3: Instala ASM

Instalar 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 compatibles

  • En las nuevas instalaciones de la versión híbrida 1.4.4, instala la versión 1.7.x de ASM.
  • Para actualizar desde versiones anteriores de la configuración híbrida, instala la versión 1.6.x de ASM.

Sigue los pasos de configuración de ASM

Para completar la instalación de ASM, primero debes seguir los pasos de configuración específicos de ASM que se indican en la documentación de ASM. Después, debes volver aquí para completar la configuración específica del modo híbrido antes de aplicar la configuración al clúster.

Las instrucciones para instalar y configurar ASM varían en función de la plataforma. Elige los pasos correspondientes a tu plataforma a continuación.

GKE

  1. Sigue los pasos de configuración de ASM:

  2. Cuando haya completado los pasos de configuración de ASM, vaya a la siguiente sección para completar los pasos de configuración híbrida e instalación de ASM.

Realizar la configuración final de Hybrid e instalar ASM

Por último, añade configuraciones específicas para el entorno híbrido al archivo istio-operator.yaml e instala ASM.

  1. Asegúrate de que te encuentras en el directorio raíz de la instalación de ASM. Por ejemplo: 1.7.3-asm.6.
  2. 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
  3. Añada (o actualice) la stanza spec:components en el archivo istio-operator.yaml debajo de la sección meshConfig: e inmediatamente encima de values:, donde reserved_static_ip es una dirección IP que puede usar su pasarela de entrada de tiempo de ejecución. Si no tienes una dirección IP estática reservada, puedes omitir la propiedad LoadBalancerIP en esta guía de inicio rápido.

    Texto que se va a 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 que muestra la colocación

    Saltos de línea insertados 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:
    .
    .
    .
  4. Vuelve a la documentación de ASM que has usado antes y completa la instalación de ASM (instala o aplica el archivo istio-operator.yaml al clúster). Si usas ASM 1.6 y tienes la opción, elige PERMISSIVE mTLS.

GKE On‑Prem

Configurar y descargar ASM

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

  1. Lee atentamente los pasos que se indican a continuación antes de empezar. Te pediremos que sigas algunos de los pasos que se indican en la documentación de ASM y, después, que vuelvas a esta página para completar la instalación.
  2. Ve a Instalar Anthos Service Mesh en las instalaciones y sigue todos los pasos de ASM hasta Crear el espacio de nombres istio-system (inclusive). Después, detente y ve a la siguiente sección, Aplicar el manifiesto.

Aplicar el archivo de manifiesto

Cuando hayas descargado y descomprimido el archivo de instalación de ASM, sigue estos pasos:

  1. Asegúrate de que estás en el directorio de Istio que has descargado y descomprimido. Por ejemplo: 1.7.3-asm.6.
  2. Ejecuta el siguiente comando, donde your_static_ip es una dirección IP estática que puede usar el componente de entrada de Istio. Si no tienes reservada una dirección IP estática, deja fuera la línea --set values.gateways.istio-ingressgateway.loadBalancerIP: 
    ./bin/istioctl install --set profile=asm-multicloud \
 --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
  3. Por último, vuelve a la documentación de ASM para comprobar los componentes del plano de control y validar la instalación.

Personalizar la instalación de ASM

La instalación de ASM que acaba de realizar es mínima y suficiente para probar y usar Apigee hybrid en casos de uso básicos. Para obtener información sobre cómo abordar casos prácticos más avanzados, como añadir, quitar o modificar números de puerto de balanceadores de carga, consulta Habilitar funciones opcionales.

Resumen

Ahora tienes instalados cert-manager y ASM, y puedes instalar la herramienta de línea de comandos de Apigee hybrid en tu máquina local.

AKS

Configurar y descargar ASM

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

  1. Lee atentamente los pasos que se indican a continuación antes de empezar. Te pediremos que sigas algunos de los pasos que se indican en la documentación de ASM y, después, que vuelvas a esta página para completar la instalación.
  2. Ve a Instalar Anthos Service Mesh en clústeres adjuntos y sigue todos los pasos de ASM hasta Crear el espacio de nombres istio-system (incluido). Después, detente y ve a la siguiente sección, Aplicar el manifiesto.

Aplicar el archivo de manifiesto

Cuando hayas descargado y descomprimido el archivo de instalación de ASM, sigue estos pasos:

  1. Asegúrate de que estás en el directorio de Istio que has descargado y descomprimido. Por ejemplo: 1.7.3-asm.6.
  2. Ejecuta el siguiente comando, donde your_static_ip es una dirección IP estática que puede usar el componente de entrada de Istio. Si no tienes reservada una dirección IP estática, deja fuera la línea --set values.gateways.istio-ingressgateway.loadBalancerIP: 
    ./bin/istioctl install --set profile=asm-multicloud \
 --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
  3. Por último, vuelve a la documentación de ASM para comprobar los componentes del plano de control y validar la instalación.

Personalizar la instalación de ASM

La instalación de ASM que acaba de realizar es mínima y suficiente para probar y usar Apigee hybrid en casos de uso básicos. Para obtener información sobre cómo abordar casos prácticos más avanzados, como añadir, quitar o modificar números de puerto de balanceadores de carga, consulta Habilitar funciones opcionales.

Resumen

Ahora tienes instalados cert-manager y ASM, y puedes instalar la herramienta de línea de comandos de Apigee hybrid en tu máquina local.

GKE en AWS

Configurar y descargar ASM

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

  1. Lee atentamente los pasos que se indican a continuación antes de empezar. Te pediremos que sigas algunos de los pasos que se indican en la documentación de ASM y, después, que vuelvas a esta página para completar la instalación.
  2. Ve a Instalar Anthos Service Mesh en GKE en AWS y sigue todos los pasos de ASM hasta Descargar el archivo de instalación (inclusive). Después, detente y ve a la siguiente sección, Aplicar el manifiesto.

Aplicar el archivo de manifiesto

Cuando hayas descargado y descomprimido el archivo de instalación de ASM, sigue estos pasos:

  1. Asegúrate de que estás en el directorio de Istio que has descargado y descomprimido. Por ejemplo: 1.7.3-asm.6.
  2. Ejecuta el siguiente comando, donde your_static_ip es una dirección IP estática que puede usar el componente de entrada de Istio. Si no tienes reservada una dirección IP estática, deja fuera la línea --set values.gateways.istio-ingressgateway.loadBalancerIP: 
    ./bin/istioctl install --set profile=asm-multicloud \
 --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
  3. Por último, vuelve a la documentación de ASM para comprobar los componentes del plano de control y validar la instalación.

Personalizar la instalación de ASM

La instalación de ASM que acaba de realizar es mínima y suficiente para probar y usar Apigee hybrid en casos de uso básicos. Para obtener información sobre cómo abordar casos prácticos más avanzados, como añadir, quitar o modificar números de puerto de balanceadores de carga, consulta Habilitar funciones opcionales.

Resumen

Ahora tienes instalados cert-manager y ASM, y puedes instalar la herramienta de línea de comandos de Apigee hybrid en tu máquina local.

EKS

Configurar y descargar ASM

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

  1. Lee atentamente los pasos que se indican a continuación antes de empezar. Te pediremos que sigas algunos de los pasos que se indican en la documentación de ASM y, después, que vuelvas a esta página para completar la instalación.
  2. Ve a Instalar Anthos Service Mesh en clústeres adjuntos y sigue todos los pasos de ASM hasta Crear el espacio de nombres istio-system (incluido). Después, detente y ve a la siguiente sección, Aplicar el manifiesto.

Aplicar el archivo de manifiesto

Cuando hayas descargado y descomprimido el archivo de instalación de ASM, sigue estos pasos:

  1. Asegúrate de que estás en el directorio de Istio que has descargado y descomprimido. Por ejemplo: 1.7.3-asm.6.
  2. Ejecuta el siguiente comando, donde your_static_ip es una dirección IP estática que puede usar el componente de entrada de Istio. Si no tienes reservada una dirección IP estática, deja fuera la línea --set values.gateways.istio-ingressgateway.loadBalancerIP: 
    ./bin/istioctl install --set profile=asm-multicloud \
 --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
  3. Por último, vuelve a la documentación de ASM para comprobar los componentes del plano de control y validar la instalación.

Personalizar la instalación de ASM

La instalación de ASM que acaba de realizar es mínima y suficiente para probar y usar Apigee hybrid en casos de uso básicos. Para obtener información sobre cómo abordar casos prácticos más avanzados, como añadir, quitar o modificar números de puerto de balanceadores de carga, consulta Habilitar funciones opcionales.

Resumen

Ahora tienes instalados cert-manager y ASM, y puedes instalar la herramienta de línea de comandos de Apigee hybrid en tu máquina local.

Resumen

Ahora tienes instalados cert-manager y ASM, y puedes instalar la herramienta de línea de comandos de Apigee hybrid en tu máquina local.

1 2 3 Paso 4: Instala apigeectl 5 6 7