Documentação Commerce Guia de instalação

Instalar o Adobe Commerce

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

Tópicos:
Instalar

Criado para:

Experiente
Administrador
Desenvolvedor

Antes de começar, conclua as seguintes etapas:

Verifique se o seu sistema atende aos requisitos discutidos nos requisitos de sistema.
Conclua todas as tarefas de pré-requisito.
Conclua as primeiras etapas de instalação. Consulte Caminho de instalação ou atualização.
Depois de fazer logon no servidor de aplicativos, alterne para o proprietário do sistema de arquivos.
Revise a visão geral da Introdução à instalação da linha de comando.

NOTE

Você deve instalar o aplicativo de seu 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 aplicativo 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 Commerce 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

magento info:language:list

Moeda

magento info:currency:list

Fuso horário

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:

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

As tabelas a seguir descrevem os nomes e valores das opções de instalação, como 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.

No Adobe Commerce versão 2.2.8 e posterior, é possível 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.

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 de site e banco de dados:

Nome

Valor

Obrigató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 aplicativo. 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 aplicativo em localhost, você pode usar http://127.0.0.1/<your install dir>/ ou http://127.0.0.1/<your install dir>/.

- {{base_url}} que representa uma URL base definida 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 de host commerce.example.com, poderá instalar o aplicativo com --base-url={{base_url}} e acessar o Administrador com uma URL como http://commerce.example.com/admin.

Sim

--backend-frontname

URI (Uniform Resource Identifier) para acessar o Administrador. Você pode omitir este 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. Você pode exibi-lo posteriormente a qualquer momento usando o comando 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 uma instância do Adobe Commerce em execução em um servidor 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.

Não

--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 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 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. (Se você ainda não tiver feito isso, poderá exibir a lista de fusos horários inserindo magento info:timezone:list no diretório bin.)

Não

--use-rewrites

1 significa que você usa regravações do servidor Web para links gerados na vitrine e no Administrador.

0 desabilita o uso de regravações do servidor Web. Este é 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 Admin e em formulários. Esses valores principais ajudam a impedir ataques de falsificação de 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 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 a aplicação, especifique este 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

TIP

Para habilitar serviços de armazenamento remoto durante a instalação, consulte Configurar Armazenamento Remoto no Guia de Configuração.

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

Nome

Valor

Obrigatório?

--search-engine

A versão do mecanismo de pesquisa. Os valores possíveis são elasticsearch7, elasticsearch6 e elasticsearch5. O padrão é elasticsearch7. Se você instalou o OpenSearch como mecanismo de pesquisa, especifique o valor elasticsearch7. O Elasticsearch 5 foi descontinuado e não é recomendado.

Não

--elasticsearch-host

O nome do host ou endereço IP onde o mecanismo de pesquisa está sendo executado. O padrão é localhost.

Não

--elasticsearch-port

A porta para solicitações HTTP de entrada. O padrão é 9200.

Não

--elasticsearch-index-prefix

Um prefixo que identifica o índice de pesquisa. 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 do mecanismo de pesquisa. O padrão é false.

Não

--elasticsearch-username

A ID do usuário a ser autenticada

Não, a menos que a autenticação esteja habilitada

--elasticsearch-password

A senha para autenticação

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 armazenamento remoto:

Nome

Descrição

Obrigatório?

remote-storage-driver

Nome do adaptador
Valores possíveis:
arquivo: desabilita o armazenamento remoto e usa o sistema de arquivos local
aws-s3: Use o Serviço de Armazenamento Simples da Amazon (Amazon S3)

Não

remote-storage-bucket

Armazenamento de objetos ou nome do container

Não

remote-storage-prefix

Prefixo opcional (local dentro do armazenamento de objetos)

Não

remote-storage-region

Nome da região

Não

remote-storage-key

Chave de acesso opcional

Não

remote-storage-secret

Chave secreta opcional

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 aplicativo, 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 aplicativo 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
Usa regravações de servidor
O administrador tem as seguintes propriedades:
- O nome e o sobrenome são Commerce 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 Elasticsearch 7 está instalado em es-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=Commerce --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=elasticsearch7 --elasticsearch-host=es-host.example.com \
--elasticsearch-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 aplicativo 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=elasticsearch7 --elasticsearch-host=es-host.example.com \
--elasticsearch-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 aplicativo com as seguintes opções:

O Magapplication 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 Commerce 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ê usa um prefixo de incremento de 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 Elasticsearch 7 está instalado em es-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=Commerce --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=elasticsearch7 --elasticsearch-host=es-host.example.com \
--elasticsearch-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

TIP

Se você tiver uma conta de usuário para acessar o servidor de aplicativos, consulte definir uma máscara. Esse tipo de configuração é típica de hospedagem compartilhada.

recommendation-more-help

0f8e7db5-0e9c-4002-a5b8-a0088077d995