Étape 3 : Installer ASM

Vous consultez actuellement la version 1.4 de la documentation d'Apigee hybrid. This version is end of life. You should upgrade to a newer version. Pour en savoir plus, consultez la section Versions compatibles.

Version 1.4 (unsupported)

   Versions compatibles :

• v1.13 (la plus récente)
• v1.12
• v1.11                         
• Liste des versions compatibles

   Versions non compatibles :

• v1.10
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

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 :

La configuration suivante suppose que les clients seront compatibles avec l'extension SNI par défaut. Dans le cas contraire, consultez les instructions permettant d'activer les clients non SNI et HTTP.

GKE

1. Suivez la procédure d'installation et de configuration d'ASM :
   Important : Lorsque vous suivez la documentation d'ASM, n'installez pas et n'appliquez pas le fichier de configuration YAML istio-operator.yaml lorsque vous y êtes invité. À cette étape, vous devez revenir sur cette page pour modifier le fichier avec des configurations spécifiques hybrides supplémentaires avant d'installer ou d'appliquer la configuration.
   • S'il s'agit d'une nouvelle installation d'Apigee hybrid, installez la version 1.7.x d'ASM. Accédez à Nouvelle installation.
   • Si vous effectuez une mise à niveau à partir d'une version précédente d'environnement hybride, utilisez ASSM 1.6.x. Accédez à l'article Présentation de l'installation et de la migration.

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.
   Remarque : Si vous utilisez ASM 1.6, nous vous recommandons d'exécuter la commande asmctl validate pour valider la configuration et l'état des composants installés. Cette commande est décrite dans la section de la documentation d'ASM concernant la validation de l'installation. Cette commande n'est valide que si vous utilisez ASM 1.6.

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.
   Important : Après avoir suivi la procédure décrite dans la section Créer l'espace de noms istio-system, arrêtez-vous et suivez les étapes décrites dans la section ci-dessous. Nous vous recommandons d'attendre d'y être invité ci-dessous avant d'appliquer le fichier manifeste.

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.
   Important : Après avoir suivi la procédure décrite dans la section Créer l'espace de noms istio-system, arrêtez-vous et suivez les étapes décrites dans la section ci-dessous. Nous vous recommandons d'attendre d'y être invité ci-dessous avant d'appliquer le fichier manifeste.

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.
   Important : Après avoir suivi la procédure décrite dans la section Télécharger le fichier d'installation, arrêtez-vous et suivez les étapes décrites dans la section ci-dessous. Nous vous recommandons d'attendre d'y être invité ci-dessous avant d'appliquer le fichier manifeste.

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.
   Important : Après avoir suivi la procédure décrite dans la section Créer l'espace de noms istio-system, arrêtez-vous et suivez les étapes décrites dans la section ci-dessous. Nous vous recommandons d'attendre d'y être invité ci-dessous avant d'appliquer le fichier manifeste.

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.

1 2 3 (SUIVANT) Étape 4 : Installer apigeectl 5 6 7