A Apigee híbrida oferece suporte a payloads de mensagens grandes de até 30 MB. O tamanho padrão do payload da mensagem é de 10 MB. Consulte Tamanho do payload da mensagem.
Para ativar ambientes na sua instalação híbrida e oferecer suporte a payloads de mensagens grandes, faça as seguintes mudanças na configuração do ambiente de execução:
Aumente o tamanho do heap para 4Gi.
Aumente os limites de memória para 6Gi.
Aumente as solicitações de recursos de memória para 4Gi.
É possível configurar essas opções para ambientes individuais ou para todos os ambientes na sua instalação.
Configurar ambientes individuais para oferecer suporte a payloads de mensagens grandes
Se os proxies configurados para oferecer suporte a grandes payloads de mensagens tiverem endpoints em apenas um ou alguns ambientes na sua instalação, configure os ambientes para oferecer suporte a grandes payloads. Isso evita adicionar mais memória a ambientes que não precisam oferecer suporte a payloads grandes.
Para configurar ambientes individuais para oferecer suporte a grandes payloads de mensagens, use as propriedades envs.components.runtime. Faça as seguintes mudanças no arquivo overrides.yaml:
Adicione a seguinte estrofe ao arquivo overrides.yaml:
ENV_RELEASE_NAME é um nome usado para acompanhar a instalação e os upgrades do gráfico apigee-env. Ele precisa ser diferente dos outros nomes de versão do Helm na sua instalação.
Normalmente, é o mesmo que ENV_NAME. No entanto, se o ambiente tiver o mesmo nome do grupo de ambientes, use nomes de lançamento diferentes para o ambiente e o grupo de ambientes, por exemplo, dev-env-release e dev-envgroup-release. Para mais informações sobre versões
no Helm, consulte Três grandes conceitos class="external" na
documentação do Helm.
ENV_NAME é o nome do ambiente que você está fazendo upgrade.
OVERRIDES_FILE é o arquivo overrides.yaml editado.
Configurar todos os ambientes para oferecer suporte a payloads de mensagens grandes
As mudanças na sua seção runtime definem os limites de heap e memória para todos os ambientes na instalação. É possível substituir essas configurações em ambientes individuais com as propriedades envs.components.runtime.
Adicione a seguinte estrofe ao arquivo overrides.yaml:
runtime:
cwcAppend:
bin_setenv_max_mem: 4096m # Increase max heap size to 4 gigs
resources:
requests:
memory: 4Gi
limits:
memory: 6Gi
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-21 UTC."],[],[],null,["# Configure large message payload support in Apigee hybrid\n\nOverview\n--------\n\n\nApigee hybrid supports large message payloads up to 30MB. The default message payload size is 10MB. See [Message payload size](/apigee/docs/api-platform/fundamentals/best-practices-api-proxy-design-and-development#size).\n\n\nTo enable environments in your hybrid installation to support large message payloads, you need to make the following changes to your runtime configuration:\n\n- Increase the heap size to at least 4Gi.\n- Increase memory limits to at least 6Gi.\n- Increase memory resource requests to at least 4Gi.\n\n| **Note:** Resources for memory depend on how much head room exists on your nodes.\n\nYou can configure these settings for individual environments or for all environments in your installation.\n\nConfigure individual environments to support large message payloads\n-------------------------------------------------------------------\n\n\nIf the proxies configured to support large message payloads have endpoints in only one or a few environments in your installation, you can configure the environments to support large payloads. This avoids adding additional memory to environments that will not need to support large payloads.\n\n\nTo configure individual environments to support large message payloads, you can use the `envs.components.runtime` properties. Make the following changes to your `overrides.yaml` file:\n\n1. Add the following stanza to your `overrides.yaml` file: \n\n ```\n envs:\n - name: ENV_NAME\n components.\n runtime:\n cwcAppend:\n bin_setenv_max_mem: 4096m # Increase max heap size to 4 gigs\n resources:\n requests:\n memory: 4Gi\n limits:\n memory: 6Gi\n ```\n | **Important:** You must set values for both [`envs.components.runtime.resources.limits.memory`](/apigee/docs/hybrid/v1.15/config-prop-ref#envs-comoponents-runtime-resources-limits-memory) and [`envs[].components.runtime.resources.requests.memory`](/apigee/docs/hybrid/v1.15/config-prop-ref#envs-comoponents-runtime-resources-requests-memory) for this environment. Setting either of the properties for this environment causes Apigee not to use the values of:\n | - [`runtime.resources.limits.memory`](/apigee/docs/hybrid/v1.15/config-prop-ref#runtime-resources-limits-memory)\n | - [`runtime.resources.requests.memory`](/apigee/docs/hybrid/v1.15/config-prop-ref#runtime-resources-requests-memory)\n\n See:\n - [`envs.components.runtime.resources.limits.memory`](/apigee/docs/hybrid/v1.15/config-prop-ref#envs-comoponents-runtime-resources-limits-memory)\n - [`envs.components.runtime.resources.requests.memory`](/apigee/docs/hybrid/v1.15/config-prop-ref#envs-comoponents-runtime-resources-requests-memory)\n2. Upgrade the `apigee-env` chart for each environment you are updating:\n\n Dry run: \n\n ```\n helm upgrade ENV_RELEASE_NAME apigee-env/ \\\n --install \\\n --namespace APIGEE_NAMESPACE \\\n --set env=ENV_NAME \\\n -f OVERRIDES_FILE \\\n --dry-run=server\n ```\n - \u003cvar translate=\"no\"\u003eENV_RELEASE_NAME\u003c/var\u003e is a name used to keep track of installation and upgrades of the `apigee-env` chart. This name must be unique from the other Helm release names in your installation. Usually this is the same as \u003cvar translate=\"no\"\u003eENV_NAME\u003c/var\u003e. However, if your environment has the same name as your environment group, you must use different release names for the environment and environment group, for example `dev-env-release` and `dev-envgroup-release`. For more information on releases in Helm, see [Three big concepts class=\"external\"](https://helm.sh/docs/intro/using_helm/#three-big-concepts) in the Helm documentation.\n - \u003cvar translate=\"no\"\u003eENV_NAME\u003c/var\u003e is the name of the environment you are upgrading.\n - \u003cvar translate=\"no\"\u003eOVERRIDES_FILE\u003c/var\u003e is your edited `overrides.yaml` file.\n3. Upgrade the chart: Dry run:\n\n ```\n helm upgrade ENV_RELEASE_NAME apigee-env/ \\\n --install \\\n --namespace APIGEE_NAMESPACE \\\n --set env=ENV_NAME \\\n -f OVERRIDES_FILE\n ```\n\nConfigure all environments to support large message payloads\n------------------------------------------------------------\n\n\nChanges to your `runtime` stanza will set the heap and memory limits for all environments in your installation. You can override these settings for individual environments with the `envs.components.runtime` properties.\n\n1. Add the following stanza to your `overrides.yaml` file: \n\n ```\n runtime:\n cwcAppend:\n bin_setenv_max_mem: 4096m # Increase max heap size to 4 gigs\n resources:\n requests:\n memory: 4Gi\n limits:\n memory: 6Gi\n ```\n\n See:\n - [`runtime.resources.limits.memory`](/apigee/docs/hybrid/v1.15/config-prop-ref#runtime-resources-limits-memory)\n - [`runtime.resources.requests.memory`](/apigee/docs/hybrid/v1.15/config-prop-ref#runtime-resources-requests-memory)\n2. Upgrade the `apigee-env` chart for each environment in your installation:\n\n Dry run: \n\n ```\n helm upgrade ENV_RELEASE_NAME apigee-env/ \\\n --install \\\n --namespace APIGEE_NAMESPACE \\\n --set env=ENV_NAME \\\n -f OVERRIDES_FILE \\\n --dry-run=server\n ```\n\n Upgrade the chart: \n\n ```\n helm upgrade ENV_RELEASE_NAME apigee-env/ \\\n --install \\\n --namespace APIGEE_NAMESPACE \\\n --set env=ENV_NAME \\\n -f OVERRIDES_FILE\n ```"]]
