Étape 2 : Installer cert-manager et ASM

Vous consultez actuellement la version 1.3 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.3 (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                                         

Cette page explique comment télécharger et installer cert-manager et Anthos Service Mesh (ASM), qui sont nécessaires au fonctionnement d'Apigee hybrid.

Installer cert-manager

Utilisez l'une des deux commandes suivantes pour installer cert-manager v0.14.2 à partir de GitHub. Pour trouver votre version de Kubernetes, utilisez la commande kubectl version.

• Si vous disposez de Kubernetes 1.15 ou version ultérieure :

  kubectl apply --validate=false -f https://github.com/jetstack/cert-manager/releases/download/v0.14.2/cert-manager.yaml

• Versions antérieures à Kubernetes 1.15 :

  kubectl apply --validate=false -f https://github.com/jetstack/cert-manager/releases/download/v0.14.2/cert-manager-legacy.yaml

Une réponse indiquant que l'espace de noms cert-manager et plusieurs ressources cert-manager ont été créés doit s'afficher.

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 hybrides, installez ASM 1.6.x dans votre cluster. Si vous effectuez une mise à niveau à partir de la version hybride 1.2.x, installez ASM version 1.5.x dans votre cluster.

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.

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.6.x d'ASM. Accédez à l'article Présentation de l'installation et de la migration.
   • Si vous effectuez une mise à niveau à partir d'une version antérieure, utilisez ASM 1.5.x. Accédez à la page Installer Anthos Service Mesh sur un cluster existant.

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.6.11-asm.1.
2. Ouvrez le fichier ./asm/cluster/istio-operator.yaml dans un éditeur.
3. Ajoutez les lignes suivantes en retrait sous spec.meshConfig: :

   Texte à copier

       # This disables Istio from configuring workloads for mTLS if TLSSettings are not specified. 1.4 defaulted to false.
       enableAutoMtls: false
       accessLogFile: "/dev/stdout"
       accessLogEncoding: 1
       # This is Apigee's custom access log format. Changes should not be made to this
       # unless first working with the Data and AX teams as they parse these logs for
       # SLOs.
       accessLogFormat: '{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)%
         %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'

   Remarque : La valeur de enableAutoMtls doit être définie sur false.

   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:
       # This disables Istio from configuring workloads for mTLS if TLSSettings are not specified.
       # 1.4 defaulted to false.
       enableAutoMtls: false
       accessLogFile: "/dev/stdout"
       accessLogEncoding: 1
       # This is Apigee's custom access log format. Changes should not be made to this
       # unless first working with the Data and AX teams as they parse these logs for
       # SLOs.
       accessLogFormat: '{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE
         _ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:
         METHOD)%
         %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RE
         SPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIV
         ED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response
         _flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_serv
         ice_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%
         ","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_
         path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol
         ":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_S
         ERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'
       defaultConfig:
         proxyMetadata:
           GCP_METADATA: "hybrid-example|123456789123|example-cluster|us-central1" #
             {"$ref":"#/definitions/io.k8s.cli.substitutions.gke-metadata"}

4. 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 correspond à l'adresse IP que vous avez réservée pour votre passerelle d'entrée d'exécution dans Configuration du projet et de l'organisation – Étape 5 : Configurer Cloud DNS.

   Texte à copier

       ingressGateways:
       - name: istio-ingressgateway
         enabled: true
         k8s:
           service:
             type: LoadBalancer
             loadBalancerIP: reserved_static_ip
             ports:
             - name: status-port
               port: 15020
               targetPort: 15020
             - name: http2
               port: 80
               targetPort: 80
             - name: https
               port: 443
             - name: prometheus
               port: 15030
               targetPort: 15030
             - name: tcp
               port: 31400
               targetPort: 31400
             - name: tls
               port: 15443
               targetPort: 15443
   

   Remarque : La valeur de enableAutoMtls doit être définie sur false.

   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:
       # This disables Istio from configuring workloads for mTLS if TLSSettings are not specified.
       # 1.4 defaulted to false.
       enableAutoMtls: false
       accessLogFile: "/dev/stdout"
       accessLogEncoding: 1
       # This is Apigee's custom access log format. Changes should not be made to this
       # unless first working with the Data and AX teams as they parse these logs for
       # SLOs.
       accessLogFormat: '{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE
         _ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:
         METHOD)%
         %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RE
         SPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIV
         ED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response
         _flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_serv
         ice_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%
         ","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_
         path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol
         ":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_S
         ERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'
       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: 15020
               targetPort: 15020
             - name: http2
               port: 80
               targetPort: 80
             - name: https
               port: 443
             - name: prometheus
               port: 15030
               targetPort: 15030
             - name: tcp
               port: 31400
               targetPort: 31400
             - name: tls
               port: 15443
               targetPort: 15443
           hpaSpec:
             maxReplicas: 2
     values:
       .
       .
       .

5. 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). Choisissez le mode mTLS PERMISSIVE lorsque vous y êtes invité.

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 (SUIVANT) Étape 3: Installer apigeectl 4 5