Atualizar versão do Commerce

Crie uma cópia do arquivo config.local.php e nomeie-a como config.php.

Adicione este arquivo à pasta app/etc do seu projeto.

Adicione e confirme o arquivo na ramificação.

Envie o arquivo para a ramificação de integração.

Continue com o processo de atualização.

Na estação de trabalho local, altere para o diretório do projeto.

Confira a ramificação de integração.

Abra o arquivo composer.json em um editor de texto.

Verifique a seção autoload:psr-4 para a implementação do gerenciador de plug-in Zend para dependência de controladores.

 "autoload": {
    "psr-4": {
       "Magento\\Framework\\": "lib/internal/Magento/Framework/",
       "Magento\\Setup\\": "setup/src/Magento/Setup/",
       "Magento\\": "app/code/Magento/",
       "Zend\\Mvc\\Controller\\": "setup/src/Zend/Mvc/Controller/"
    },
}

Se a dependência Zend estiver ausente, atualize o arquivo composer.json:

• Adicione a seguinte linha à seção autoload:psr-4.

  code language-json
  "Zend\\Mvc\\Controller\\": "setup/src/Zend/Mvc/Controller/"

• Atualize as dependências do projeto.

  code language-bash
  composer update

• Adicionar, confirmar e enviar alterações de código.

  code language-bash
  git add -A

  code language-bash
  git commit -m "Add Zend plugin manager implementation for controllers dependency for Laminas support"

  code language-bash
  git push origin <branch-name>

• Mescle as alterações no ambiente de preparo e, em seguida, na produção.

Na estação de trabalho local, altere para o diretório do projeto.

Abra e edite o arquivo magento.app.yaml.

Atualize as opções do PHP.

type: php:8.3

build:
    flavor: none
dependencies:
    php:
        composer/composer: '2.7.2'

Modifique os comandos build e deploy da propriedade hooks.

hooks:
    # We run build hooks before your application has been packaged.
    build: |
        set -e
        composer install
        php ./vendor/bin/ece-tools run scenario/build/generate.xml
        php ./vendor/bin/ece-tools run scenario/build/transfer.xml
    # We run deploy hook after your application has been deployed and started.
    deploy: |
        php ./vendor/bin/ece-tools run scenario/deploy.xml
    # We run post deploy hook to clean and warm the cache. Available with ECE-Tools 2002.0.10.
    post_deploy: |
        php ./vendor/bin/ece-tools run scenario/post-deploy.xml

Adicione as variáveis de ambiente a seguir ao final do arquivo.

Para o Adobe Commerce 2.2.x a 2.3.x-

variables:
    env:
        CONFIG__DEFAULT__PAYPAL_ONBOARDING__MIDDLEMAN_DOMAIN: 'payment-broker.magento.com'
        CONFIG__STORES__DEFAULT__PAYMENT__BRAINTREE__CHANNEL: 'Magento_Enterprise_Cloud_BT'
        CONFIG__STORES__DEFAULT__PAYPAL__NOTATION_CODE: 'Magento_Enterprise_Cloud'

Para o Adobe Commerce 2.4.x-

variables:
    env:
        CONFIG__DEFAULT__PAYPAL_ONBOARDING__MIDDLEMAN_DOMAIN: 'payment-broker.magento.com'
        CONFIG__STORES__DEFAULT__PAYPAL__NOTATION_CODE: 'Magento_Enterprise_Cloud'

Salve o arquivo. Não confirme ou envie alterações para o ambiente remoto ainda.

Continue com o processo de atualização.

Adicionar o seguinte allow-plugins à seção config:

"config": {
   "allow-plugins": {
      "dealerdirect/phpcodesniffer-composer-installer": true,
      "laminas/laminas-dependency-plugin": true,
      "magento/*": true
   }
},

Adicionar o seguinte plug-in à seção require:

"require": {
    "magento/composer-root-update-plugin": "^2.0.3"
},

Adicionar o seguinte componente à seção extra:component_paths:

"extra": {
   "component_paths": {
      "tinymce/tinymce": "lib/web/tiny_mce_5"
   },
},

Salve o arquivo. Não confirme ou envie alterações para sua ramificação ainda.

Continue com o processo de atualização.

Crie um backup local do banco de dados remoto.

magento-cloud db:dump

Faça backup do código e da mídia.

php bin/magento setup:backup --code [--media]

Opcionalmente, você pode omitir [--media] se tiver um grande número de arquivos estáticos que já estão no controle do código-fonte.

Use o SSH para fazer logon no ambiente remoto.

Criar um despejo de banco de dados. Para escolher um diretório de destino para o despejo do banco de dados, use a opção --dump-directory.

vendor/bin/ece-tools db-dump

A operação de despejo cria um arquivo morto dump-<timestamp>.sql.gz no diretório do projeto remoto. Consulte Fazer backup do banco de dados.

Na estação de trabalho local, altere para o diretório do projeto.

Defina a versão de atualização usando a sintaxe de restrição de versão.

composer require "magento/magento-cloud-metapackage":">=CURRENT_VERSION <NEXT_VERSION" --no-update

Atualize o projeto.

composer update

Revise os patches atualmente aplicados:

• Se houver patches instalados no diretório m2-hotfixes, envie um tíquete de Suporte da Adobe Commerce e trabalhe com o Suporte da Adobe Commerce para verificar quais patches ainda podem ser aplicados à nova versão. Remova os patches não aplicáveis do diretório m2-hotfixes.

• Se houver [Patches de Qualidade] aplicados no arquivo .magento.env.yaml, verifique se eles ainda podem ser aplicados à nova versão. Remova os patches não aplicáveis da seção QUALITY_PATCHES do arquivo .magento.env.yaml.

Método 1: Verifique as versões aplicáveis nas notas de versão de Patches de Qualidade

Método 2: Exibir patches e status disponíveis

Método 3: Pesquisar patches

Adicionar, confirmar e enviar alterações de código.

git add -A

git commit -m "Upgrade"

git push origin <branch-name>

git add -A é necessário para adicionar todos os arquivos alterados ao controle do código-fonte devido à forma como o Composer realiza marshaling nos pacotes base. Os arquivos de marshaling de composer install e composer update do pacote base (magento/magento2-base e magento/magento2-ee-base) para a raiz do pacote.

Os arquivos que o Composer empacota pertencem à nova versão do Adobe Commerce, para substituir a versão desatualizada desses mesmos arquivos. Atualmente, o empacotamento está desativado no Adobe Commerce, portanto, você deve adicionar os arquivos empacotados ao controle do código-fonte.

Aguarde a conclusão da implantação.

Verifique a atualização em seu ambiente de integração, preparo ou produção usando SSH para fazer logon e verificar a versão.

php bin/magento --version

No terminal, use um comando SSH para gerar o arquivo /app/etc/config.php para o ambiente.

ssh <SSH-URL> "<Command>"

Por exemplo, para Pro, para executar o scd-dump na ramificação integration:

ssh <project-id-integration>@ssh.us.magentosite.cloud "php vendor/bin/ece-tools config:dump"

Transfira o arquivo config.php para suas estações de trabalho locais usando rsync ou scp. Você só pode adicionar este arquivo à ramificação localmente.

rsync <SSH-URL>:app/etc/config.php ./app/etc/config.php

Adicionar, confirmar e enviar alterações de código.

git add app/etc/config.php && git commit -m "Add system-specific configuration" && git push origin master

Isso gera um arquivo /app/etc/config.php atualizado com uma lista de módulos e definições de configuração.

Crie uma ramificação na estação de trabalho local.

Desative as extensões conforme necessário.

Quando disponível, baixar atualizações de extensão.

Instale a atualização conforme documentado pela documentação de terceiros.

Ative e teste a extensão.

Adicione, confirme e envie as alterações de código para o remoto.

Encaminhar e testar no ambiente de integração.

Encaminhar para o ambiente de preparo para testar em um ambiente de pré-produção.

Na estação de trabalho local, altere para o diretório do projeto.

Use o SSH para fazer logon no ambiente remoto.

magento-cloud ssh

Abra o arquivo ./app/var/report/<error number>.

Examine os logs e determine a origem do problema.

Adicionar, confirmar e enviar alterações de código.

git add -A && git commit -m "Fixed deployment failure" && git push origin <branch-name>