Migrer vers la passerelle d'entrée Apigee

Utilisez cette procédure pour migrer des installations existantes Apigee hybrid v1.8, et les faire passer d'une entrée basée sur Anthos Service Mesh à la passerelle d'entrée Apigee.

Passerelle d'entrée Apigee dans Apigee hybrid version 1.8

Depuis la version 1.8, Apigee hybrid offre une nouvelle fonctionnalité, la passerelle d'entrée Apigee, qui permet de gérer la passerelle d'entrée pour votre installation hybride. Anthos Service Mesh n'est plus une condition préalable à l'installation hybride et Apigee va alors cesser de fournir la configuration de routage à Anthos Service Mesh. Après la mise à niveau, vous devez migrer le trafic vers la nouvelle passerelle d'entrée Apigee.

Deux scénarios sont possibles pour la migration :

Migration multicluster ou multirégionale (recommandée) :
Avant de passer à un nouvel objet Ingress pour Apigee, drainez tout le trafic vers un autre cluster ou une autre région du cluster que vous migrez. Cela vous laissera le temps de vérifier que la nouvelle passerelle d'entrée Apigee fonctionne comme prévu. Déplacez ensuite le trafic vers le cluster mis à jour.
Mise à niveau sur place (non recommandée dans les environnements de production) :
Pendant la mise à niveau, Apigee établit la nouvelle passerelle d'entrée avec une nouvelle adresse IP. Vous pouvez alors vérifier que la nouvelle passerelle d'entrée Apigee fonctionne comme prévu, puis transférer le trafic vers la nouvelle entrée. Il peut y avoir un temps d'arrêt lors de cette mise à niveau.

Installer une passerelle d'entrée Apigee

Pour installer la passerelle d'entrée Apigee, vous devez ajouter la propriété ingressGateways à votre fichier de remplacements.
Syntaxe
```
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
```
Exemple
```
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 : nom du déploiement d'entrée. Il peut s'agir de n'importe quel nom qui répond aux exigences suivantes :
  - Ne pas comporter plus de 17 caractères ;
  - ne contenir que des caractères alphanumériques en minuscules et des caractères '-' ou '.' ;
  - commencer par un caractère alphanumérique ;
  - se terminer par un caractère alphanumérique.
  Consultez la section ingressGateways[].name dans la documentation de référence sur les propriétés de configuration.
- REPLICAS_MIN et REPLICAS_MAX : nombre minimal et nombre maximal d'instances répliquées pour la passerelle d'entrée Apigee dans votre installation. Pour en savoir plus et pour connaître les paramètres par défaut, consultez les sections ingressGateways[].replicaCountMin et ingressGateways[].replicaCountMax dans la documentation de référence sur les propriétés de configuration.
- CPU_COUNT_REQ et MEMORY_REQ : demande de ressources processeur et mémoire pour chaque instance répliquée de la passerelle d'entrée Apigee de votre installation.
  Spécifiez ces propriétés si vous les avez précédemment définies pour votre passerelle d'entrée Anthos Service Mesh, par exemple dans votre fichier overlay.yaml.
  
  Pour en savoir plus et pour connaître les paramètres par défaut, consultez les sections ingressGateways[].resources.requests.cpu et ingressGateways[].resources.requests.memory dans la documentation de référence sur les propriétés de configuration.
- CPU_COUNT_LIMIT et MEMORY_LIMIT : limites maximales de ressources processeur et mémoire pour chaque instance répliquée de la passerelle d'entrée Apigee de votre installation.
  Spécifiez ces propriétés si vous les avez précédemment définies pour votre passerelle d'entrée Anthos Service Mesh, par exemple dans votre fichier overlay.yaml.
  
  Pour en savoir plus et pour connaître les paramètres par défaut, consultez les sections ingressGateways[].resources.limits.cpu et ingressGateways[].resources.limits.memory dans la documentation de référence sur les propriétés de configuration.
- SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE (facultatif) :
  Remarque : Le champ ingressGateways[].svcAnnotations de overrides.yaml ne fonctionne pas comme prévu. Voir Problème connu 243599452
  .
  Il s'agit d'une paire clé-valeur qui fournit des annotations pour votre service d'entrée par défaut. Les annotations sont utilisées par votre plate-forme cloud pour vous aider à configurer votre installation hybride, par exemple pour définir le type d'équilibreur de charge sur interne ou externe. Exemple :
```
ingressGateways:
  svcAnnotations:
    networking.gke.io/load-balancer-type: "Internal"
```
  Les annotations varient selon les plates-formes. Reportez-vous à la documentation de votre plate-forme pour connaître les annotations requises et celles suggérées.
  
  Remarque : Il n'est pas nécessaire de définir Annotations si vous créez votre propre service Kubernetes pour le déploiement d'entrée, comme indiqué sur la page Exposer la passerelle d'entrée Apigee.
  Consultez la section ingressGateways[].svcAnnotations dans la documentation de référence sur les propriétés de configuration.
- SVC_LOAD_BALANCER_IP (facultatif) : vous permet d'attribuer une adresse IP statique à votre équilibreur de charge. Sur les plates-formes compatibles avec la spécification de l'adresse IP de l'équilibreur de charge, celui-ci est défini avec cette adresse IP. Sur les plates-formes qui ne vous permettent pas de spécifier l'adresse IP de l'équilibreur de charge, cette propriété est ignorée.
  Si aucune adresse IP statique n'est allouée à votre équilibreur de charge, omettez cette propriété dans votre fichier de remplacements.
  
  Attention : Veillez à ne pas spécifier la même adresse IP que celle de la passerelle istio-ingressgateway actuelle. Cela peut poser des problèmes tant que ce service est toujours sur le cluster.
  Remarque : Il n'est pas nécessaire de définir LoadBalancerIP si vous créez votre propre service Kubernetes pour le déploiement d'entrée, comme indiqué sur la page Exposer la passerelle d'entrée Apigee.
  Consultez la section ingressGateways[].svcLoadBalancerIP dans la documentation de référence sur les propriétés de configuration.
Appliquez les modifications pour installer la passerelle d'entrée Apigee à l'aide des commandes suivantes :
```
$APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml
```

Basculer le trafic vers la passerelle d'entrée Apigee

Pour migrer le trafic d'Anthos Service Mesh vers la passerelle d'entrée Apigee, suivez les étapes décrites dans la section Passer du trafic d'Anthos Service Mesh à la passerelle d'entrée Apigee dans la section Mise à niveau vers Apigee hybrid v1.8.