Questa pagina è stata tradotta dall'API Cloud Translation.

Gestione del gateway in entrata Apigee

A partire da Apigee hybrid versione 1.8, Apigee hybrid utilizza il gateway Apigee in entrata per fornire il gateway in entrata per l'ibrido.

Configurazione del gateway in entrata Apigee in corso...

Puoi configurare i gateway in entrata in overrides.yaml. Ad esempio:

Sintassi

ingressGateways:
- name: INGRESS_NAME
  replicaCountMin: REPLICAS_MIN
  replicaCountMax: REPLICAS_MAX
  resources:
    requests:
      cpu: CPU_COUNT_REQ
      memory: MEMORY_REQ
    limits:
      cpu: CPU_COUNT_LIMIT
      memory: MEMORY_LIMIT
  svcAnnotations:  # optional. See Known issue 243599452.
    SVC_ANNOTATIONS_KEY: SVC_ANNOTATIONS_VALUE
  svcLoadBalancerIP: SVC_LOAD_BALANCER_IP # optional

Esempio

ingressGateways:
- name: prod1
  replicaCountMin: 2
  replicaCountMax: 100
  resources:
    requests:
      cpu: 1
      memory: 1Gi
    limits:
      cpu: 2
      memory: 2Gi
  svcAnnotations:  # optional. See Known issue 243599452.
    networking.gke.io/load-balancer-type: "Internal"
  svcLoadBalancerIP: 198.252.0.123

INGRESS_NAME è il nome del deployment del gateway in entrata. Può essere qualsiasi nome che soddisfi le i seguenti requisiti:
- Deve avere una lunghezza massima di 17 caratteri
- Contenere solo caratteri alfanumerici minuscoli, "-" o "."
- Inizia con un carattere alfanumerico
- Deve terminare con un carattere alfanumerico
Consulta ingressGateways[].name nel riferimento per le proprietà di configurazione
REPLICAS_MIN e REPLICAS_MAX Il numero minimo e massimo di repliche per il gateway di ingresso Apigee nella tua installazione. Consulta ingressGateways[].replicaCountMin e ingressGateways[].replicaCountMax nel riferimento per le proprietà di configurazione.
CPU_COUNT_REQ e MEMORY_REQ Le richieste di CPU e memoria per ogni del gateway Apigee in entrata nella tua installazione.
Imposta queste proprietà se le hai impostate in precedenza per il gateway di ingresso Anthos Service Mesh, ad esempio nel file overlay.yaml.

Consulta ingressGateways[].resources.requests.cpu e ingressGateways[].resources.requests.memory nel riferimento per le proprietà di configurazione.
CPU_COUNT_LIMIT e MEMORY_LIMIT I limiti massimi di CPU e memoria per ogni replica del gateway di ingresso Apigee nella tua installazione.
Imposta queste proprietà se le hai precedentemente impostate per i tuoi Gateway in entrata di Anthos Service Mesh, ad esempio nel file overlay.yaml.

Consulta: ingressGateways[].resources.limits.cpu e ingressGateways[].resources.limits.memory nel riferimento della proprietà di configurazione.
SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE (facoltativo):
Nota: il campo ingressGateways[].svcAnnotations in overrides.yaml non funziona come previsto. Consulta: Problema noto: 243599452

Si tratta di una coppia chiave-valore che fornisce annotazioni per il servizio di importazione predefinito. Le annotazioni vengono utilizzate dalla piattaforma cloud per aiutarti a configurare l'installazione ibrida, ad esempio impostando il tipo di bilanciatore del carico su interno o esterno. Ad esempio:
```
ingressGateways:
  svcAnnotations:
    networking.gke.io/load-balancer-type: "Internal"
```
Le annotazioni variano da una piattaforma all'altra. Fai riferimento alla tua piattaforma documentazione per le annotazioni obbligatorie e suggerite.

Nota: non è necessario impostare Annotations qui se ne stai creando uno tuo Servizio Kubernetes per il deployment del gateway in entrata come documentato in Esponi il gateway in entrata Apigee.
Consulta ingressGateways[].svcAnnotations nella documentazione di riferimento delle proprietà di configurazione.
SVC_LOAD_BALANCER_IP (facoltativo). Sulle piattaforme che supportano l'indicazione dell'indirizzo IP del bilanciatore del carico, il bilanciatore del carico verrà creato con questo indirizzo IP. Su piattaforme che non ti permettono di specificare l'indirizzo IP del bilanciatore del carico, questa proprietà viene ignorata.
Attenzione:assicurati di non specificare lo stesso indirizzo IP dell'attuale gateway istio in entrata. Ciò potrebbe causare problemi mentre il servizio è ancora nel cluster.

Nota: non è necessario impostare LoadBalancerIP se ne stai creando una personalizzata Servizio Kubernetes per il deployment del gateway in entrata come documentato in Esponi il gateway in entrata Apigee.
Consulta ingressGateways[].svcLoadBalancerIP nella documentazione di riferimento delle proprietà di configurazione.

Applica la configurazione del gateway in entrata Apigee

Applica le modifiche all'ambito dell'organizzazione con apigeectl.

$APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml --org

Attività di gestione

Alcune attività di gestione comuni per il gateway in entrata Apigee:

Interrompi l'invio della configurazione ad ASM

Dopo aver eseguito l'upgrade ad Apigee hybrid v1.8 e aver eseguito la migrazione del traffico al gateway Apigee in entrata, puoi interrompere fornendo la configurazione del routing ad Anthos Service Mesh.

Aggiorna il controller Apigee per interrompere l'aggiornamento degli oggetti CR di Anthos Service Mesh nel server API. Nel file delle sostituzioni, imposta:
```
ao:
  args:
    disableIstioConfigInAPIServer: true
```

Applica le modifiche alla configurazione:

$APIGEECTL_HOME/apigeectl init -f OVERRIDES_FILE

Per maggiori dettagli, consulta ao nel Riferimento per le proprietà di configurazione.

Controlla lo stato del deployment con il seguente comando, perché il comando precedente ha riavviato il controller:
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
Aggiorna virtualhosts. Ogni host virtuale deve includere Etichetta del selettore app con il valore app: apigee-ingressgateway. Con questa modifica, il gateway Anthos Service Mesh non potrà leggere la configurazione di routing di Apigee.

Aggiungi o sostituisci la proprietà selector in ogni host virtuale come segue:
```
virtualhosts:
- name: ENV_GROUP
  selector:
    app: apigee-ingressgateway # required
  ...
```
Applica le modifiche alla configurazione:
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --settings virtualhosts
```
Per ulteriori informazioni, consulta virtualhosts.selector nel riferimento per le proprietà di configurazione.

Scalabilità del gateway in entrata Apigee:

Aggiorna le seguenti proprietà nel file degli override.

ingressGateways[].replicaCountMax
ingressGateways[].replicaCountMin

Vedi ingressGateways nel Informazioni dettagliate sulle proprietà di configurazione.

Applica le modifiche con apigeectl apply --org.

Aggiornamento dell'allocazione delle risorse

Aggiorna le seguenti proprietà nel file delle sostituzioni.

ingressGateways[].resources.limits.cpu
ingressGateways[].resources.limits.memory
ingressGateways[].resources.requests.cpu
ingressGateways[].resources.requests.memory

Per maggiori dettagli, consulta ingressGateways nel Riferimento per le proprietà di configurazione.

Applica le modifiche con apigeectl apply --org.

Aggiornamento del servizio gateway in entrata Apigee in corso...

Aggiorna le seguenti proprietà nel file degli override.

ingressGateways[].svcAnnotations
ingressGateways[].svcLoadBalancerIP

Per maggiori dettagli, consulta ingressGateways nel Riferimento per le proprietà di configurazione.

Applica le modifiche con apigeectl apply --org.

Disabilita il bilanciatore del carico per il servizio gateway di ingresso Apigee predefinito:

Se crei un servizio Kubernetes personalizzato per il deployment del gateway in entrata, puoi disabilitare la creazione di un bilanciatore del carico nell'ambiente predefinito completamente gestito di Kubernetes. Aggiorna il ingressGateways[].svcType a ClusterIP nel file degli override. Ad esempio:

ingressGateways:
  - name: my-ingress-gateway
    replicaCountMin: 2
    replicaCountMax: 10
    svcType: ClusterIP

Applica le modifiche con apigeectl apply --org.

Configurare TLS e mTLS

Vedi Configurare TLS e mTLS sul gateway in entrata.

Abilitazione di client non SNI

Vedi Abilitare client non SNI e HTTP.

Installazione di gateway in entrata Apigee aggiuntivi in corso...

Nel file overrides.yaml puoi aggiungere più gateway di ingresso. La La proprietà di configurazione ingressGateways è un array. Per ulteriori informazioni, vedi ingressGateways nel dominio Riferimento alle proprietà di configurazione.

Ad esempio:

ingressGateways:
- name: fruit
  replicaCountMin: 2
  replicaCountMax: 10

- name: meat
  replicaCountMin: 2
  replicaCountMax: 10

Applica le modifiche con apigeectl apply --org.

Targeting di un traffico Apigee in entrata verso un host virtuale

Puoi scegliere come target un gateway Apigee in entrata etichettato a un host virtuale specifico nel file di override. Questa configurazione specifica il gateway in entrata in cui Apigee applicherà la configurazione dell'host virtuale. Nel seguente esempio, l'host virtuale spam-vh è configurato per utilizzare il gateway in entrata etichettato meat e gli altri due host virtuali utilizzano il gateway in entrata fruit. I gateway in entrata devono essere etichettati correttamente, come spiegato in Installazione di gateway Anthos Service Mesh aggiuntivi.

Nota: devi specificare entrambe le proprietà selector:app e selector:ingress_name per applicare correttamente un gateway in entrata a un host virtuale.

virtualhosts:
- name: spam-vh
  sslCertPath: cert-spam.crt
  sslKeyPath: cert-spam.key
  selector:
    app: apigee-ingressgateway
    ingress_name: meat
- name: banana-vh
  sslCertPath: cert-banana.crt
  sslKeyPath: cert-banana.key
  selector:
    app: apigee-ingressgateway
    ingress_name: fruit
- name: plum-vh
  sslCertPath: cert-plum.crt
  sslKeyPath: cert-plum.key
  selector:
    app: apigee-ingressgateway
    ingress_name: fruit

Domande frequenti

Come funziona con la mia installazione Anthos Service Mesh/Istio esistente in un altro spazio dei nomi?: Finché Apigee è installato in uno spazio dei nomi dedicato, il gateway Apigee in entrata può essere eseguito insieme a un'installazione Anthos Service Mesh/Istio già esistente nel cluster. Il gateway di ingresso Apigee non memorizza alcuna configurazione in apiserver, pertanto non ci saranno conflitti.
Chi è responsabile dell'upgrade dei componenti del gateway di ingresso Apigee?: Gli upgrade dei componenti del gateway di ingresso Apigee sono gestiti da Apigee e vengono eseguiti durante gli upgrade ibridi regolari e le release delle patch.
Come faccio a esporre la porta 80 nel gateway di ingresso Apigee?: La porta 80 non è supportata dal gateway in entrata Apigee. Se esegui la migrazione da Anthos Service Mesh a Gateway di ingresso Apigee e hai seguito le istruzioni riportate nel post della community per attivare la porta 80, questa non funzionerà con il gateway di ingresso Apigee.