Passaggio 3: installazione di ASM

Installa ASM

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

Versioni di ASM supportate

  • Per le nuove installazioni ibride della versione 1.4.4, installa la versione 1.7.x di ASM.
  • Per gli upgrade da versioni precedenti di ibrida, installa la versione 1.6.x di ASM.

Esegui i passaggi di configurazione e impostazione di ASM

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

Le istruzioni per installare e configurare ASM variano a seconda della piattaforma. Scegli la procedura per la tua piattaforma tra quelle riportate di seguito.

GKE

  1. Segui i passaggi di configurazione e impostazione di ASM:
  2. Una volta completati i passaggi di configurazione e installazione di ASM, vai alla sezione successiva per completare la configurazione ibrida e i passaggi di 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.7.3-asm.6.
  2. Apri il file istio-operator.yaml in un editor.
    • In ASM 1.7.x: ./asm/istio/istio-operator.yaml
    • In ASM 1.6.x: ./asm/cluster/istio-operator.yaml
  3. Aggiungi (o aggiorna) la stanza spec:components nel file istio-operator.yaml sotto la sezione meshConfig: e immediatamente sopra values:, dove reserved_static_ip è un indirizzo IP che può essere utilizzato dal gateway di ingresso di runtime. Se non hai un indirizzo IP statico riservato, per questa guida rapida puoi omettere la proprietà LoadBalancerIP.

    Testo da copiare

      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
    

    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:
        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. Ora 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). Se utilizzi ASM 1.6 e ti viene data la possibilità di scegliere, scegli PERMISSIVE mTLS.

GKE On-Prem

Configura e scarica ASM

Utilizza la documentazione di ASM per configurare l'ambiente e scaricare ASM.

  1. Leggi attentamente i passaggi che seguono prima di iniziare. Ti chiederemo di eseguire alcuni dei passaggi elencati nella documentazione di ASM, quindi torna qui per completare l'installazione.
  2. Vai a Installazione di Anthos Service Mesh on-premise ed esegui tutti i passaggi di ASM fino a Crea il nome di spazio istio-system, poi interrompi e vai alla sezione successiva Applica il manifest di seguito.

Applica il manifest

Dopo aver scaricato e decompresso il file di installazione di ASM, continua con i seguenti passaggi:

  1. Assicurati di trovarti nella directory Istio che hai scaricato e decompresso. Ad esempio: 1.7.3-asm.6.
  2. Esegui il seguente comando, dove your_static_ip è un indirizzo IP statico che il componente Istio Ingress può utilizzare. Se non hai un indirizzo IP statico prenotato, lascia vuota la riga--set values.gateways.istio-ingressgateway.loadBalancerIP:
    ./bin/istioctl install --set profile=asm-multicloud \
     --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
  3. Infine, torna alla documentazione di ASM per controllare i componenti del piano di controllo e convalidare l'installazione.

Personalizzazione dell'installazione di ASM

L'installazione di ASM che hai appena eseguito è un'installazione minima, sufficiente per testare e utilizzare Apigee hybrid per casi d'uso di base. Per informazioni su come gestire casi d'uso più avanzati, come l'aggiunta, la rimozione o la modifica dei numeri di porta del bilanciatore del carico, consulta Attivare le funzionalità facoltative.

Riepilogo

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

AKS

Configura e scarica ASM

Utilizza la documentazione di ASM per configurare l'ambiente e scaricare ASM.

  1. Leggi attentamente i passaggi che seguono prima di iniziare. Ti chiederemo di eseguire alcuni dei passaggi elencati nella documentazione di ASM, quindi torna qui per completare l'installazione.
  2. Vai a Installazione di Anthos Service Mesh sui cluster collegati ed esegui tutti i passaggi di ASM fino a Crea lo spazio dei nomi istio-system, poi interrompi e vai alla sezione successiva Applica il manifest di seguito.

Applica il manifest

Dopo aver scaricato e decompresso il file di installazione di ASM, continua con i seguenti passaggi:

  1. Assicurati di trovarti nella directory Istio che hai scaricato e decompresso. Ad esempio: 1.7.3-asm.6.
  2. Esegui il seguente comando, dove your_static_ip è un indirizzo IP statico che il componente Istio Ingress può utilizzare. Se non hai un indirizzo IP statico prenotato, lascia vuota la riga--set values.gateways.istio-ingressgateway.loadBalancerIP:
    ./bin/istioctl install --set profile=asm-multicloud \
     --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
  3. Infine, torna alla documentazione di ASM per controllare i componenti del piano di controllo e convalidare l'installazione.

Personalizzazione dell'installazione di ASM

L'installazione di ASM che hai appena eseguito è un'installazione minima, sufficiente per testare e utilizzare Apigee hybrid per casi d'uso di base. Per informazioni su come gestire casi d'uso più avanzati, come l'aggiunta, la rimozione o la modifica dei numeri di porta del bilanciatore del carico, consulta Attivare le funzionalità facoltative.

Riepilogo

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

GKE su AWS

Configura e scarica ASM

Utilizza la documentazione di ASM per configurare l'ambiente e scaricare ASM.

  1. Leggi attentamente i passaggi che seguono prima di iniziare. Ti chiederemo di eseguire alcuni dei passaggi elencati nella documentazione di ASM, quindi torna qui per completare l'installazione.
  2. Vai a Installazione di Anthos Service Mesh su GKE su AWS ed esegui tutti i passaggi di ASM fino a Scarica il file di installazione, quindi interrompi e vai alla sezione successiva Applica il manifest di seguito.

Applica il manifest

Dopo aver scaricato e decompresso il file di installazione di ASM, continua con i seguenti passaggi:

  1. Assicurati di trovarti nella directory Istio che hai scaricato e decompresso. Ad esempio: 1.7.3-asm.6.
  2. Esegui il seguente comando, dove your_static_ip è un indirizzo IP statico che il componente Istio Ingress può utilizzare. Se non hai un indirizzo IP statico prenotato, lascia vuota la riga--set values.gateways.istio-ingressgateway.loadBalancerIP:
    ./bin/istioctl install --set profile=asm-multicloud \
     --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
  3. Infine, torna alla documentazione di ASM per controllare i componenti del piano di controllo e convalidare l'installazione.

Personalizzazione dell'installazione di ASM

L'installazione di ASM che hai appena eseguito è un'installazione minima, sufficiente per testare e utilizzare Apigee hybrid per casi d'uso di base. Per informazioni su come gestire casi d'uso più avanzati, come l'aggiunta, la rimozione o la modifica dei numeri di porta del bilanciatore del carico, consulta Attivare le funzionalità facoltative.

Riepilogo

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

EKS

Configura e scarica ASM

Utilizza la documentazione di ASM per configurare l'ambiente e scaricare ASM.

  1. Leggi attentamente i passaggi che seguono prima di iniziare. Ti chiederemo di eseguire alcuni dei passaggi elencati nella documentazione di ASM, quindi torna qui per completare l'installazione.
  2. Vai a Installazione di Anthos Service Mesh sui cluster collegati ed esegui tutti i passaggi di ASM fino a Crea lo spazio dei nomi istio-system, poi interrompi e vai alla sezione successiva Applica il manifest di seguito.

Applica il manifest

Dopo aver scaricato e decompresso il file di installazione di ASM, continua con i seguenti passaggi:

  1. Assicurati di trovarti nella directory Istio che hai scaricato e decompresso. Ad esempio: 1.7.3-asm.6.
  2. Esegui il seguente comando, dove your_static_ip è un indirizzo IP statico che il componente Istio Ingress può utilizzare. Se non hai un indirizzo IP statico prenotato, lascia vuota la riga--set values.gateways.istio-ingressgateway.loadBalancerIP:
    ./bin/istioctl install --set profile=asm-multicloud \
     --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
  3. Infine, torna alla documentazione di ASM per controllare i componenti del piano di controllo e convalidare l'installazione.

Personalizzazione dell'installazione di ASM

L'installazione di ASM che hai appena eseguito è un'installazione minima, sufficiente per testare e utilizzare Apigee hybrid per casi d'uso di base. Per informazioni su come gestire casi d'uso più avanzati, come l'aggiunta, la rimozione o la modifica dei numeri di porta del bilanciatore del carico, consulta Attivare le funzionalità facoltative.

Riepilogo

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

Riepilogo

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

1 2 3 (PASSAGGIO SUCCESSIVO) Passaggio 4: installa apigeectl 5 6 7