ECE-Tools 패키지를 사용하도록 프로젝트 업그레이드

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

주제:
클라우드

작성 대상:

관리자
개발자

Adobe은 ece-tools 패키지를 위해 magento/magento-cloud-configuration 및 magento/ece-patches 패키지를 더 이상 사용하지 않으므로 많은 클라우드 프로세스를 단순화합니다. ece-tools 패키지가 포함되지 않은 클라우드 인프라 프로젝트에서 이전 Adobe Commerce을 사용하는 경우 프로젝트에 대해 일회성, 수동 업그레이드 프로세스를 수행해야 합니다.

WARNING

프로젝트에 ece-tools 패키지가 포함된 경우 다음 업그레이드를 건너뛸 수 있습니다. 확인하려면 로컬 프로젝트 루트 디렉터리에서 php vendor/bin/ece-tools -V 명령을 사용하여 Commerce 버전을 검색하십시오.

이 프로젝트를 업그레이드하려면 루트 디렉터리의 composer.json 파일에서 magento/magento-cloud-metapackage 버전 제약 조건을 업데이트해야 합니다. 이 제한 사항을 사용하면 현재 Adobe Commerce 버전을 업그레이드하지 않고도 더 이상 사용되지 않는 패키지를 제거하는 등 Adobe Commerce에서 클라우드 인프라 메타패키지를 업데이트할 수 있습니다.

TIP

업그레이드 또는 패치 프로세스를 시작하기 전에 통합 환경에서 활성 분기를 만들고 로컬 워크스테이션에 새 분기를 체크아웃합니다. 업그레이드 또는 패치 프로세스에 분기를 할당하면 진행 중인 작업에 방해가 되지 않습니다.

더 이상 사용되지 않는 패키지 제거

ece-tools 패키지를 사용하도록 업그레이드를 수행하기 전에 더 이상 사용되지 않는 다음 패키지에 대한 composer.lock 파일을 확인하십시오.

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

메타패키지 업데이트

각 Adobe Commerce 버전에는 다음에 따라 다른 제한 사항이 필요합니다.

>=current_version <next_version

current_version의 경우 설치할 Adobe Commerce 버전을 지정하십시오.
next_version의 경우 current_version에 지정된 값 뒤에 다음 패치 버전을 지정하십시오.

Adobe Commerce 2.3.5-p2을(를) 설치하려면 current_version을(를) 2.3.5(으)로 설정하고 next_version을(를) 2.3.6(으)로 설정합니다. 제약 조건 ">=2.3.5 <2.3.6"은(는) 2.3.5에 사용 가능한 최신 패키지를 설치합니다.

magento-cloud 템플릿에서 항상 최신 메타패키지 제약 조건을 찾을 수 있습니다.

다음 예제에서는 Adobe Commerce on cloud infrastructure 메타패키지에 대해 현재 버전 2.4.7보다 크거나 같고 다음 버전 2.4.8보다 작은 버전을 제한합니다.

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

프로젝트 업그레이드

ece-tools 패키지를 사용하도록 프로젝트를 업그레이드하려면 메타패키지 및 .magento.app.yaml 후크 속성을 업데이트하고 작성기 업데이트를 수행해야 합니다.

ece 도구를 사용하도록 프로젝트를 업그레이드하려면:

composer.json 파일에서 magento/magento-cloud-metapackage 버전 제약 조건을 업데이트합니다.

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

메타패키지를 업데이트합니다.

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

magento.app.yaml 파일에서 후크 명령을 수정합니다.

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

더 이상 사용되지 않는 패키지를 확인하고 제거하십시오. 더 이상 사용되지 않는 패키지로 인해 업그레이드가 성공적으로 수행되지 않을 수 있습니다.

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

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

ece-tools 패키지를 업데이트해야 할 수 있습니다.

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

코드 변경 사항을 추가하고 커밋합니다. 이 예에서는 다음 파일이 업데이트되었습니다.

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

코드 변경 내용을 원격 서버에 푸시하고 이 분기를 integration 분기와 병합합니다.

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

recommendation-more-help

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