Questa pagina è stata tradotta dall'API Cloud Translation.

Passaggio 3: installazione di ASM

Installa ASM

Apigee hybrid utilizza la distribuzione Istio fornita con Anthos Service Mesh (ASM). Segui questi passaggi per installare ASM nel cluster.

Versioni di ASM supportate

Per le nuove installazioni ibride della versione 1.4.4, installa ASM versione 1.7.x.
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 innanzitutto seguire i passaggi di configurazione e configurazione specifici per ASM riportati nella documentazione di ASM. Devi quindi tornare qui per completare la configurazione specifica ibrida prima di applicarla al cluster.

Le istruzioni per installare e configurare ASM variano in base alla piattaforma. Scegli di seguito i passaggi per la piattaforma.

GKE

Segui i passaggi di configurazione e 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, dovrai tornare a questa pagina per modificare il file con ulteriori configurazioni specifiche ibride prima di installare/applicare la configurazione.
- Se si tratta di una nuova installazione di Apigee hybrid, installa la versione di ASM 1.7.x. Vai a: Nuova installazione.
- Se esegui l'upgrade da una versione precedente dell'ibrido, utilizza ASM 1.6.x. Vai a: Introduzione all'installazione e alla migrazione.
Una volta completati i passaggi di configurazione e configurazione di ASM, vai alla sezione successiva per completare i passaggi della configurazione ibrida e di installazione di ASM.

Esegui la configurazione ibrida finale e installa ASM

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

Assicurati di essere nella directory root dell'installazione di ASM. Ad esempio: 1.7.3-asm.6.
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

Aggiungi (o aggiorna) la stanza spec:components nel file istio-operator.yaml sotto la sezione meshConfig: e subito sopra values:, dove reserved_static_ip è un indirizzo IP che il gateway in entrata del runtime può utilizzare. Se non hai un indirizzo IP statico riservato, per questo avvio rapido puoi escludere 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 di 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:
    .
    .
    .

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 puoi scegliere, scegli mTLS PERMISSIVO.
Nota: se utilizzi ASM 1.6, ti consigliamo di usare il comando asmctl validate per convalidare la configurazione e l'integrità dei componenti installati. Questo comando è descritto nella sezione della documentazione di ASM relativa alla convalida dell'installazione. Questo comando è valido solo se utilizzi ASM 1.6.

GKE On-Prem

Configurare e scaricare ASM

Utilizza la documentazione di ASM per configurare il tuo ambiente e scaricare ASM.

Leggi attentamente i seguenti passaggi prima di iniziare. Ti chiederemo di eseguire alcuni dei passaggi elencati nella documentazione di ASM, quindi torneremo qui per completare l'installazione.
Vai a Installazione di Anthos Service Mesh on-premise ed esegui tutti i passaggi di ASM, fino alla creazione dello spazio dei nomi istio-system, quindi interrompi e vai alla sezione successiva Applica il manifest di seguito.
Importante: dopo aver completato i passaggi nella sezione Creare lo spazio dei nomi istio-system, interrompi e continua con i passaggi elencati nella sezione successiva. Ti consigliamo di attendere prima di applicare il file manifest finché non ti verrà richiesto di farlo di seguito.

Applicare il manifest

Una volta scaricato e decompresso il file di installazione di ASM, continua con i seguenti passaggi:

Assicurati di trovarti nella directory Istio che hai scaricato e decompresso. Ad esempio: 1.7.3-asm.6.
Esegui questo comando, dove your_static_ip è un indirizzo IP statico che il componente Istio in entrata può utilizzare. Se non hai un indirizzo IP statico prenotato, lascia fuori la riga --set values.gateways.istio-ingressgateway.loadBalancerIP:
```
./bin/istioctl install --set profile=asm-multicloud \
 --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
```
Infine, torna alla documentazione di ASM per verificare 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 i casi d'uso di base. Per informazioni su come gestire casi d'uso più avanzati, come aggiungere, rimuovere o modificare i numeri di porta del bilanciatore del carico, consulta Attivare le funzionalità facoltative.

Riepilogo

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

AKS

Configurare e scaricare ASM

Utilizza la documentazione di ASM per configurare il tuo ambiente e scaricare ASM.

Leggi attentamente i seguenti passaggi prima di iniziare. Ti chiederemo di eseguire alcuni dei passaggi elencati nella documentazione di ASM, quindi torneremo qui per completare l'installazione.
Vai a Installazione di Anthos Service Mesh sui cluster collegati ed esegui tutti i passaggi di ASM, fino alla creazione dello spazio dei nomi istio-system, quindi interrompi l'operazione e vai alla sezione successiva Applica il manifest di seguito.
Importante: dopo aver completato i passaggi nella sezione Creare lo spazio dei nomi istio-system, interrompi e continua con i passaggi elencati nella sezione successiva. Ti consigliamo di attendere prima di applicare il file manifest finché non ti verrà richiesto di farlo di seguito.

Applicare il manifest

Una volta scaricato e decompresso il file di installazione di ASM, continua con i seguenti passaggi:

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

Personalizzazione dell'installazione di ASM

Riepilogo

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

GKE su AWS

Configurare e scaricare ASM

Utilizza la documentazione di ASM per configurare il tuo ambiente e scaricare ASM.

Leggi attentamente i seguenti passaggi prima di iniziare. Ti chiederemo di eseguire alcuni dei passaggi elencati nella documentazione di ASM, quindi torneremo qui per completare l'installazione.
Vai a Installazione di Anthos Service Mesh su GKE su AWS ed esegui tutti i passaggi di ASM fino al download del file di installazione, quindi interrompi l'operazione e vai alla sezione successiva Applica il manifest di seguito.
Importante: dopo aver completato i passaggi nella sezione Scaricare il file di installazione, interrompi e continua con i passaggi elencati nella sezione successiva. Ti consigliamo di attendere prima di applicare il file manifest finché non ti verrà richiesto di farlo di seguito.

Applicare il manifest

Una volta scaricato e decompresso il file di installazione di ASM, continua con i seguenti passaggi:

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

Personalizzazione dell'installazione di ASM

Riepilogo

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

EKS

Configurare e scaricare ASM

Utilizza la documentazione di ASM per configurare il tuo ambiente e scaricare ASM.

Leggi attentamente i seguenti passaggi prima di iniziare. Ti chiederemo di eseguire alcuni dei passaggi elencati nella documentazione di ASM, quindi torneremo qui per completare l'installazione.
Vai a Installazione di Anthos Service Mesh sui cluster collegati ed esegui tutti i passaggi di ASM, fino alla creazione dello spazio dei nomi istio-system, quindi interrompi l'operazione e vai alla sezione successiva Applica il manifest di seguito.
Importante: dopo aver completato i passaggi nella sezione Creare lo spazio dei nomi istio-system, interrompi e continua con i passaggi elencati nella sezione successiva. Ti consigliamo di attendere prima di applicare il file manifest finché non ti verrà richiesto di farlo di seguito.

Applicare il manifest

Una volta scaricato e decompresso il file di installazione di ASM, continua con i seguenti passaggi:

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

Personalizzazione dell'installazione di ASM

Riepilogo

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

Riepilogo

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

1 2 3 (AVANTI) Passaggio 4: installa apigeectl 5 } 6 } 6