Criar variáveis

As seguintes build as variáveis controlam ações na fase de criação e podem herdar e substituir valores da variável Variáveis globais. Insira essas variáveis no build fase do .magento.env.yaml arquivo:

stage:
  build:
    BUILD_VARIABLE_NAME: value

Para obter mais informações sobre como personalizar o processo de criação e implantação:

As seguintes variáveis foram removidas na v2.2:

  • skip_di_clearing
  • skip_di_compilation

ERROR_REPORT_DIR_NESTING_LEVEL

  • Padrão1
  • Versão—Adobe Commerce 2.1.4 e posterior

Defina o nível de aninhamento de diretórios para salvar arquivos de relatório de erros, a fim de evitar o preenchimento do diretório de relatório com dezenas de milhares de arquivos, o que pode dificultar o gerenciamento e a revisão dos dados. O padrão dessa configuração é 1. Normalmente, você não precisa alterar o valor padrão, a menos que tenha problemas ao gerenciar arquivos de relatório de erros no <magento_root>/var/report/ diretório.

stage:
  build:
    ERROR_REPORT_DIR_NESTING_LEVEL: 2

QUALITY_PATCHES

  • PadrãoNão definido
  • Versão—Adobe Commerce 2.1.4 e posterior

Especifique uma lista de patches de qualidade do Adobe Commerce a serem aplicados durante a implantação.

stage:
  build:
    QUALITY_PATCHES: [ ]

O exemplo a seguir especifica três patches a serem aplicados durante a implantação.

stage:
  build:
    QUALITY_PATCHES:
      - MC-31387
      - MDVA-4567
      - MC-456345

Consulte Aplicar patches.

SCD_COMPRESSION_LEVEL

  • Padrão6
  • Versão—Adobe Commerce 2.1.4 e posterior

Especifica qual gzip nível de compactação (0 para 9) para usar ao compactar conteúdo estático; 0 desativa a compactação.

stage:
  build:
    SCD_COMPRESSION_LEVEL: 4

SCD_COMPRESSION_TIMEOUT

  • Padrão600
  • Versão—Adobe Commerce 2.1.4 e posterior

Quando o tempo necessário para compactar os ativos estáticos excede o tempo limite de compactação, ele interrompe o processo de implantação. Defina o tempo máximo de execução, em segundos, para o comando static content compression.

stage:
  build:
    SCD_COMPRESSION_TIMEOUT: 800

SCD_NO_PARENT

  • Padrãofalse
  • Versão—Adobe Commerce 2.4.2 e posterior

Defina como true para evitar a geração de conteúdo estático para temas principais durante a fase de criação.

Definir SCD_NO_PARENT: false durante a fase de criação, para que a geração de conteúdo estático para os temas principais não afete a implantação do site ou cause tempo de inatividade desnecessário. Consulte Implantação de conteúdo estático.

stage:
  build:
    SCD_NO_PARENT: false

SCD_MATRIX

  • PadrãoNão definido
  • Versão—Adobe Commerce 2.1.4 e posterior

Você pode configurar vários locais por tema. Essa personalização ajuda a acelerar o processo de criação, reduzindo o número de arquivos de tema desnecessários. Por exemplo, é possível criar a variável magento/backend tema em inglês e um tema personalizado em outros idiomas.

O exemplo a seguir cria a variável Magento/backend tema com três localidades:

stage:
  build:
    SCD_MATRIX:
      "Magento/backend":
        language:
          - en_US
          - fr_FR
          - af_ZA

O exemplo a seguir cria três temas com três localidades:

stage:
  build:
    SCD_MATRIX:
      "Magento/backend":
        language:
          - en_US
          - fr_FR
          - af_ZA
      "Magento/blank":
        language:
          - en_US
          - fr_FR
          - af_ZA
      "Magento/luma":
        language:
          - en_US
          - fr_FR
          - af_ZA

Ou você pode optar por não implantar um tema:

stage:
  build:
    SCD_MATRIX:
      "Magento/backend": [ ]

SCD_MAX_EXECUTION_TIME

  • PadrãoNã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 na infraestrutura em nuvem 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 de conteúdo estático para um projeto em nuvem.

stage:
  build:
    SCD_MAX_EXECUTION_TIME: 3600
WARNING
Se tiver problemas com arquivos de conteúdo estático no aplicativo após a implantação, como arquivos de tema personalizados ausentes, aumente o tempo de execução máximo esperado para 900 segundos ou mais.

SCD_STRATEGY

  • Padrãoquick
  • Versão—Adobe Commerce 2.2.0 e posterior

Personalize o estratégia de implantação para conteúdo estático. Consulte Implantar arquivos de exibição estáticos.

Usar estas opções somente se você tiver mais de um local:

  • standard—implanta todos os arquivos de visualização estáticos para todos os pacotes.
  • quick—(padrão) minimiza o tempo de implantação.
  • compact—preserva o espaço em disco no servidor. No Adobe Commerce versão 2.2.4 e anterior, essa configuração substitui o valor de scd_threads com um valor de 1.
stage:
  build:
    SCD_STRATEGY: "compact"

SCD_THREADS

  • Padrão— Automatic
  • Versão—Adobe Commerce 2.1.4 e posterior

Define o número de threads para implantação de conteúdo estático. O valor padrão é definido com base na contagem de threads da CPU detectada e não excede um valor 4. Aumentar o número de threads acelera a implantação de conteúdo estático; diminuir o número de threads o torna mais lento. Você pode definir o valor da thread, por exemplo:

stage:
  build:
    SCD_THREADS: 2

Para reduzir ainda mais o tempo de implantação, use Gerenciamento de configurações com o scd-dump para mover a implantação estática para a fase de criação.

SCD_USE_BALER

  • PadrãoNão definido
  • Versão—Adobe Commerce 2.3.0 e posterior

Baler O 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
NOTE
Como Baler está na versão alfa, não é aconselhável usá-lo em ambientes de Produção.

SKIP_COMPOSER_DUMP_AUTOLOAD

  • PadrãoNão definido
  • Versão—Adobe Commerce 2.1.4 e posterior

Defina como true para ignorar o composer dump-autoload durante a instalação do Cloud Docker. Essa variável só é relevante para contêineres do Cloud Docker com sistemas de arquivos graváveis. Nesses casos, ignorar o comando evita erros de outros comandos que tentam acessar o código do excluído generated diretório.

Quando o Adobe Commerce é executado composer dump-autoload, ele cria arquivos de carregamento automático com links para classes geradas na generated , que não é um problema em ambientes de produção com sistemas de arquivos somente leitura. No entanto, para instalações do Cloud Docker com sistemas de arquivos graváveis (criados apenas para teste e desenvolvimento usando o ./vendor/bin/ece-docker build:compose --with-test), você pode executar o bin/magento -n setup:upgrade comando sem o --keep-generated que exclui a variável generated diretório. Se o diretório for excluído, a variável composer dump-autoload O comando falha porque o carregamento automático contém links para arquivos no diretório excluído.

stage:
  build:
    SKIP_COMPOSER_DUMP_AUTOLOAD: true

SKIP_SCD

  • PadrãoNão definido
  • Versão—Adobe Commerce 2.1.4 e posterior

Defina como true para ignorar a implantação de conteúdo estático durante a fase de criação.

Se você já implantar conteúdo estático durante a fase de criação com o Gerenciamento de configurações, você pode ignorar a implantação de conteúdo estático para um teste de build rápido.

Na fase de criação, defina SKIP_SCD: false para que a criação de conteúdo estático ocorra durante a fase de criação, quando o processo não impactar a implantação do site ou causar tempo de inatividade desnecessário. Consulte Implantação de conteúdo estático.

stage:
  build:
    SKIP_SCD: false

VERBOSE_COMMANDS

  • PadrãoNão definido
  • Versão—Adobe Commerce 2.1.4 e posterior

Ative ou desative o Symfony depurar nível de detalhamento para bin/magento Comandos da CLI executados durante a fase de implantação.

NOTE
Para usar VERBOSE_COMMANDS para controlar os detalhes na saída do comando para êxito e falha bin/magento Comandos CLI, você deve definir MIN_LOGGING_LEVEL debug.

Escolha o nível de detalhes fornecido nos logs:

  • -v= saída normal
  • -vv= saída mais detalhada
  • -vvv = saída detalhada ideal para depuração
stage:
  build:
    VERBOSE_COMMANDS: "-vv"
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26