DocumentaçãoCommerceGuia de instalação

Instalação avançada local

Last update: Sun Nov 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Experiente
  • Administrador
  • Desenvolvedor
TIP
Perdido? Precisa de ajuda? Experimente nossos guias de Instalação rápida ou Instalação do colaborador.
NOTE
Se você optou por habilitar 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 baseada em Symfony.
  • O CLI é extensível para que desenvolvedores de terceiros possam "fazer o plug-in" a ele. 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 o 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 o servidor da Web para a Camada de Soquetes Seguros (SSL), você pode executar o instalador para definir as opções de SSL.

  • Correto erros em instalações anteriores

  • Instale Adobe Systems Comércio em um banco de dados diferente instância

Antes de start sua instalação

Antes de começar, conclua as seguintes etapas:

NOTE
Você deve instalar o Adobe Commerce do subdiretório bin.

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 parâmetro cleanup-database opcional 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 como uma URL segura (ou seja, começando com https://)
  • --use-secure-admin Definido 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.

É possível criar o usuário de Administração durante ou após a instalação. Se você criar o usuário durante a instalação, todas as administrador variáveis de credencial serão necessárias. Consulte Exemplos de instalações do 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 a 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
Administrador usuário senha. 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 de site e banco de dados:

Nome
Valor
Necessário?
--base-url
URL base a ser usada para acessar seu Administrador e vitrine em qualquer um dos seguintes formatos:

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

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

<your install dir> é o caminho relativo de 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 base definido por uma configuração de host virtual ou por um ambiente de virtualização curtir Docker. Por exemplo, se você configurar uma host virtual com o nome magento.example.comdo host, poderá instalar o software e --base-url={{base_url}} acessar o Administrador com um URL curtir http://magento.example.com/admin.
Sim
--backend-frontname
Uniforme identificador de recurso (URI) 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 administrador_jkhgdfq.

Recomendamos um URI aleatório para fins de segurança. Um URI aleatório é mais difícil para hackers ou softwares maliciosos explorarem.

O URI é exibido no final da instalação. Você pode exibi-lo posteriormente a qualquer momento usando o comando bin/magento info:adminuri.

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 somente o caractere de sublinhado (_).
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 Web.localhost significa que a biblioteca de 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 a documentação do PHP PDO_MYSQL.

Observação: você pode especificar opcionalmente 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 desta 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 digitando bin/magento info:language:list no 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 digitando bin/magento info:currency:list no diretório bin.)
Não
--timezone
Fuso horário padrão a ser usado na administração e na loja. (Caso ainda não tenha feito, é possível visualização o lista de fusos horários entrando bin/magento info:timezone:list no bin/ diretório).
Não
--use-rewrites
1 significa que você usa reescritas do servidor da Web para links gerados na vitrine e administração.

0 desativa o uso de reescritas do servidor da Web. Esse é o padrão.
Não
--use-secure
1 habilita o uso de SSL (Secure Sockets Layer) nas URLs de vitrine. Antes de selecionar essa opção, verifique se o servidor Web oferece suporte para SSL.

0 desabilita o uso de 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 segura a ser usada 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 Administrador e nos formulários. Esses valores principais ajudam a evitar ataques de falsificação do script entre sites. Este é o padrão.

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

- db para armazenar dados de 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 armazenamento dados da sessão em Redis. Se você estiver usando Redis como padrão ou página armazenamento em cache, o Redis deve estar instalado. Consulte Usar Redis para armazenamento de sessão para obter informações adicionais sobre a configuração de 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 soltar tabelas de banco de dados antes de instalar o Adobe Systems Comércio, especifique este parâmetro sem um valor. Caso contrário, o banco de dados fica 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
O openSearch porta 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 as opções de --amqp, a menos que já tenha configurado uma instalação do RabbitMQ. Consulte a instalação do RabbitMQ para obter mais informações sobre como instalar e configurar o RabbitMQ.

O nome do host em que RabbitMQ está instalado.
Não
--amqp-port
A porta a ser usada para conexão com 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 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 conectar a RabbitMQ. O padrão é false. Consulte RabbitMQ para obter informações sobre como configurar o SSL para RabbitMQ.
Não
--consumers-wait-for-messages
Os consumidores devem aguardar uma mensagem da fila? 1 - Sim, 0 - Não
Não

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

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 o provedor de bloqueio db.

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

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 valor --max_messages especificado durante a inicialização de 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 comando 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 opção --consumers-wait-for-messages é global e não pode ser configurada separadamente para cada consumidor.
NOTE
Para habilitar ou desabilitar módulos após a instalação do Adobe Commerce, consulte Habilitar e desabilitar módulos.

Dados confidenciais:

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 fazer não criptografar:

  • 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:

  • A aplicativo é instalada no magento2 diretório relativo à raiz do servidor da Web ativada localhost e o caminho para o Administrador é admin; portanto:

    Sua URL de vitrine é http://127.0.0.1

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

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

  • Usa regravações de servidor

  • O administrador tem as seguintes propriedades:

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

  • O idioma padrão é en_US (inglês americano)

  • 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, você pode criar um usuário administrador usando o comando admin:user:create:
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 está instalado no diretório magento2 relativo ao docroot do servidor Web em localhost e o caminho para o Administrador é admin; portanto:

    Sua URL de vitrine é 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:

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

  • O idioma padrão é en_US (inglês americano)

  • 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$ (como ele contém um caractere especial [$], o valor deve ser colocado entre aspas duplas)

  • 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 caractere \ 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