Instalação de início rápido local
As instruções nesta página descrevem como instalar o Adobe Commerce na infraestrutura auto-hospedada. Para obter orientação sobre como atualizar uma instalação existente, consulte o Guia de Atualização.
O Adobe usa o Composer para gerenciar componentes do Adobe Commerce e suas dependências. Usar o Composer para obter o metapackage do Adobe Commerce oferece as seguintes vantagens:
- Reutilizar bibliotecas de terceiros sem agrupá-las com o código-fonte
- Reduza os conflitos de extensão e os problemas de compatibilidade usando uma arquitetura baseada em componentes com um gerenciamento robusto de dependências
- Siga os padrões PHP-Framework Interoperability Group (FIG)
- Reempacotar o Magento Open Source com outros componentes
- Usar o software Adobe Commerce em um ambiente de produção
Pré-requisitos
Antes de continuar, faça o seguinte:
- Conclua todas as tarefas de pré-requisito.
- Instalar Compositor.
- Obtenha chaves de autenticação para o repositório do Adobe Commerce Composer.
Efetuar login como proprietário do sistema de arquivos
Saiba mais sobre propriedade, permissões e o proprietário do sistema de arquivos no tópico Visão geral de propriedade e permissões.
Para alternar para o proprietário do sistema de arquivos:
-
Efetue login no servidor de aplicativos como, ou alterne para, um usuário com permissões para gravar no sistema de arquivos.
Se você usar o shell bash, poderá usar a seguinte sintaxe para alternar para o proprietário do sistema de arquivos e inserir o comando ao mesmo tempo:
code language-bash su <file system owner> -s /bin/bash -c <command>
Se o proprietário do sistema de arquivos não permitir logons, você poderá fazer o seguinte:
code language-bash sudo -u <file system owner> <command>
-
Para executar comandos CLI de qualquer diretório, adicione o
<app_root>/bin
ao sistemaPATH
.Como os shells têm sintaxes diferentes, consulte uma referência como unix.stackexchange.com.
Exemplo de shell bash para CentOS:
code language-bash export PATH=$PATH:/var/www/html/magento2/bin
Como opção, você pode executar os comandos das seguintes maneiras:
cd <app_root>/bin
e executá-los como./magento <command name>
app_root>/bin/magento <command name>
<app_root>
é um subdiretório do docroot do seu servidor Web
Obter o metapackage
Para obter o metappackage do Adobe Commerce:
-
Faça logon no servidor de aplicativos como ou alterne para o proprietário do sistema de arquivos.
-
Altere para o diretório docroot do servidor Web ou um diretório que você configurou como docroot do host virtual.
-
Crie um projeto do Composer usando um metapackage do Commerce.
Magento Open Source
code language-bash composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition <install-directory-name>
Adobe Commerce
code language-bash composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>
Quando solicitado, insira suas chaves de autenticação. Chaves públicas e privadas são criadas e configuradas em seu Commerce Marketplace.
note note NOTE Ao usar um arquivo do Composer auth.json
ou uma variável de ambiente, você não será solicitado a digitar suas chaves de autenticação.Se você encontrar erros, como
Could not find package...
ou...no matching package found
, verifique se não há erros de digitação no comando. Se ainda encontrar erros, talvez você não esteja autorizado a baixar o Adobe Commerce. Contate o Suporte da Adobe Commerce para obter ajuda.Consulte Solução de problemas para obter ajuda com mais erros.
Exemplo - Versão secundária
As versões secundárias contêm novos recursos, correções de qualidade e correções de segurança. Use o Composer para especificar uma versão secundária. Por exemplo, para especificar o metappackage do Adobe Commerce 2.4.6:
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>
Exemplo - Correção de qualidade
Os patches de qualidade contêm principalmente correções de segurança e funcionais. No entanto, às vezes elas também podem conter recursos novos e compatíveis com versões anteriores. Use o Composer para baixar um patch de qualidade. Por exemplo, para especificar o metappackage do Adobe Commerce 2.4.6:
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>
Exemplo - Correção de segurança
Os patches de segurança contêm apenas correções de segurança. Elas foram projetadas para tornar o processo de atualização mais rápido e fácil.
Os patches de segurança usam a convenção de nomenclatura do Composer 2.4.6-px
. Use o Composer para especificar um patch. Por exemplo, para baixar o metappackage 2.4.6-p1 do Adobe Commerce:
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6-p1 <install-directory-name>
Definir permissões de arquivo
Você deve definir permissões de leitura e gravação para o grupo de servidores Web antes de instalar o Adobe Commerce. Isso é necessário para que a linha de comando possa gravar arquivos no sistema de arquivos.
cd /var/www/html/<magento install directory>
find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
chown -R :www-data . # Ubuntu
chmod u+x bin/magento
Instalar o aplicativo
Você deve usar a linha de comando para instalar o Adobe Commerce.
Este exemplo supõe que o diretório de instalação seja nomeado como magento2ee
, o db-host
esteja na mesma máquina (localhost
) e que o db-name
, db-user
e db-password
sejam todos magento
:
bin/magento setup:install \
--base-url=http://localhost/magento2ee \
--db-host=localhost \
--db-name=magento \
--db-user=magento \
--db-password=magento \
--admin-firstname=admin \
--admin-lastname=admin \
--admin-email=admin@admin.com \
--admin-user=admin \
--admin-password=admin123 \
--language=en_US \
--currency=USD \
--timezone=America/Chicago \
--use-rewrites=1 \
--search-engine=opensearch \
--opensearch-host=os-host.example.com \
--opensearch-port=9200 \
--opensearch-index-prefix=magento2 \
--opensearch-timeout=15
--backend-frontname
. No entanto, o Adobe recomenda omitir essa opção e permitir que o comando de instalação gere automaticamente um URI aleatório. Um URI aleatório é mais difícil de ser explorado por hackers ou softwares mal-intencionados. O URI é exibido no console quando a instalação é concluída.Resumo do comando
Para exibir uma lista completa de comandos, insira:
bin/magento list
Para obter ajuda para um comando específico, insira:
bin/magento help <command>
Por exemplo:
bin/magento help setup:install
bin/magento help cache:enable
A tabela a seguir resume os comandos disponíveis. Os comandos são exibidos somente na forma de resumo. Para obter mais informações sobre um comando, clique no link na coluna Comando.
magento setup:install
magento setup:uninstall
magento setup:upgrade
magento maintenance:{enable/disable}
magento setup:config:set
magento module:{enable/disable}
magento setup:store-config:set
magento setup:db-schema:upgrade
magento setup:db-data:upgrade
magento setup:db:status
magento admin:user:create
Configuração de implantação
Habilitar no mínimo o
Magento_User
e o Magento_Authorization
módulosBanco de dados (a maneira mais simples é usar o
bin/magento setup:upgrade
)magento list
magento help
Argumentos comuns
Os argumentos a seguir são comuns a todos os comandos. Esses comandos podem ser executados antes ou depois que o aplicativo for instalado:
--help
-h
./magento help setup:install
ou ./magento help setup:config:set
.--quiet
-q
--no-interaction
-n
--verbose=1,2,3
-v, -vv, -vvv
--verbose=3
ou -vvv
exibe o detalhamento de depuração, que é a saída mais detalhada. O padrão é --verbose=1
ou -v
.--version
-V
--ansi
--no-ansi