Passaggio 3: installazione di ASM

Installa 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 ibride della versione 1.4.4, installa la versione 1.7.x di ASM.
  • Per gli upgrade dalle versioni precedenti dell'ibrido, installa ASM versione 1.6.x.

Esegui i passaggi per l'impostazione e la configurazione 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. Devi quindi tornare qui per completare la procedura la configurazione 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 configurazione 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 migliorare la 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. 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, seleziona 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 Anthos Service Mesh on-premise ed eseguire tutti i passaggi di ASM, fino all'inclusione Crea lo spazio dei nomi istio-system, 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 questo comando, dove your_static_ip è un indirizzo IP statico il componente Istio in entrata può usare. 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 Controlla i componenti del piano di controllo per 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 affrontare casi d'uso più avanzati, come Aggiungere, rimuovere o modificare i numeri di porta del bilanciatore del carico, consulta Attivazione delle funzionalità facoltative.

Riepilogo

Ora che cert-manager e ASM sono installati e puoi installare Strumento a riga di comando ibrido Apigee sulla tua macchina locale.

AKS

Configurare e scaricare ASM

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

  1. Leggi attentamente i seguenti passaggi 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 Anthos Service Mesh su cluster collegati ed eseguire tutti i passaggi di ASM, compresi Crea lo spazio dei nomi istio-system, 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.

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 riservato, lascia la --set values.gateways.istio-ingressgateway.loadBalancerIP riga fuori:
    ./bin/istioctl install --set profile=asm-multicloud \
     --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
  3. Infine, torna alla documentazione di ASM Controlla i componenti del piano di controllo per 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

Configurare e scaricare ASM

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

  1. Leggi attentamente i seguenti passaggi 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 Anthos Service Mesh su cluster collegati ed eseguire tutti i passaggi di ASM, compresi Crea lo spazio dei nomi istio-system, 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 cert-manager e ASM sono installati e puoi installare Strumento a riga di comando ibrido Apigee 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 (SUCCESSIVO) Passaggio 4: installa apigeectl 5 6 7