Questa pagina è stata tradotta dall'API Cloud Translation.

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 GKE On-Prem AKS GKE su AWS EKS

Segui i passaggi di configurazione e impostazione di ASM:
Importante: quando segui la documentazione di ASM, non installare o applicare il file di configurazione YAML istio-operator.yaml quando ti viene richiesto. In quel momento, 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 ASM 1.7.x. Vai a: Nuova installazione.
- Se esegui l'upgrade da una versione precedente di hybrid, utilizza ASM 1.6.x. Vai a: Introduzione all'installazione e alla migrazione.
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.

Assicurati di trovarti nella directory principale 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 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 copiareEsempio che mostra il posizionamento

  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

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:
    .
    .
    .

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.
Nota: se utilizzi ASM 1.6, ti consigliamo di utilizzare il comando asmctl validate per convalidare la configurazione e lo stato 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.

Configura e scarica ASM

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

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.
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.
Importante: dopo aver completato i passaggi descritti nella sezione Creare il nome spazio istio-system, interrompi e continua con i passaggi elencati nella sezione successiva. Ti consigliamo di attendere di applicare il file manifest fino a quando non ti verranno fornite le istruzioni di seguito.

Applica il manifest

Dopo aver 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 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
```
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, ad esempio 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.

Configura e scarica ASM

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

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.
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.
Importante: dopo aver completato i passaggi descritti nella sezione Creare il nome spazio istio-system, interrompi e continua con i passaggi elencati nella sezione successiva. Ti consigliamo di attendere di applicare il file manifest fino a quando non ti verranno fornite le istruzioni di seguito.

Applica il manifest

Dopo aver 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 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
```
Infine, torna alla documentazione di ASM per controllare i componenti del piano di controllo e convalidare l'installazione.

Personalizzazione dell'installazione di ASM

Riepilogo

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

Configura e scarica ASM

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

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.
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.
Importante: dopo aver completato i passaggi descritti nella sezione Scarica il file di installazione, interrompi e continua con i passaggi elencati nella sezione successiva. Ti consigliamo di attendere di applicare il file manifest fino a quando non ti verranno fornite le istruzioni di seguito.

Applica il manifest

Dopo aver 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 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
```
Infine, torna alla documentazione di ASM per controllare i componenti del piano di controllo e convalidare l'installazione.

Personalizzazione dell'installazione di ASM

Riepilogo

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

Configura e scarica ASM

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

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.
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.
Importante: dopo aver completato i passaggi descritti nella sezione Creare il nome spazio istio-system, interrompi e continua con i passaggi elencati nella sezione successiva. Ti consigliamo di attendere di applicare il file manifest fino a quando non ti verranno fornite le istruzioni di seguito.

Applica il manifest

Dopo aver 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 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
```
Infine, torna alla documentazione di ASM per controllare i componenti del piano di controllo e convalidare l'installazione.

Personalizzazione dell'installazione di ASM

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