Étape 3 : Installer ASM

Installer ASM

Apigee hybride utilise la distribution Istio fournie avec Anthos Service Mesh (ASM). Pour installer ASM dans votre cluster, procédez comme suit :

Versions ASM compatibles

  • Pour les nouvelles installations d'Apigee hybrid version 1.4.4, installez ASM version 1.7.x.
  • Pour les mises à niveau à partir de versions précédentes hybrides, installez ASM version 1.6.x.

Réaliser les étapes d'installation et de configuration d'ASM

Pour effectuer l'installation d'ASM, vous devez d'abord suivre les étapes d'installation et de configuration spécifiques à cet outil dans la documentation ASM. Ensuite, vous devez revenir sur cette page pour terminer la configuration spécifique hybride avant d'appliquer la configuration au cluster.

Les instructions d'installation et de configuration d'ASM varient en fonction de votre plate-forme. Choisissez les étapes correspondant à votre plate-forme ci-dessous :

GKE

  1. Suivez la procédure d'installation et de configuration d'ASM :
  2. Une fois les étapes d'installation et de configuration d'ASM terminées, passez à la section suivante pour terminer la configuration hybride et l'installation d'ASM.

Réaliser une configuration hybride finale et installer ASM

Pour finir, ajoutez des configurations hybrides spécifiques au fichier istio-operator.yaml et installez ASM.

  1. Assurez-vous d'être dans le répertoire racine de l'installation ASM. Exemple : 1.7.3-asm.6.
  2. Ouvrez le fichier istio-operator.yaml dans un éditeur.
    • Dans ASM 1.7.x : ./asm/istio/istio-operator.yaml
    • Dans ASM 1.6.x : ./asm/cluster/istio-operator.yaml
  3. Ajoutez (ou mettez à jour) le stanza spec:components dans le fichier istio-operator.yaml sous la section meshConfig: et immédiatement au-dessus de values:, où reserved_static_ip est une adresse IP que votre passerelle d'entrée d'exécution peut utiliser. Si vous ne disposez pas d'une adresse IP statique réservée, vous pouvez abandonner la propriété LoadBalancerIP pour ce démarrage rapide.

    Texte à copier

      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
    

    Exemple illustrant un emplacement

    Sauts de ligne insérés pour améliorer la lisibilité

    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. Revenez maintenant à la documentation d'ASM que vous avez utilisée précédemment et terminez l'installation d'ASM (installez ou appliquez le fichier istio-operator.yaml au cluster). Si vous utilisez ASM 1.6 et que vous avez le choix, optez pour mTLS PERMISSIVE.

GKE On-Prem

Configurer et télécharger ASM

Consultez la documentation ASM pour configurer votre environnement et télécharger ASM.

  1. Lisez attentivement la procédure ci-dessous avant de commencer. Nous vous demanderons d'effectuer certaines des étapes répertoriées dans la documentation ASM, puis de revenir sur cette page pour terminer l'installation.
  2. Accédez à la page Installer Anthos Service Mesh sur site, puis exécutez toutes les étapes ASM jusqu'à la section Créer l'espace de noms istio-system. Une fois cette étape effectuée, passez à la section Appliquer le fichier manifeste ci-dessous.

Appliquer le fichier manifeste

Une fois que vous avez téléchargé et décompressé le fichier d'installation ASM, procédez comme suit :

  1. Assurez-vous que vous vous trouvez dans le répertoire Istio que vous avez téléchargé et décompressé. Par exemple : 1.7.3-asm.6.
  2. Exécutez la commande suivante, où your_static_ip est une adresse IP statique que le composant d'entrée Istio peut utiliser. Si vous n'avez pas d'adresse IP statique réservée, laissez la ligne --set values.gateways.istio-ingressgateway.loadBalancerIP comme suit :
    ./bin/istioctl install --set profile=asm-multicloud \
     --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
  3. Enfin, revenez à la documentation ASM pour vérifier les composants du plan de contrôle afin de valider votre installation.

Personnaliser l'installation d'ASM

L'installation d'ASM que vous venez d'effectuer est une installation minimale, suffisante pour tester et utiliser Apigee hybrid dans des cas d'utilisation de base. Pour en savoir plus sur la gestion de cas d'utilisation plus avancés, tels que l'ajout, la suppression ou la modification de numéros de port de l'équilibreur de charge, consultez la page Activer les fonctionnalités facultatives.

Résumé

Maintenant, cert-manager et ASM sont installés, et vous êtes prêt à installer l'outil de ligne de commande Apigee hybrid sur votre ordinateur local.

AKS

Configurer et télécharger ASM

Consultez la documentation ASM pour configurer votre environnement et télécharger ASM.

  1. Lisez attentivement la procédure ci-dessous avant de commencer. Nous vous demanderons d'effectuer certaines des étapes répertoriées dans la documentation ASM, puis de revenir sur cette page pour terminer l'installation.
  2. Accédez à la page Installer Anthos Service Mesh sur les clusters associés et effectuez toutes les étapes ASM jusqu'à Créer l'espace de noms istio-system. Une fois cette étape effectuée, passez à la section Appliquer le fichier manifeste ci-dessous.

Appliquer le fichier manifeste

Une fois que vous avez téléchargé et décompressé le fichier d'installation ASM, procédez comme suit :

  1. Assurez-vous que vous vous trouvez dans le répertoire Istio que vous avez téléchargé et décompressé. Par exemple : 1.7.3-asm.6.
  2. Exécutez la commande suivante, où your_static_ip est une adresse IP statique que le composant d'entrée Istio peut utiliser. Si vous n'avez pas d'adresse IP statique réservée, laissez la ligne --set values.gateways.istio-ingressgateway.loadBalancerIP comme suit :
    ./bin/istioctl install --set profile=asm-multicloud \
     --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
  3. Enfin, revenez à la documentation ASM pour vérifier les composants du plan de contrôle afin de valider votre installation.

Personnaliser l'installation d'ASM

L'installation d'ASM que vous venez d'effectuer est une installation minimale, suffisante pour tester et utiliser Apigee hybrid dans des cas d'utilisation de base. Pour en savoir plus sur la gestion de cas d'utilisation plus avancés, tels que l'ajout, la suppression ou la modification de numéros de port de l'équilibreur de charge, consultez la page Activer les fonctionnalités facultatives.

Résumé

Maintenant, cert-manager et ASM sont installés, et vous êtes prêt à installer l'outil de ligne de commande Apigee hybrid sur votre ordinateur local.

GKE sur AWS

Configurer et télécharger ASM

Consultez la documentation ASM pour configurer votre environnement et télécharger ASM.

  1. Lisez attentivement la procédure ci-dessous avant de commencer. Nous vous demanderons d'effectuer certaines des étapes répertoriées dans la documentation ASM, puis de revenir sur cette page pour terminer l'installation.
  2. Accédez à la page Installer Anthos Service Mesh sur GKE sur AWS et effectuez toutes les étapes ASM jusqu'à Télécharger le fichier d'installation. Une fois cette étape effectuée, passez à la section Appliquer le fichier manifeste ci-dessous.

Appliquer le fichier manifeste

Une fois que vous avez téléchargé et décompressé le fichier d'installation ASM, procédez comme suit :

  1. Assurez-vous que vous vous trouvez dans le répertoire Istio que vous avez téléchargé et décompressé. Par exemple : 1.7.3-asm.6.
  2. Exécutez la commande suivante, où your_static_ip est une adresse IP statique que le composant d'entrée Istio peut utiliser. Si vous n'avez pas d'adresse IP statique réservée, laissez la ligne --set values.gateways.istio-ingressgateway.loadBalancerIP comme suit :
    ./bin/istioctl install --set profile=asm-multicloud \
     --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
  3. Enfin, revenez à la documentation ASM pour vérifier les composants du plan de contrôle afin de valider votre installation.

Personnaliser l'installation d'ASM

L'installation d'ASM que vous venez d'effectuer est une installation minimale, suffisante pour tester et utiliser Apigee hybrid dans des cas d'utilisation de base. Pour en savoir plus sur la gestion de cas d'utilisation plus avancés, tels que l'ajout, la suppression ou la modification de numéros de port de l'équilibreur de charge, consultez la page Activer les fonctionnalités facultatives.

Résumé

Maintenant, cert-manager et ASM sont installés, et vous êtes prêt à installer l'outil de ligne de commande Apigee hybrid sur votre ordinateur local.

EKS

Configurer et télécharger ASM

Consultez la documentation ASM pour configurer votre environnement et télécharger ASM.

  1. Lisez attentivement la procédure ci-dessous avant de commencer. Nous vous demanderons d'effectuer certaines des étapes répertoriées dans la documentation ASM, puis de revenir sur cette page pour terminer l'installation.
  2. Accédez à la page Installer Anthos Service Mesh sur les clusters associés et effectuez toutes les étapes ASM jusqu'à Créer l'espace de noms istio-system. Une fois cette étape effectuée, passez à la section Appliquer le fichier manifeste ci-dessous.

Appliquer le fichier manifeste

Une fois que vous avez téléchargé et décompressé le fichier d'installation ASM, procédez comme suit :

  1. Assurez-vous que vous vous trouvez dans le répertoire Istio que vous avez téléchargé et décompressé. Par exemple : 1.7.3-asm.6.
  2. Exécutez la commande suivante, où your_static_ip est une adresse IP statique que le composant d'entrée Istio peut utiliser. Si vous n'avez pas d'adresse IP statique réservée, laissez la ligne --set values.gateways.istio-ingressgateway.loadBalancerIP comme suit :
    ./bin/istioctl install --set profile=asm-multicloud \
     --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
  3. Enfin, revenez à la documentation ASM pour vérifier les composants du plan de contrôle afin de valider votre installation.

Personnaliser l'installation d'ASM

L'installation d'ASM que vous venez d'effectuer est une installation minimale, suffisante pour tester et utiliser Apigee hybrid dans des cas d'utilisation de base. Pour en savoir plus sur la gestion de cas d'utilisation plus avancés, tels que l'ajout, la suppression ou la modification de numéros de port de l'équilibreur de charge, consultez la page Activer les fonctionnalités facultatives.

Résumé

Maintenant, cert-manager et ASM sont installés, et vous êtes prêt à installer l'outil de ligne de commande Apigee hybrid sur votre ordinateur local.

Résumé

Maintenant, cert-manager et ASM sont installés, et vous êtes prêt à installer l'outil de ligne de commande Apigee hybrid sur votre ordinateur local.

123(SUITE) Étape 4 : Installer apigeectl567