Configurer la prise en charge des charges utiles de message volumineuses dans Apigee hybrid

Présentation

Apigee hybrid est compatible avec les charges utiles de messages volumineuses (jusqu'à 30 Mo). La taille de charge utile des messages par défaut est de 10 Mo. Consultez la section Taille de la charge utile des messages.

Pour permettre aux environnements de votre installation hybride de prendre en charge les charges utiles de messages volumineuses, vous devez apporter les modifications suivantes à votre configuration d'exécution :

  • Augmentez la taille du tas de mémoire à 4 Gio.
  • Augmentez les limites de mémoire à 6 Gio.
  • Augmentez les demandes de ressources mémoire à 4 Gi.

Vous pouvez configurer ces paramètres pour des environnements individuels ou pour tous les environnements de votre installation.

Configurer des environnements individuels pour prendre en charge les charges utiles de messages volumineux

Si les proxys configurés pour accepter les charges utiles de messages volumineux n'ont des points de terminaison que dans un ou plusieurs environnements de votre installation, vous pouvez configurer les environnements pour qu'ils acceptent les charges utiles volumineuses. Cela évite d'ajouter de la mémoire supplémentaire aux environnements qui n'auront pas besoin de prendre en charge les charges utiles volumineuses.

Pour configurer des environnements individuels afin qu'ils acceptent les charges utiles de messages volumineux, vous pouvez utiliser les propriétés envs.components.runtime. Apportez les modifications suivantes à votre fichier overrides.yaml :

  1. Ajoutez le stanza suivant à votre fichier overrides.yaml :
    envs:
    - name: ENV_NAME
      components.
        runtime:
          cwcAppend:
            bin_setenv_max_mem: 4096m   # Increase max heap size to 4 gigs
          resources:
            requests:
              memory: 4Gi
            limits:
              memory: 6Gi
    

    Consultez les pages suivantes :

  2. Mettez à niveau le chart apigee-env pour chaque environnement que vous mettez à jour :

    Effectuez un dry run :

    helm upgrade ENV_RELEASE_NAME apigee-env/ \
      --install \
      --namespace APIGEE_NAMESPACE \
      --set env=ENV_NAME \
      -f OVERRIDES_FILE \
      --dry-run=server
    
    • ENV_RELEASE_NAME est un nom utilisé pour suivre l'installation et les mises à niveau du graphique apigee-env. Ce nom doit être unique par rapport aux autres noms de version Helm de votre installation. Il s'agit généralement de la même valeur que ENV_NAME. Toutefois, si votre environnement porte le même nom que votre groupe d'environnements, vous devez utiliser des noms de version différents pour l'environnement et le groupe d'environnements (par exemple, dev-env-release et dev-envgroup-release). Pour en savoir plus sur les versions dans Helm, consultez Trois grands concepts class="external" dans la documentation Helm.
    • ENV_NAME est le nom de l'environnement que vous mettez à niveau.
    • OVERRIDES_FILE est votre fichier overrides.yaml modifié.
  3. Mettez à niveau le graphique :

    Effectuez un dry run :

    helm upgrade ENV_RELEASE_NAME apigee-env/ \
      --install \
      --namespace APIGEE_NAMESPACE \
      --set env=ENV_NAME \
      -f OVERRIDES_FILE
    

Configurer tous les environnements pour qu'ils acceptent les charges utiles de messages volumineux

Les modifications apportées à votre stanza runtime définiront les limites de tas et de mémoire pour tous les environnements de votre installation. Vous pouvez remplacer ces paramètres pour des environnements individuels à l'aide des propriétés envs.components.runtime.

  1. Ajoutez le stanza suivant à votre fichier overrides.yaml :
    runtime:
      cwcAppend:
        bin_setenv_max_mem: 4096m   # Increase max heap size to 4 gigs
      resources:
        requests:
          memory: 4Gi
        limits:
          memory: 6Gi
    

    Consultez les pages suivantes :

  2. Mettez à niveau le chart apigee-env pour chaque environnement de votre installation :

    Effectuez un dry run :

    helm upgrade ENV_RELEASE_NAME apigee-env/ \
      --install \
      --namespace APIGEE_NAMESPACE \
      --set env=ENV_NAME \
      -f OVERRIDES_FILE \
      --dry-run=server
    

    Mettez à niveau le graphique :

    helm upgrade ENV_RELEASE_NAME apigee-env/ \
      --install \
      --namespace APIGEE_NAMESPACE \
      --set env=ENV_NAME \
      -f OVERRIDES_FILE