Documentação Commerce Guia do Commerce na infraestrutura em nuvem

Atualizar projeto para usar o pacote ECE-Tools

Last update: Wed Apr 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:
Cloud
Install

Criado para:

Admin
Developer

Adobe descontinuou o magento/magento-cloud-configuration e magento/ece-patches pacotes a favor do ece-tools que simplifica muitos processos na nuvem. Se você usar um projeto mais antigo do Adobe Commerce na infraestrutura em nuvem que não não contém o ece-tools pacote, você deverá executar um procedimento único, manual atualização para o seu projeto.

WARNING

Se o seu projeto contiver a variável ece-tools pacote, você pode ignorar a atualização a seguir. Para verificar, recupere a variável Commerce versão usando o php vendor/bin/ece-tools -V no diretório raiz do projeto local.

Este processo de atualização de projeto requer que você atualize o magento/magento-cloud-metapackage restrição de versão no composer.json no diretório raiz. Essa restrição permite atualizações para o Adobe Commerce em metapackages de infraestrutura em nuvem, incluindo a remoção de pacotes obsoletos, sem atualizar a versão atual do Adobe Commerce.

TIP

Antes de iniciar uma atualização ou um processo de patch, crie uma ramificação ativa do ambiente de integração e faça check-out da nova ramificação para a estação de trabalho local. Dedicar uma ramificação à atualização ou ao processo de patch ajuda a evitar interferência com o trabalho em andamento.

Remover pacotes obsoletos

Antes de executar uma atualização para usar o ece-tools pacote, verifique a composer.lock arquivo para os seguintes pacotes obsoletos:

magento/magento-cloud-configuration
magento/ece-patches

Atualizar o metapackage

Cada versão do Adobe Commerce exige uma restrição diferente com base no seguinte:

>=current_version <next_version

Para current_version, especifique a versão do Adobe Commerce a ser instalada.
Para next_version, especifique a próxima versão de patch após o valor especificado em current_version.

Se você deseja instalar o Adobe Commerce 2.3.5-p2, definir current_version para 2.3.5 e a variável next_version para 2.3.6. A restrição ">=2.3.5 <2.3.6" instala o pacote mais recente disponível para a versão 2.3.5.

Você sempre pode encontrar a restrição do metapackage mais recente no magento-cloud modelo.

O exemplo a seguir coloca uma restrição para o metapackage do Adobe Commerce na infraestrutura em nuvem para qualquer versão maior ou igual à versão atual 2.4.7 e anterior à próxima versão 2.4.8:

"require": {
    "magento/magento-cloud-metapackage": ">=2.4.7 <2.4.8"
},

Atualizar o projeto

Para atualizar seu projeto para usar o ece-tools pacote, você deve atualizar o metapackage e o .magento.app.yaml conecta as propriedades e executa uma atualização do Composer.

Para atualizar o projeto para usar as ferramentas ece:

Atualize o magento/magento-cloud-metapackage restrição de versão no composer.json arquivo.

code language-bash
`composer require "magento/magento-cloud-metapackage":">=2.4.7 <2.4.8" --no-update`

Atualize o metapackage.

code language-bash
`composer update magento/magento-cloud-metapackage`

Modifique os comandos de gancho no magento.app.yaml arquivo.

code language-yaml

code language-yaml
hooks: # We run build hooks before your application has been packaged. build: \| set -e 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

hooks:
    # We run build hooks before your application has been packaged.
    build: |
        set -e
        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

Verifique e remova o pacotes obsoletos. Os pacotes obsoletos podem impedir uma atualização bem-sucedida.

code language-bash
`composer remove magento/magento-cloud-configuration`

code language-bash
`composer remove magento/ece-patches`

Pode ser necessário atualizar a ece-tools pacote.

code language-bash
`composer update magento/ece-tools`

Adicione e confirme as alterações de código. Neste exemplo, os seguintes arquivos foram atualizados:

code language-terminal
`.magento.app.yaml composer.json composer.lock`

Enviar as alterações de código para o servidor remoto e mesclar esta ramificação com o integration filial.

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

recommendation-more-help

05f2f56e-ac5d-4931-8cdb-764e60e16f26