DocumentaçãoCommerceGuia de instalação

Instalação avançada local

Last update: Thu Apr 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Experienced
  • Admin
  • Developer
TIP
Perdido? Precisa de ajuda? Experimente o nosso Instalação de início rápido ou Instalação do colaborador guias.
NOTE
Se você optou por ativar o SELinux, consulte SELinux e iptables.

CLI (Command-Line Interface, interface de linha de comando)

O Adobe Commerce tem uma única interface de linha de comando para tarefas de instalação e configuração: <magento_root>/bin/magento. A interface do executa várias tarefas, incluindo:

  • Instalação (e tarefas relacionadas, como criar ou atualizar o esquema de banco de dados, criar a configuração de implantação).
  • Limpando o cache.
  • Gerenciamento de índices, incluindo a reindexação.
  • Criação de dicionários de tradução e pacotes de tradução.
  • Gerando classes inexistentes, como fábricas e interceptores para plug-ins, gerando a configuração de injeção de dependência para o gerenciador de objetos.
  • Implantação de arquivos de visualização estáticos.
  • Criação de CSS a partir de menos.

Outros benefícios:

  • Um único comando (<magento_root>/bin/magento list) lista todos os comandos de instalação e configuração disponíveis.
  • Interface de usuário consistente com base no Symfony.
  • A CLI é extensível para que desenvolvedores de terceiros possam se "conectar" a ela. Isso tem o benefício adicional de eliminar a curva de aprendizado dos usuários.
  • Os comandos para módulos desativados não são exibidos.

Este tópico discute a instalação do software Adobe Commerce usando a CLI. Para obter informações sobre configuração, consulte Guia de configuração.

O instalador pode ser executado várias vezes, se necessário, para que você possa:

  • Fornecer valores diferentes

    Por exemplo, depois de configurar seu servidor Web para SSL (Secure Sockets Layer), você pode executar o instalador para definir as opções de SSL.

  • Corrigir erros em instalações anteriores

  • Instalar o Adobe Commerce em uma instância de banco de dados diferente

Antes de iniciar a instalação

Antes de começar, conclua as seguintes etapas:

NOTE
Você deve instalar o Adobe Commerce a partir da bin subdiretório.

Você pode executar o instalador várias vezes com opções diferentes para concluir tarefas de instalação como as seguintes:

  • Instalar em fases — Por exemplo, depois de configurar o servidor Web para SSL (Secure Sockets Layer), você pode executar o instalador novamente para definir as opções de SSL.

  • Corrigir erros em instalações anteriores.

  • Instale o Adobe Commerce em uma instância de banco de dados diferente.

NOTE
Por padrão, o instalador não substitui o banco de dados se você instalar o software na mesma instância do banco de dados. Você pode usar o cleanup-database para alterar esse comportamento.

Consulte também Atualizar, reinstalar, desinstalar.

Instalação segura

Para usar a SSL (Secure Sockets Layer), também chamada de HTTPS, para o Administrador e a loja, você deve definir todos os parâmetros a seguir:

  • --use-secure: Defina como 1
  • --base-url-secure: Defina para um URL seguro (ou seja, começando com https://)
  • --use-secure-admin Defina como 1

Mais detalhes sobre esses parâmetros podem ser encontrados posteriormente neste tópico.

Comandos de ajuda do instalador

Você pode executar os seguintes comandos para localizar valores para alguns argumentos necessários:

Argumento do instalador
Comando
Idioma
bin/magento info:language:list
Moeda
bin/magento info:currency:list
Fuso horário
bin/magento info:timezone:list
NOTE
Se um erro for exibido ao executar esses comandos, verifique se você atualizou as dependências de instalação conforme discutido em Atualizar dependências de instalação.

Instalar da linha de comando

O comando install usa o seguinte formato:

bin/magento setup:install --<option>=<value> ... --<option>=<value>

As tabelas a seguir descrevem os valores e nomes das opções de instalação. Por exemplo, comandos de instalação, consulte Exemplos de instalações localhost.

NOTE
Qualquer opção que contenha espaços ou caracteres especiais deve estar entre aspas simples ou duplas.

Credenciais de administrador:

As opções a seguir especificam as informações e credenciais do usuário administrador.

Você pode criar o usuário Administrador durante ou após a instalação. Se você criar o usuário durante a instalação, todas as variáveis de credencial do administrador serão necessárias. Consulte Exemplos de instalações localhost.

As tabelas a seguir fornecem muitos, mas não todos, os parâmetros de instalação disponíveis. Para obter uma lista completa, consulte Referência de ferramentas de linha de comando.

Nome
Valor
Obrigatório?
--admin-firstname
Nome do usuário administrador.
Sim
--admin-lastname
Sobrenome do usuário administrador.
Sim
--admin-email
Endereço de email do usuário administrador.
Sim
--admin-user
Nome de usuário do administrador.
Sim
--admin-password
Senha de usuário administrador. A senha deve ter pelo menos 7 caracteres e incluir pelo menos um caractere alfabético e um caractere numérico. Recomendamos uma senha mais longa e complexa. Coloque toda a string de senha entre aspas simples. Por exemplo, --admin-password='A0b9%t3g'
Sim

Opções de configuração do site e do banco de dados:

Nome
Valor
Obrigatório?
--base-url
URL base a ser usado para acessar seu administrador e vitrine em qualquer um dos seguintes formatos:

http[s]://<host or ip>/<your install dir>/.

Nota: O esquema (http:// ou https://) e uma barra à direita são necessários.

<your install dir> é o caminho relativo ao docroot no qual instalar o software Adobe Commerce. Dependendo de como você configura o servidor Web e os hosts virtuais, o caminho pode ser magento2 ou pode estar em branco.

Para acessar o Adobe Commerce ou o MagenAdobe Commerce, use http://127.0.0.1/<your install dir>/ ou http://127.0.0.1/<your install dir>/.

- {{base_url}} que representa um URL de base definido por uma configuração de host virtual ou por um ambiente de virtualização como o Docker. Por exemplo, se você configurar um host virtual com o nome do host magento.example.com, você pode instalar o software com --base-url={{base_url}} e acesse o Administrador com um URL como http://magento.example.com/admin.
Sim
--backend-frontname
URI (Uniform Resource Identifier) para acessar o Administrador. Você pode omitir esse parâmetro para permitir que o aplicativo gere um URI aleatório para você com o seguinte padrão admin_jkhgdfq.

Recomendamos um URI aleatório para fins de segurança. Um URI aleatório é mais difícil de ser explorado por hackers ou softwares mal-intencionados.

O URI é exibido no final da instalação. É possível exibi-lo posteriormente a qualquer momento usando a bin/magento info:adminuri comando.

Se você optar por inserir um valor, recomendamos que não use uma palavra comum como admin, backend. O URI do Administrador pode conter valores alfanuméricos e o caractere de sublinhado (_) somente.
Não
--db-host
Use qualquer um dos seguintes:

- O nome de host ou endereço IP totalmente qualificado do servidor de banco de dados.

- localhost (padrão) ou 127.0.0.1 se o servidor de banco de dados estiver no mesmo host que o servidor da web.localhost significa que a biblioteca do cliente MySQL usa soquetes UNIX para se conectar ao banco de dados. 127.0.0.1 faz com que a biblioteca do cliente use o protocolo TCP. Para obter mais informações sobre soquetes, consulte Documentação do PHP PDO_MYSQL.

Nota: Opcionalmente, você pode especificar a porta do servidor de banco de dados em seu nome de host, como www.example.com:9000
Sim
--db-name
Nome da instância do banco de dados em que você deseja instalar as tabelas do banco de dados.

O padrão é magento2.
Sim
--db-user
Nome de usuário do proprietário da instância do banco de dados.

O padrão é root.
Sim
--db-password
Senha do proprietário da instância do banco de dados.
Sim
--db-prefix
Use apenas se estiver instalando as tabelas do banco de dados em uma instância do banco de dados que já tenha tabelas do Adobe Commerce.

Nesse caso, use um prefixo para identificar as tabelas dessa instalação. Alguns clientes têm mais de um Adobe Commerce ou MagenAdobe Commerce Server com todas as tabelas no mesmo banco de dados.

O prefixo pode ter no máximo cinco caracteres. Ela deve começar com uma letra e pode incluir apenas letras, números e caracteres sublinhados.

Essa opção permite que esses clientes compartilhem o servidor de banco de dados com mais de uma instalação do Adobe Commerce
--db-ssl-key
Caminho para a chave do cliente.
Não
--db-ssl-cert
Caminho para o certificado do cliente.
Não
--db-ssl-ca
Caminho para o certificado do servidor.
Não
--language
Código de idioma a ser usado no Admin e na loja. (Se ainda não tiver feito isso, você poderá exibir a lista de códigos de idioma inserindo bin/magento info:language:list do diretório bin.)
Não
--currency
Moeda padrão a ser usada na loja. (Se ainda não tiver feito isso, você poderá exibir a lista de moedas informando bin/magento info:currency:list do diretório bin.)
Não
--timezone
Fuso horário padrão a ser usado na administração e na loja. (Se ainda não tiver feito isso, você poderá exibir a lista de fusos horários inserindo bin/magento info:timezone:list do bin/ diretório.)
Não
--use-rewrites
1 significa que você usa regravações do servidor da web para links gerados na loja e no Administrador.

0 desativa o uso de regravações do servidor web. Este é o padrão.
Não
--use-secure
1 permite o uso da SSL (Secure Sockets Layer) em URLs de vitrine. Antes de selecionar essa opção, verifique se o servidor Web oferece suporte para SSL.

0 desativa o uso do SSL. Nesse caso, presume-se que todas as outras opções de URL seguro também sejam 0. Este é o padrão.
Não
--base-url-secure
URL base seguro a ser usado para acessar seu administrador e vitrine eletrônica no seguinte formato: http[s]://<host or ip>/<your install dir>/
Não
--use-secure-admin
1 significa que você usa SSL para acessar o Administrador. Antes de selecionar essa opção, verifique se o servidor Web oferece suporte para SSL.

0 significa que você não usa SSL com o Administrador. Este é o padrão.
Não
--admin-use-security-key
1 faz com que o aplicativo use um valor de chave gerado aleatoriamente para acessar páginas no Admin e em formulários. Esses valores principais ajudam a impedir ataques de falsificação de script entre sites. Este é o padrão.

0 desativa o uso da chave.
Não
--session-save
Use qualquer um dos seguintes:

- db para armazenar dados da sessão no banco de dados. Escolha armazenamento de banco de dados se você tiver um banco de dados clusterizado; caso contrário, pode não haver muito benefício sobre o armazenamento baseado em arquivo.

- files para armazenar dados de sessão no sistema de arquivos. O armazenamento de sessão baseado em arquivo é apropriado, a menos que o acesso ao sistema de arquivos seja lento, você tenha um banco de dados clusterizado ou deseje armazenar dados de sessão em Redis.

- redis para armazenar dados de sessão em Redis. Se você estiver usando Redis para cache padrão ou de página, Redis já deve estar instalado. Consulte Usar Redis para armazenamento de sessão para obter informações adicionais sobre a configuração do suporte para Redis.
Não
--key
Se você tiver uma, especifique uma chave para criptografar dados confidenciais no banco de dados. Se você não tiver um, o aplicativo gera um para você.
Sim
--cleanup-database
Para eliminar tabelas de banco de dados antes de instalar o Adobe Commerce, especifique esse parâmetro sem um valor. Caso contrário, o banco de dados será deixado intacto.
Não
--db-init-statements
Parâmetro de configuração avançado do MySQL. Usa instruções de inicialização de banco de dados a serem executadas ao conectar-se ao banco de dados MySQL. Consulte uma referência semelhante a esta antes de definir quaisquer valores.

O padrão é SET NAMES utf8;.
Não
--sales-order-increment-prefix
Especifique um valor da cadeia de caracteres a ser usada como prefixo para ordens de venda. Normalmente, isso é usado para garantir números de pedido exclusivos para processadores de pagamento.
Não

Opções de configuração do mecanismo de pesquisa:

Nome
Valor
Obrigatório?
--search-engine
A versão do Elasticsearch ou OpenSearch a ser usada como mecanismo de pesquisa. O padrão é elasticsearch7. O Elasticsearch 5 foi descontinuado e não é recomendado.
Não
--elasticsearch-host
O nome do host ou endereço IP onde o Elasticsearch está sendo executado. O padrão é localhost.
Não
--elasticsearch-port
A porta Elasticsearch para solicitações HTTP de entrada. O padrão é 9200.
Não
--elasticsearch-index-prefix
Um prefixo que identifica o índice de pesquisa Elasticsearch. O padrão é magento2.
Não
--elasticsearch-timeout
O número de segundos antes de o sistema expirar. O padrão é 15.
Não
--elasticsearch-enable-auth
Habilita a autenticação no servidor Elasticsearch. O padrão é false.
Não
--elasticsearch-username
A ID do usuário para autenticar no servidor Elasticsearch.
Não, a menos que a autenticação esteja habilitada
--elasticsearch-password
A senha para autenticar no Elasticsearchserver.
Não, a menos que a autenticação esteja habilitada
--opensearch-host
O nome do host ou endereço IP onde o OpenSearch está sendo executado. O padrão é localhost.
Não
--opensearch-port
A porta OpenSearch para solicitações HTTP de entrada. O padrão é 9200.
Não
--opensearch-index-prefix
Um prefixo que identifica o índice de pesquisa OpenSearch. O padrão é magento2.
Não
--opensearch-timeout
O número de segundos antes de o sistema expirar. O padrão é 15.
Não
--opensearch-enable-auth
Habilita a autenticação no servidor OpenSearch. O padrão é false.
Não
--opensearch-username
A ID do usuário para autenticar no servidor OpenSearch.
Não, a menos que a autenticação esteja habilitada
--opensearch-password
A senha para autenticar no servidor OpenSearch.
Não, a menos que a autenticação esteja habilitada

RabbitMQopções de configuração:

Nome
Valor
Obrigatório?
--amqp-host
Não use o --amqp opções, a menos que você já tenha configurado uma instalação do RabbitMQ. Consulte RabbitMQ instalação para obter mais informações sobre instalação e configuração RabbitMQ.

O nome do host onde RabbitMQ O está instalado.
Não
--amqp-port
A porta a ser usada para conexão RabbitMQ. O padrão é 5672.
Não
--amqp-user
O nome de usuário para conexão com RabbitMQ. Não usar o usuário padrão guest.
Não
--amqp-password
A senha para conexão com o RabbitMQ. Não usar a senha padrão guest.
Não
--amqp-virtualhost
O host virtual para conexão com RabbitMQ. O padrão é /.
Não
--amqp-ssl
Indica se é necessário se conectar RabbitMQ. O padrão é false. Consulte RabbitMQ para obter informações sobre como configurar o SSL para o RabbitMQ.
Não
--consumers-wait-for-messages
Os consumidores devem aguardar uma mensagem da fila? 1 - Sim, 0 - Não
Não

Bloquear opções de configuração:

Nome
Valor
Obrigatório?
--lock-provider
Nome do provedor de bloqueio.

Provedores de bloqueio disponíveis: db, zookeeper, file.

O provedor de bloqueio padrão: db
Não
--lock-db-prefix
O prefixo do banco de dados específico para evitar conflitos de bloqueio ao usar db provedor de bloqueio.

O valor padrão: NULL
Não
--lock-zookeeper-host
Host e porta para conectar-se ao cluster do Zookeeper quando você usa o zookeeper provedor de bloqueio.

Por exemplo: 127.0.0.1:2181
Sim, se você definir --lock-provider=zookeeper
--lock-zookeeper-path
O caminho onde o Zookeeper salva bloqueios.

O caminho padrão é: /magento/locks
Não
--lock-file-path
O caminho onde os bloqueios de arquivo são salvos.
Sim, se você definir --lock-provider=file

Opções de configuração de consumidores:

Nome
Descrição
Valor
Obrigatório
--consumers-wait-for-messages
Determina se os consumidores aguardarão uma mensagem da fila.
1 - Sim, 0 - Não
Não

  • 0: Os consumidores processam as mensagens disponíveis na fila, fecham a conexão TCP e terminam. Os consumidores não esperam que mensagens adicionais entrem na fila, mesmo se o número de mensagens processadas for menor que o --max_messages valor especificado durante o início dos consumidores.

  • 1: Os consumidores continuam a processar mensagens da fila de mensagens até atingir o número máximo de mensagens (o valor especificado para --max_messages no queue:consumers:start antes de fechar a conexão TCP e encerrar o processo do consumidor. Se a fila ficar vazia antes de atingir --max_messages o consumidor aguarda a chegada de mais mensagens. Se você usar trabalhadores para executar consumidores em vez de usar um trabalho cron, defina essa variável como 1.

WARNING
A variável --consumers-wait-for-messages é uma opção global e não pode ser configurada separadamente para cada consumidor.
NOTE
Para ativar ou desativar módulos após a instalação do Adobe Commerce, consulte Ativar e desativar módulos.

Dados sensíveis:

O Adobe Commerce usa sua chave de criptografia para criptografar o seguinte:

  • Informações de cartão de crédito
  • Nomes de usuários e senhas especificados na configuração do Administrador (por exemplo, logons em gateways de pagamento)
  • Valores de CAPTCHA enviados pela rede

Adobe Commerce faz não criptografia:

  • Nomes de usuário e senhas administrativos e de clientes (essas senhas têm hash)
  • Endereço
  • Número de telefone
  • Outros tipos de informações pessoalmente identificáveis, exceto para números de cartão de crédito

Exemplos de instalações localhost

Os exemplos a seguir mostram os comandos para instalar o Adobe Commerce localmente com várias opções.

Exemplo 1 — Instalação básica com conta de usuário administrador

O exemplo a seguir instala o Adobe Commerce com as seguintes opções:

  • O aplicativo é instalado no magento2 diretório relativo ao docroot do servidor Web em localhost e o caminho para o Administrador é admin; por conseguinte:

    O URL da vitrine está http://127.0.0.1

  • O servidor de banco de dados está no mesmo host que o servidor Web.

    O nome do banco de dados é magento, e o nome de usuário e a senha são magento

  • Usa regravações de servidor

  • O administrador tem as seguintes propriedades:

    • Nome e sobrenome são Magento User
    • O nome de usuário é admin e a senha for admin123
    • O endereço de e-mail é user@example.com

  • O idioma padrão é en_US (Inglês dos EUA)

  • A moeda padrão é dólares americanos

  • O fuso horário padrão é Central dos EUA (América/Chicago)

  • O OpenSearch 1.2 está instalado em os-host.example.com e se conecta na porta 9200

magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--admin-firstname=Magento --admin-lastname=User --admin-email=user@example.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

Mensagens semelhantes às seguintes são exibidas para indicar uma instalação bem-sucedida:

Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q

Exemplo 2— Instalação básica sem conta de usuário administrador

Você pode instalar o Adobe Commerce sem criar o usuário administrador, conforme mostrado no exemplo a seguir.

magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--language=en_US --currency=USD --timezone=America/Chicago --use-rewrites=1 \
--search-engine=opensearch --opensearch-host=os-host.example.com \
--opensearch-port=9200

Mensagens como as seguintes serão exibidas se a instalação for bem-sucedida:

Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q

Após a instalação, é possível criar um usuário administrador usando o admin:user:create comando:
Criar ou editar um administrador

Exemplo 3 — Instalação com opções adicionais

O exemplo a seguir instala o Adobe Commerce com as seguintes opções:

  • O aplicativo é instalado no magento2 diretório relativo ao docroot do servidor Web em localhost e o caminho para o Administrador é admin; por conseguinte:

    O URL da vitrine está http://127.0.0.1

  • O servidor de banco de dados está no mesmo host que o servidor Web.

    O nome do banco de dados é magento, e o nome de usuário e a senha são magento

  • O administrador tem as seguintes propriedades:

    • Nome e sobrenome são Magento User
    • O nome de usuário é admin e a senha for admin123
    • O endereço de e-mail é user@example.com

  • O idioma padrão é en_US (Inglês dos EUA)

  • A moeda padrão é dólares americanos

  • O fuso horário padrão é Central dos EUA (América/Chicago)

  • O instalador primeiro limpa o banco de dados antes de instalar as tabelas e o esquema

  • Você pode usar o prefixo de incremento da ordem de venda ORD$ (já que contém um caractere especial) [$], o valor deve ser colocado entre aspas)

  • Os dados da sessão são salvos no banco de dados

  • Usa regravações de servidor

  • O OpenSearch está instalado em os-host.example.com e se conecta na porta 9200

magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--admin-firstname=Magento --admin-lastname=User --admin-email=user@example.com \
--admin-user=admin --admin-password=admin123 --language=en_US \
--currency=USD --timezone=America/Chicago --cleanup-database \
--sales-order-increment-prefix="ORD$" --session-save=db --use-rewrites=1 \
--search-engine=opensearch --opensearch-host=os-host.example.com \
--opensearch-port=9200
NOTE
Você deve inserir o comando em uma única linha ou, como no exemplo anterior, com um \ no final de cada linha.

Mensagens como as seguintes serão exibidas se a instalação for bem-sucedida:

Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995