Estrutura de projeto

Última atualização: 31 de janeiro de 2025

Tópicos:
Nuvem

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.

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

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

"extra": {
    "magento-force": true
    "magento-deploystrategy": "copy"
}

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.
Limpe o cache do Git.
git rm -r --cached .

Adicionar e confirmar alterações.

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