DocumentaçãoCommerceGuia do Commerce na nuvem

[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."}

Estrutura de projeto

Last update: Fri Jan 31 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Administrador
  • Desenvolvedor

Um projeto de infraestrutura do Adobe Commerce na nuvem inclui arquivos essenciais para credenciais e configuração de aplicativo. Esses arquivos estão disponíveis no como modelo de acordo com a versão do Adobe Commerce. Consulte os modelos de nuvem com base na versão do Adobe Commerce no magento/magento-cloud repositório do GitHub.

A tabela a seguir descreve os arquivos incluídos em um projeto na nuvem:

Arquivo
Descrição
/.magento/routes.yaml
Arquivo de configuração que redireciona www para o domínio apex e o aplicativo php para servir HTTP. Consulte Configurar rotas.
/.magento/services.yaml
Um arquivo de configuração que define uma instância do MySQL (MariaDB), Redis e OpenSearch ou Elasticsearch. Consulte Configurar serviços.
/app
A pasta code é usada para módulos personalizados. A pasta design é usada para temas personalizados. A pasta etc contém arquivos de configuração para o aplicativo.
/m2-hotfixes
Usado para patches personalizados.
/update
Uma pasta de serviço usada pelo módulo de suporte.
.gitignore
Especifique quais arquivos e diretórios ignorar. Consulte .gitignore referência.
.magento.app.yaml
Um arquivo de configuração que define as propriedades para criar seu aplicativo. Consulte Configurar aplicativo.
.magento.env.yaml
Arquivo de configuração das fases de criação, implantação e pós-implantação. O pacote ece-tools inclui uma amostra desse arquivo. Consulte Configurar ambientes.
composer.json
Busca o Adobe Commerce e os scripts de configuração para preparar seu aplicativo. Consulte Pacotes necessários.
composer.lock
Armazena dependências de versão para cada pacote. Consulte Pacotes necessários.
magento-vars.php
Usado para definir vários armazenamentos e sites usando variáveis.
NOTE
Quando você envia suas alterações locais para o servidor remoto, o script de implantação usa os valores definidos pelos arquivos de configuração no diretório .magento e, em seguida, o script exclui o diretório e seu conteúdo. O ambiente de desenvolvimento local não é afetado.

Diretório raiz do aplicativo

O local do diretório raiz do aplicativo depende do ambiente.

  • Integração do Starter e do Pro: /app
  • Produção Inicial: /<project-ID>
  • Estágios Profissionais: /<project-ID>_stg
  • Produção Profissional: /<project-ID>

Diretórios graváveis

Os ambientes remotos de integração, preparo e produção são somente leitura. Os seguintes diretórios são apenas diretórios graváveis por motivos de segurança:

  • var
  • pub/static
  • pub/media
  • app/etc
  • /tmp
NOTE
Em ambientes de produção e de preparo, cada nó no cluster de três nós tem um diretório /tmp que não é compartilhado com os outros nós.

Ignorar arquivos

Há um arquivo .gitignore básico com o repositório do projeto Adobe Commerce na infraestrutura em nuvem. Consulte o arquivo .gitignore mais recente no repositório magento-cloud. Para adicionar um arquivo que esteja na lista .gitignore, você pode usar a opção -f (forçar) ao preparar uma confirmação:

git add <path/filename> -f

Alterar modelo base

Você pode usar as seguintes etapas para alterar a estrutura de um projeto existente para refletir o modelo base mais recente do Adobe Commerce na infraestrutura em nuvem.

  1. Clonar o projeto em uma estação de trabalho local.

  2. Atualize o arquivo composer.json com os seguintes valores para a seção extra.

    code language-json 
    "extra": {
    "magento-force": true
    "magento-deploystrategy": "copy"
}

  3. Adicione o arquivo .gitignore criado para o modelo base. Por exemplo, se você precisar do arquivo .gitignore para a versão 2.2.6 do modelo, use o arquivo .gitignore para 2.2.6 como referência.

  4. Limpe o cache do Git.

    code language-bash 
    git rm -r --cached .

  5. Adicionar e confirmar alterações.

    code language-bash 
    git add -A && git commit -m "Update base template"
WARNING
O processo de implantação começa quando você executa uma mesclagem, envio por push ou sincronização de seu ambiente, ou quando você aciona uma reimplantação manual, durante a qual o aplicativo Commerce está em modo de manutenção. Para um ambiente de produção, a Adobe recomenda concluir esse trabalho fora do horário de pico para evitar interrupções do serviço.
recommendation-more-help
7c2b03ac-000c-497d-aba3-2c6dc720a938