DocumentaçãoCommerceGuia de configuração

[Somente PaaS]{class="badge informative" title="Aplica-se somente a projetos do Adobe Commerce na nuvem (infraestrutura do PaaS gerenciada pela Adobe) e a projetos locais."}

Configuração do sistema de compilação

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Experiente
  • Administrador
  • Desenvolvedor

Você pode ter um sistema de build que atenda aos seguintes requisitos:

  • Todo o código Commerce está sob controle do código-fonte no mesmo repositório dos sistemas de desenvolvimento e produção

  • Verifique se todos os itens a seguir estão incluídos no controle do código-fonte:

    • app/etc/config.php
    • Diretório generated (e subdiretórios)
    • Diretório pub/media
    • Diretório pub/media/wysiwyg (e subdiretórios)
    • Diretório pub/static (e subdiretórios)

  • Deve ter uma versão compatível do PHP instalada

  • É necessário ter o Composer instalado

  • Ele tem a propriedade e as permissões do sistema de arquivos definidas conforme discutido em Pré-requisito para seus sistemas de desenvolvimento, compilação e produção.

  • O sistema de compilação não precisa do Commerce para ser instalado, mas o código deve estar disponível para ele.

WARNING
A conexão de banco de dados não é necessária se já estiver contida em config.php; consulte Exportar a configuração. Caso contrário, a conexão com o banco de dados será necessária.
INFO
A máquina de build pode estar em seu próprio host ou no mesmo host de um sistema Commerce instalado.

Configurar a máquina de compilação

As seções a seguir discutem como configurar a máquina de compilação.

Instalar o Composer

Primeiro, verifique se o Composer já está instalado:

Em um prompt de comando, digite qualquer um dos comandos a seguir:

  • composer --help
  • composer list --help

Se a ajuda do comando for exibida, o Composer já está instalado.

Se um erro for exibido, siga as etapas abaixo para instalar o Composer.

Para instalar o Composer:

  1. Altere para ou crie um diretório vazio no servidor do Commerce.

  2. Digite os seguintes comandos:

    code language-bash 
    curl -sS https://getcomposer.org/installer | php
    code language-bash 
    mv composer.phar /usr/local/bin/composer

Para obter opções adicionais de instalação, consulte a documentação de instalação do Composer.

Instalar PHP

Instale o PHP no CentOS ou no Ubuntu.

Configurar o sistema de compilação

Para configurar o sistema de criação:

  1. Faça logon no sistema de criação como, ou alterne para, o proprietário do sistema de arquivos.

  2. Recupere o código Commerce do controle do código-fonte.

    Se você usar o Git, use o seguinte comando:

    code language-bash 
    git clone [-b <branch name>] <repository URL>

  3. Altere para o diretório raiz do Commerce e digite:

    code language-bash 
    composer install

  4. Aguarde até que as dependências sejam atualizadas.

  5. Definir propriedade:

    code language-bash 
    chown -R <Commerce file system owner name>:<web server username> .

    Por exemplo,

    code language-bash 
    chown -R commerce-username:apache .

  6. Se você usa o Git, abra .gitignore em um editor de texto.

  7. Inicie cada uma das seguintes linhas com um caractere # para comentá-las:

    code language-conf 
    # app/etc/config.php
# pub/media/*
# generated/*
# pub/media/*.*
# pub/media/wysiwyg/*
# pub/static/*

  8. Salve as alterações em .gitignore e saia do editor de texto.

  9. Se você usar o Git, use os seguintes comandos para confirmar a alteração:

    code language-bash 
    git add .gitignore && git commit -m "Modify .gitignore for build and production"

    Consulte a .gitignore referência para obter mais informações.

  10. O sistema de compilação deve usar o modo padrão ou o modo de desenvolvedor:

    code language-bash 
    bin/magento deploy:mode:set <mode>

    <mode> é obrigatório. Pode ser default ou developer.

recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c