Passaggio 3: installazione di ASM

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

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.

Le istruzioni per installare e configurare ASM variano a seconda della piattaforma. Scegli i passaggi per la tua piattaforma di seguito.

GKE

  1. Segui i passaggi di configurazione di ASM:
  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.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 sezione spec:components nel file istio-operator.yaml sotto la sezione meshConfig: e immediatamente sopra values:, dove reserved_static_ip è un indirizzo IP che il gateway di ingresso del runtime può utilizzare. Se non hai un indirizzo IP statico riservato, per questo Avvio rapido 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. 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 hai la possibilità di scegliere, seleziona mTLS PERMISSIVE.

GKE On-Prem

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 verrà chiesto di eseguire alcuni 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 Creazione dello spazio dei nomi istio-system incluso, 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 decompressa. Ad esempio: 1.7.3-asm.6.
  2. Esegui il seguente comando, dove your_static_ip è un indirizzo IP statico che il componente di ingresso Istio può utilizzare. Se non hai prenotato un indirizzo IP statico, lascia 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 control plane per convalidare l'installazione.

Personalizzazione dell'installazione di ASM

L'installazione di ASM appena eseguita è 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, ad esempio aggiungere, rimuovere o modificare i numeri di porta del bilanciatore del carico, vedi Attivazione delle funzionalità facoltative.

Riepilogo

Ora hai installato cert-manager e ASM e puoi installare lo strumento a riga di comando Apigee Hybrid 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 verrà chiesto di eseguire alcuni 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 Creazione dello spazio dei nomi istio-system incluso, 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 decompressa. Ad esempio: 1.7.3-asm.6.
  2. Esegui il seguente comando, dove your_static_ip è un indirizzo IP statico che il componente di ingresso Istio può utilizzare. Se non hai prenotato un indirizzo IP statico, lascia la riga --set values.gateways.istio-ingressgateway.loadBalancerIP fuori:
    ./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 control plane per convalidare l'installazione.

Personalizzazione dell'installazione di ASM

L'installazione di ASM appena eseguita è 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, ad esempio aggiungere, rimuovere o modificare i numeri di porta del bilanciatore del carico, vedi Attivazione delle funzionalità facoltative.

Riepilogo

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

GKE su AWS

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 verrà chiesto di eseguire alcuni 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 Download the installation file incluso, poi interrompi e vai alla sezione successiva Apply the 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 decompressa. Ad esempio: 1.7.3-asm.6.
  2. Esegui il seguente comando, dove your_static_ip è un indirizzo IP statico che il componente di ingresso Istio può utilizzare. Se non hai prenotato un indirizzo IP statico, lascia la riga --set values.gateways.istio-ingressgateway.loadBalancerIP fuori:
    ./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 control plane per convalidare l'installazione.

Personalizzazione dell'installazione di ASM

L'installazione di ASM appena eseguita è 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, ad esempio aggiungere, rimuovere o modificare i numeri di porta del bilanciatore del carico, vedi Attivazione delle funzionalità facoltative.

Riepilogo

Ora hai installato cert-manager e ASM e 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 verrà chiesto di eseguire alcuni 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 Creazione dello spazio dei nomi istio-system incluso, 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 decompressa. Ad esempio: 1.7.3-asm.6.
  2. Esegui il seguente comando, dove your_static_ip è un indirizzo IP statico che il componente di ingresso Istio può utilizzare. Se non hai prenotato un indirizzo IP statico, lascia la riga --set values.gateways.istio-ingressgateway.loadBalancerIP fuori:
    ./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 control plane per convalidare l'installazione.

Personalizzazione dell'installazione di ASM

L'installazione di ASM appena eseguita è 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, ad esempio aggiungere, rimuovere o modificare i numeri di porta del bilanciatore del carico, vedi Attivazione delle funzionalità facoltative.

Riepilogo

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

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 3 (NEXT) Step 4: Install apigeectl 5 6 7