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
- Segui i passaggi di configurazione e impostazione di ASM:
- 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
- In ASM 1.7.x:
- Aggiungi (o aggiorna) la stanza
spec:components
nel fileistio-operator.yaml
sotto la sezionemeshConfig:
e immediatamente sopravalues:
, 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: . . .
- 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.
- 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.
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, 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.
- 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.
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, 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.
- 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.
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, 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.
- 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.
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, 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