Detalhes técnicos

Este tópico discute detalhes de implementação técnica sobre a implantação de pipeline no Commerce 2.2 e versões posteriores. As melhorias podem ser divididas nas seguintes áreas:

Este tópico também discute o fluxo de trabalho recomendado para implantação de pipeline e fornece alguns exemplos para ajudar você a entender como funciona.

Antes de começar, revise o Pré-requisitos para seus sistemas de desenvolvimento, compilação e produção.

Gerenciamento de configuração

Para permitir que você sincronize e mantenha a configuração dos sistemas de desenvolvimento e produção, use o esquema de substituição a seguir.

Como mostra o diagrama, os valores de configuração são usados na seguinte ordem:

Gerenciar a configuração compartilhada

A configuração compartilhada é armazenada no app/etc/config.php, que deve estar no controle de origem.

Defina a configuração compartilhada no Administrador em sua infraestrutura de desenvolvimento (ou Adobe Commerce on cloud) integração) e gravar a configuração no config.php usando o magento app:config:dump comando.

Gerenciar a configuração específica do sistema

A configuração específica do sistema é armazenada no app/etc/env.php, que deve não estar no controle de origem.

Defina a configuração específica do sistema no Admin em seu sistema de desenvolvimento (ou Adobe Commerce na integração da infraestrutura em nuvem) e grave a configuração em env.php usando o magento app:config:dump comando.

Esse comando também grava configurações confidenciais em env.php.

Gerenciar a configuração confidencial

A configuração confidencial também é armazenada no app/etc/env.php.

Você pode gerenciar a configuração confidencial de qualquer uma das seguintes maneiras:

Configurações bloqueadas no Admin

Qualquer configuração em config.php ou env.php são bloqueados no Admin; ou seja, essas configurações não podem ser alteradas no Admin.
Use o magento config:set ou magento config:set --lock para alterar as configurações no campo config.php ou env.php arquivos.

O administrador do Commerce

O Administrador exibe o seguinte comportamento enquanto está no modo de produção:

Instalar e remover o cron

Na versão 2.2, pela primeira vez, ajudamos você a configurar o trabalho cron fornecendo o magento cron:install comando. Este comando configura um crontab como o usuário que executa o comando.

Além disso, você pode remover o crontab usando o magento cron:remove comando.

Fluxo de trabalho de implantação de pipeline recomendado

O diagrama a seguir mostra como recomendamos usar a implantação de pipeline para gerenciar a configuração.

Sistema de desenvolvimento

No sistema de desenvolvimento, você faz alterações de configuração no Administrador e gera a configuração compartilhada, app/etc/config.php e a configuração específica do sistema, app/etc/env.php. Verifique o código comercial e a configuração compartilhada no controle do código-fonte e envie-o para o servidor de compilação.

Você também deve instalar extensões e personalizar o código do Commerce no sistema de desenvolvimento.

Em seu sistema de desenvolvimento:

Depois de executar os comandos para limpar os ativos, o Commerce gera arquivos de trabalho.

Criar sistema

O sistema de compilação compila o código e gera arquivos de exibição estáticos para temas registrados no Commerce. Ela não precisa de uma conexão com o banco de dados do Commerce; ela precisa apenas da base de código do Commerce.

No sistema de compilação:

Sistema de produção

No sistema de produção (ou seja, na loja em tempo real), você extrai ativos gerados e atualizações de código do controle de origem e define configurações confidenciais e específicas do sistema usando a linha de comando ou variáveis de ambiente.

Em seu sistema de produção:

Comandos de gerenciamento de configuração

Fornecemos os seguintes comandos para ajudá-lo a gerenciar a configuração:

Exemplos de gerenciamento de configuração

Esta seção mostra exemplos de gerenciamento da configuração para que você possa ver como as alterações são feitas no config.php e env.php.

Alterar o local padrão

Esta seção mostra a alteração feita no config.php quando você altera a unidade de peso padrão usando a variável Admin (Lojas > Configurações > Configuração > Geral > Geral > Opções de localidade).

Depois de fazer a alteração no Administrador, execute bin/magento app:config:dump para gravar o valor em config.php. O valor é gravado na variável general matriz em locale como o seguinte trecho de config.php mostra:

'general' =>
    array (
        'locale' =>
        array (
            'code' => 'en_US',
            'timezone' => 'America/Chicago',
            'weight_unit' => 'kgs'
        )
    )

Alterar várias definições de configuração

Esta seção discute as seguintes alterações de configuração:

Depois de fazer a alteração no Administrador, execute bin/magento app:config:dump no sistema de desenvolvimento. Desta vez, nem todas as alterações foram gravadas em config.php; na verdade, somente a visualização do site, da loja e da loja são gravadas nesse arquivo, conforme mostrado nos trechos a seguir.

config.php

config.php contém:

websites matriz:

      'new' =>
      array (
        'website_id' => '2',
        'code' => 'new',
        'name' => 'New website',
        'sort_order' => '0',
        'default_group_id' => '2',
        'is_default' => '0',
      ),

groups matriz:

      2 =>
      array (
        'group_id' => '2',
        'website_id' => '2',
        'code' => 'newstore',
        'name' => 'New store',
        'root_category_id' => '2',
        'default_store_id' => '2',
      ),

stores matriz:

     'newview' =>
      array (
        'store_id' => '2',
        'code' => 'newview',
        'website_id' => '2',
        'group_id' => '2',
        'name' => 'New store view',
        'sort_order' => '0',
        'is_active' => '1',
      ),

payment matriz:

      'payment' =>
      array (
        'paypal_express' =>
        array (
          'active' => '0',
          'in_context' => '0',
          'title' => 'PayPal Express Checkout',
          'sort_order' => NULL,
          'payment_action' => 'Authorization',
          'visible_on_product' => '1',
          'visible_on_cart' => '1',
          'allowspecific' => '0',
          'verify_peer' => '1',
          'line_items_enabled' => '1',
          'transfer_shipping_options' => '0',
          'solution_type' => 'Mark',
          'require_billing_address' => '0',
          'allow_ba_signup' => 'never',
          'skip_order_review_step' => '1',
        ),

env.php

A definição de configuração específica do sistema de domínio de email padrão é gravada em app/etc/env.php.

As configurações do PayPal não são gravadas em nenhum arquivo porque bin/magento app:config:dump O comando não grava configurações confidenciais. Você deve definir as configurações do PayPal no sistema de produção usando os seguintes comandos:

bin/magento config:sensitive:set paypal/wpp/api_username <username>

bin/magento config:sensitive:set paypal/wpp/api_password <password>