Variáveis globais
As variáveis globais controlam ações em cada fase do processo de implantação do Commerce: compilação, implantação e pós-implantação. Como as variáveis globais afetam cada fase, você deve defini-las no estágio global
do arquivo .magento.env.yaml
:
stage:
global:
GLOBAL_VARIABLE_NAME: value
Para obter mais informações sobre como personalizar o processo de criação e implantação:
ENABLE_EVENTING
- Padrão-Não definido
- Versão — Adobe Commerce 2.4.5 e posterior
Quando definido como true
, habilita o cron para executar consumidores da fila de mensagens. Os Adobe I/O Eventos para Adobe Commerce usam filas de mensagens para agilizar a entrega de eventos críticos.
A Adobe recomenda que você também adicione a variável CRON_CONSUMERS_RUNNER
ao estágio deploy
do arquivo .magento.env.yaml
com cron_run
definido como true
.
O exemplo a seguir mostra uma variável ENABLE_EVENTING
totalmente configurada.
stage:
global:
ENABLE_EVENTING: true
deploy:
CRON_CONSUMERS_RUNNER:
cron_run: true
max_messages: 0
consumers: []
ENABLE_WEBHOOKS
- Padrão-Não definido
- Versão — Adobe Commerce 2.4.4 e posterior
Quando definido como true
, habilita webhooks do Commerce. O webhook é executado em um endpoint externo, como uma ação de tempo de execução do App Builder ou um sistema de gerenciamento de inventário de terceiros. O Guia de Webhooks descreve esse recurso detalhadamente.
stage:
global:
ENABLE_WEBHOOKS: true
MIN_LOGGING_LEVEL
- Padrão—Não definido
- Versão — Adobe Commerce 2.1.4 e posterior
Substitui o nível mínimo de log para todos os fluxos de saída sem alterar o código, o que ajuda a solucionar problemas com a implantação. Por exemplo, se a implantação falhar, você pode usar essa variável para aumentar a granularidade do registro globalmente. Consulte Níveis de log. O valor min_level
nos manipuladores de log substitui essa configuração.
stage:
global:
MIN_LOGGING_LEVEL: debug
MIN_LOGGING_LEVEL
não altera a configuração do nível de log do manipulador de arquivos, que é definido como debug
por padrão.SCD_ON_DEMAND
- Padrão—Não definido
- Versão — Adobe Commerce 2.1.4 e posterior
Ative a geração de conteúdo estático quando solicitado por um usuário (SCD). O conteúdo estático sob demanda é ideal para o fluxo de trabalho de desenvolvimento e teste, pois diminui o tempo de implantação.
O pré-carregamento do cache com o post_deploy
gancho reduz o tempo de inatividade do site. O aquecimento do cache está disponível somente para projetos Pro que contêm ambientes de Preparo e Produção no Cloud Console e para projetos Starter. Adicione a variável de ambiente SCD_ON_DEMAND
ao estágio global
no arquivo .magento.env.yaml
:
stage:
global:
SCD_ON_DEMAND: true
A variável SCD_ON_DEMAND
ignora o SCD em ambas as fases (compilação e implantação), limpa as pastas pub/static
e var/view_preprocessed
e grava o seguinte no arquivo app/etc/env.php
:
return array(
...
'static_content_on_demand_in_production' => 1,
...
);
SCD_MAX_EXECUTION_TIME
- Padrão—Não definido
- Versão — Adobe Commerce 2.2.0 e posterior
Permite aumentar o tempo de execução máximo esperado para implantação de conteúdo estático.
Por padrão, o Adobe Commerce define a execução máxima esperada para 900 segundos, mas em alguns cenários, pode ser necessário mais tempo para concluir a implantação do conteúdo estático para um projeto na nuvem.
stage:
global:
SCD_MAX_EXECUTION_TIME: 3600
SCD_NO_PARENT
- Padrão—Não definido
- Versão — Adobe Commerce 2.4.2 e posterior
Defina como true
para impedir a geração de conteúdo estático para temas pai durante as fases de compilação e implantação. Quando essa opção é definida como true
, menos conteúdo estático é gerado, o que melhora os tempos gerais de compilação e implantação.
stage:
global:
SCD_NO_PARENT: true
SCD_USE_BALER
- Padrão—Não definido
- Versão — Adobe Commerce 2.3.0 e posterior
Baler é um módulo que verifica o código JavaScript gerado e cria um pacote JavaScript otimizado. Implantar o pacote otimizado em seu site pode reduzir o número de solicitações de rede ao carregar seu site e melhorar o tempo de carregamento da página.
Defina como true
para executar o Baler após executar a implantação de conteúdo estático.
stage:
build:
SCD_USE_BALER: true
SKIP_HTML_MINIFICATION
-
Padrão:
true
—paraece-tools
2002.0.13 e posteriorfalse
—para versões anteriores doece-tools
-
Versão — Adobe Commerce 2.1.4 e posterior
Habilita ou desabilita a cópia de arquivos de exibição estáticos para o diretório <magento_root>/init/
no final do estágio de compilação. Se definido como true
, os arquivos não serão copiados e a minificação de HTML estará disponível mediante solicitação. Defina esse valor como true
para reduzir o tempo de inatividade ao implantar em ambientes de Preparo e Produção.
false
—Copia o diretórioview_preprocessed
para o diretório<magento_root>/init/
no final da fase de compilação e restaura o diretório no diretório<magento_root>/var
no início da fase de implantação.true
— Habilita a minificação de HTML sob demanda; não copia<magento_root>var/view_preprocessed
para o diretório<magento_root>/init/
no final da fase de compilação.
Adicione a variável de ambiente SKIP_HTML_MINIFICATION
ao estágio global
no arquivo .magento.env.yaml
:
stage:
global:
SKIP_HTML_MINIFICATION: true
X_FRAME_CONFIGURATION
- Padrão—Não definido
- Versão — Adobe Commerce 2.1.4 e posterior
Use a variável X_FRAME_CONFIGURATION
para alterar a configuração do cabeçalho X-Frame-Options
do site do Adobe Commerce. Esta configuração controla como o navegador renderiza uma página em um <frame>
, <iframe>
ou <object>
. Use uma das seguintes opções:
DENY
—A página não pode ser exibida em um quadro.SAMEORIGIN
—(A configuração padrão do Adobe Commerce.) A página pode ser exibida somente em um quadro na mesma origem da própria página.
ALLOW-FROM <uri>
foi descontinuada porque os navegadores com suporte para Adobe Commerce não oferecem mais suporte a ela. Consulte Compatibilidade do navegador.Adicione a variável de ambiente X_FRAME_CONFIGURATION
ao estágio global
no arquivo .magento.env.yaml
:
stage:
global:
X_FRAME_CONFIGURATION: SAMEORIGIN