Executar uma atualização
Você pode atualizar no local implantações do aplicativo Adobe Commerce a partir da linha de comando, se você instalou o software ao:
- Baixando o metapackage do Composer usando o
composer create-project
comando. - Instalando o arquivo compactado.
- Para projetos de infraestrutura em nuvem do Adobe Commerce, consulte Atualizar versão do Commerce no Guia da nuvem.
- Não use esse método para atualizar se você clonou o repositório GitHub. Consulte Atualizar uma instalação baseada em Git.
As instruções a seguir mostram como atualizar usando o gerenciador de pacotes do Composer. O Adobe Commerce 2.4.2 introduziu o suporte para o Composer 2. Se você estiver tentando atualizar do <2.4.1, é necessário primeiro atualizar para uma versão compatível com o Composer 2 (por exemplo, 2.4.2) usando o Composer 1 antes atualização para o Composer 2 para atualizações >2.4.2. Além disso, você deve executar um versão compatível do PHP.
magento/composer-root-update-plugin
pacote (consulte pré-requisitos). Além disso, os comandos para atualização foram alterados de composer require magento/<package_name>
para composer require-commerce magento/<package_name>
.Antes de começar
Você deve concluir o pré-requisitos de atualização para preparar seu ambiente antes de iniciar o processo de atualização.
Gerenciar pacotes
-
Alterne para o modo de manutenção para impedir o acesso ao seu armazenamento durante o processo de atualização.
code language-bash bin/magento maintenance:enable
Consulte Ativar ou desativar modo de manutenção para obter opções adicionais. Como opção, você pode criar um página de modo de manutenção personalizado.
-
Iniciar o processo de atualização enquanto processos assíncronos, como consumidores de fila de mensagens, estiverem em execução pode causar corrupção de dados. Para evitar a corrupção de dados, desative todos os trabalhos cron.
Adobe Commerce na infraestrutura em nuvem:
code language-bash ./vendor/bin/ece-tools cron:disable
Magento Open Source:
code language-bash bin/magento cron:remove
-
Inicie todos os consumidores da fila de mensagens manualmente para garantir que todas as mensagens sejam consumidas.
code language-bash bin/magento cron:run --group=consumers
Aguarde a conclusão do trabalho cron. É possível monitorar o status do processo com um visualizador de processos ou executando o
ps aux | grep 'bin/magento queue'
comando várias vezes até que todos os processos sejam concluídos. -
Crie um backup do
composer.json
arquivo.code language-bash cp composer.json composer.json.bak
-
Adicione ou remova pacotes específicos com base nas suas necessidades.
Por exemplo, se estiver atualizando do Magento Open Source para o Adobe Commerce, remova o pacote Magento Open Source.
code language-bash composer remove magento/product-community-edition --no-update
Você também pode atualizar dados de amostra.
code language-bash composer require <sample data module-1>:<version> ... <sample data module-n>:<version> --no-update
-
Adobe Commerce:
code language-bash composer require magento/module-bundle-sample-data:100.4.* magento/module-widget-sample-data:100.4.* magento/module-theme-sample-data:100.4.* magento/module-catalog-sample-data:100.4.* magento/module-customer-sample-data:100.4.* magento/module-cms-sample-data:100.4.* magento/module-catalog-rule-sample-data:100.4.* magento/module-sales-rule-sample-data:100.4.* magento/module-review-sample-data:100.4.* magento/module-tax-sample-data:100.4.* magento/module-sales-sample-data:100.4.* magento/module-grouped-product-sample-data:100.4.* magento/module-downloadable-sample-data:100.4.* magento/module-msrp-sample-data:100.4.* magento/module-configurable-sample-data:100.4.* magento/module-product-links-sample-data:100.4.* magento/module-wishlist-sample-data:100.4.* magento/module-swatches-sample-data:100.4.* magento/sample-data-media:100.4.* magento/module-offline-shipping-sample-data:100.4.* magento/module-gift-card-sample-data:100.4.* magento/module-customer-balance-sample-data:100.4.* magento/module-target-rule-sample-data:100.4.* magento/module-gift-registry-sample-data:100.4.* magento/module-multiple-wishlist-sample-data:100.4.* --no-update
-
Magento Open Source:
code language-bash composer require magento/module-bundle-sample-data:100.4.* magento/module-widget-sample-data:100.4.* magento/module-theme-sample-data:100.4.* magento/module-catalog-sample-data:100.4.* magento/module-customer-sample-data:100.4.* magento/module-cms-sample-data:100.4.* magento/module-catalog-rule-sample-data:100.4.* magento/module-sales-rule-sample-data:100.4.* magento/module-review-sample-data:100.4.* magento/module-tax-sample-data:100.4.* magento/module-sales-sample-data:100.4.* magento/module-grouped-product-sample-data:100.4.* magento/module-downloadable-sample-data:100.4.* magento/module-msrp-sample-data:100.4.* magento/module-configurable-sample-data:100.4.* magento/module-product-links-sample-data:100.4.* magento/module-wishlist-sample-data:100.4.* magento/module-swatches-sample-data:100.4.* magento/sample-data-media:100.4.* magento/module-offline-shipping-sample-data:100.4.* --no-update
-
-
Atualize sua instância usando o seguinte
composer require-commerce
sintaxe do comando:code language-bash composer require-commerce magento/<product> <version> --no-update [--interactive-root-conflicts] [--force-root-updates] [--help]
As opções de comando incluem:
-
<product>
—(Obrigatório) O pacote a ser atualizado. Para instalações locais, esse valor deve serproduct-community-edition
ouproduct-enterprise-edition
. -
<version>
—(Obrigatório) A versão do Adobe Commerce para a qual você está atualizando. Por exemplo,2.4.3
. -
--no-update
— (Obrigatório) Desabilita a atualização automática das dependências. -
--interactive-root-conflicts
—(Opcional) Permite exibir e atualizar interativamente quaisquer valores desatualizados de versões anteriores ou quaisquer valores personalizados que não correspondam à versão para a qual você está atualizando. -
--force-root-updates
—(Opcional) Substitui todos os valores personalizados conflitantes pelos valores esperados do Commerce. -
--help
—(Opcional) Fornece detalhes de uso sobre o plug-in.
Se nenhuma delas
--interactive-root-conflicts
nem--force-root-updates
forem especificados, o comando manterá os valores existentes que estiverem em conflito e exibirá uma mensagem de aviso. Para saber mais sobre o plug-in, consulte a LEIAME de uso do plug-in. -
-
Atualize as dependências.
code language-bash composer update
Exemplo - listar versões disponíveis
Para ver a lista completa de versões 2.4.x disponíveis:
Magento Open Source:
composer show magento/product-community-edition 2.4.* --available | grep -m 1 versions
Adobe Commerce:
composer show magento/product-enterprise-edition 2.4.* --available | grep -m 1 versions
Exemplo - Correção de qualidade
Os remendos de qualidade contêm principalmente e correções de segurança. No entanto, às vezes eles podem conter recursos novos e compatíveis com versões anteriores. Use o Composer para baixar um patch de qualidade.
Adobe Commerce:
composer require-commerce magento/product-enterprise-edition 2.4.6 --no-update
Magento Open Source:
composer require-commerce magento/product-community-edition 2.4.6 --no-update
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.x-px
.
Adobe Commerce:
composer require-commerce magento/product-enterprise-edition 2.4.6-p3 --no-update
Magento Open Source:
composer require-commerce magento/product-community-edition 2.4.6-p3 --no-update
Atualizar metadados
-
Atualize o
"name"
,"version"
, e"description"
campos nocomposer.json
conforme necessário.note note NOTE Atualização dos metadados no composer.json
O arquivo é totalmente superficial, não funcional. -
Aplique atualizações.
code language-bash composer update
-
Limpe a
var/
egenerated/
subdiretórios:code language-bash rm -rf var/cache/*
code language-bash rm -rf var/page_cache/*
code language-bash rm -rf generated/code/*
note note NOTE Se você usar um armazenamento em cache diferente do sistema de arquivos, como Redis ou Memcached, você também deverá limpar manualmente o cache. -
Atualize o esquema do banco de dados e os dados.
code language-bash bin/magento setup:upgrade
-
Desabilitar modo de manutenção.
code language-bash bin/magento maintenance:disable
-
(Opcional) Reinicie o Varnish.
Se você usar o Varnish para armazenamento em cache de página, reinicie-o:
code language-bash service varnish restart
Verifique o seu trabalho
Para verificar se a atualização foi bem-sucedida, abra o URL da loja em um navegador da web. Se a atualização não tiver sido bem-sucedida, a loja não será carregada corretamente.
Se o aplicativo falhar com uma We're sorry, an error has occurred while generating this email.
erro:
-
Redefinir propriedade e permissões do sistema de arquivos como usuário com
root
privilégios. -
Limpe os seguintes diretórios:
var/cache/
var/page_cache/
generated/code/
-
Verifique a vitrine eletrônica no navegador da web novamente.