Passaggio 2: installazione di cert-manager e ASM

Attualmente stai visualizzando la versione 1.3 della documentazione di Apigee hybrid. This version is end of life. You should upgrade to a newer version. Per ulteriori informazioni, consulta Versioni supportate.

Version 1.3 (unsupported)

   Supported versions:

• v1.15 (latest)                        
• v1.14                        
• v1.13                         
• List of supported versions

   Unsupported versions:

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

Questo passaggio spiega come scaricare e installare cert-manager e Anthos Service Mesh (ASM), necessari per il funzionamento di Apigee hybrid.

Installa cert-manager

Utilizza uno dei due comandi seguenti per installare cert-manager v0.14.2 da GitHub. Per trovare la tua versione di Kubernetes, utilizza il comando kubectl version.

• Se hai Kubernetes 1.15 o versioni successive:

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

• Versioni di Kubernetes precedenti alla 1.15:

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

Dovresti visualizzare una risposta che indica che sono stati creati lo spazio dei nomi cert-manager e diverse risorse cert-manager.

Installare ASM

Apigee Hybrid utilizza la distribuzione Istio fornita con Anthos Service Mesh (ASM). Per installare ASM nel cluster, segui questi passaggi.

Versioni di ASM supportate

Per le nuove installazioni di ibrido, installa ASM 1.6.x nel cluster. Se esegui l'upgrade dalla versione 1.2.x di Apigee hybrid, installa la versione 1.5.x di ASM nel cluster.

Esegui i passaggi di configurazione di ASM

Per completare l'installazione di ASM, devi prima seguire i passaggi di configurazione specifici di ASM nella documentazione di ASM. Poi, devi tornare qui per completare la configurazione specifica per l'ibrido prima di applicarla al cluster.

1. Segui i passaggi di configurazione di ASM:
   Importante: quando segui la documentazione di ASM, non installare o applicare il file di configurazione YAML istio-operator.yaml quando ti viene chiesto di farlo. A quel punto, ti chiediamo di tornare a questa pagina per modificare il file con ulteriori configurazioni specifiche per l'ibrido prima di installare/applicare la configurazione.
   • Se si tratta di una nuova installazione di Apigee hybrid, installa la versione di ASM 1.6.x. Vai a: Introduzione all'installazione e alla migrazione.
   • Se esegui l'upgrade da una versione precedente di ibrido, utilizza ASM 1.5.x. Vai a: Installazione di Anthos Service Mesh su un cluster esistente.

2. Dopo aver completato i passaggi di configurazione e configurazione di ASM, vai alla sezione successiva per completare i passaggi di configurazione ibrida e installazione di ASM.

Esegui la configurazione ibrida finale e installa ASM

Infine, aggiungi configurazioni specifiche per l'ibrido al file istio-operator.yaml e installa ASM.

1. Assicurati di trovarti nella directory principale dell'installazione di ASM. Ad esempio: 1.6.11-asm.1.
2. Apri il file ./asm/cluster/istio-operator.yaml in un editor.
3. Aggiungi le seguenti righe con rientro sotto spec.meshConfig::

   Testo da copiare

       # 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)%"}'

   Nota:il valore di enableAutoMtls deve essere impostato su false.

   Esempio che mostra il posizionamento

   Interruzioni di riga inserite per una maggiore leggibilità

   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. Aggiungi (o aggiorna) la sezione spec:components nel file istio-operator.yaml sotto la sezione meshConfig: e immediatamente sopra values:, dove reserved_static_ip è l'indirizzo IP che hai riservato per il gateway di ingresso runtime in Configurazione del progetto e dell'organizzazione - Passaggio 5: configura Cloud DNS.

   Testo da copiare

       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
   

   Nota:il valore di enableAutoMtls deve essere impostato su false.

   Esempio che mostra il posizionamento

   Interruzioni di riga inserite per una maggiore leggibilità

   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. Torna alla documentazione di ASM che hai utilizzato in precedenza e completa l'installazione di ASM (installa o applica il file istio-operator.yaml al cluster). Quando ti viene data la possibilità di scegliere, seleziona mTLS permissivo.

Riepilogo

Ora hai installato cert-manager e ASM e puoi installare lo strumento a riga di comando Apigee Hybrid sulla tua macchina locale.

1 2 (NEXT) Step 3: Install apigeectl 4 5