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 do pipeline e fornece alguns exemplos para ajudá-lo a entender como ele funciona.

Antes de começar, leia os Pré-requisitos para os 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 está armazenada em app/etc/config.php, que deve estar no controle do código-fonte.

Defina a configuração compartilhada no Administrador em seu sistema de desenvolvimento (ou Adobe Commerce na infraestrutura de nuvem integração) e grave a configuração em config.php usando o comando magento app:config:dump.

Gerenciar a configuração específica do sistema

A configuração específica do sistema é armazenada em 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 comando magento app:config:dump.

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

Gerenciar a configuração confidencial

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

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

Configurações bloqueadas no Admin

Todas as definições de configuração em config.php ou env.php estão bloqueadas no Administrador; ou seja, essas definições não podem ser alteradas no Administrador.
Use o comando magento config:set ou magento config:set --lock para alterar as configurações nos arquivos config.php ou env.php.

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 seu trabalho cron fornecendo o comando magento cron:install. Este comando configura um crontab como o usuário que executa o comando.

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

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 Commerce 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:

Após 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 visualizaçã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 em config.php e env.php.

Alterar o local padrão

Esta seção mostra a alteração feita em config.php quando você altera a unidade de peso padrão usando 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 matriz general em locale como mostra o seguinte trecho de config.php:

'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 o bin/magento app:config:dump no sistema de desenvolvimento. Desta vez, nem todas as suas alterações são gravadas em config.php; na verdade, somente o site, armazenamento e exibição de armazenamento são gravados nesse arquivo, conforme mostrado nos seguintes trechos.

config.php

config.php contém:

Matriz websites:

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

Matriz groups:

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

Matriz stores:

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

Matriz payment:

      '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 o comando bin/magento app:config:dump 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>