업그레이드 수행

업그레이드할 수 있습니다 온-프레미스 다음 방법으로 소프트웨어를 설치한 경우 명령줄에서 Adobe Commerce 애플리케이션 배포:

  • 다음을 사용하여 작성기 메타패키지 다운로드 composer create-project 명령입니다.
  • 압축된 아카이브를 설치하는 중입니다.
NOTE
  • 클라우드 인프라 프로젝트의 Adobe Commerce에 대해서는 다음을 참조하십시오. Commerce 버전 업그레이드 Cloud Guide에서 참조하십시오.
  • GitHub 저장소를 복제한 경우 이 메서드를 사용하여 업그레이드하지 마십시오. 다음을 참조하십시오 Git 기반 설치 업그레이드.

다음 지침은 Composer 패키지 관리자를 사용하여 업그레이드하는 방법을 보여 줍니다. Adobe Commerce 2.4.2에서는 Composer 2에 대한 지원을 도입했습니다. <2.4.1에서 업그레이드하려는 경우 먼저 Composer 1을 사용하여 Composer 2와 호환되는 버전(예: 2.4.2)으로 업그레이드해야 합니다 다음 이전 >2.4.2 업그레이드를 위해 Composer 2로 업그레이드. 또한 다음을 실행해야 합니다. 지원되는 버전 PHP를 참조하십시오.

WARNING
Adobe Commerce 업그레이드 절차가 변경되었습니다. 의 새 버전을 설치해야 합니다. magento/composer-root-update-plugin 패키지(참조) 전제 조건). 또한 업그레이드 명령이에서 변경되었습니다 composer require magento/<package_name>composer require-commerce magento/<package_name>.

시작하기 전에

다음을 완료해야 합니다. 업그레이드 사전 요구 사항 업그레이드 프로세스를 시작하기 전에 환경을 준비합니다.

패키지 관리

NOTE
다양한 릴리스 수준을 지정하는 데 도움이 필요하면 이 섹션 끝에 있는 예 를 참조하십시오. 예를 들어 품질 패치와 보안 패치가 있습니다. Composer에서 이러한 패키지를 찾을 수 없는 경우 Adobe Commerce 지원에 문의하십시오.
  1. 업그레이드 프로세스 중에 스토어에 액세스할 수 없도록 유지 관리 모드로 전환합니다.

    code language-bash
    bin/magento maintenance:enable
    

    다음을 참조하십시오 유지 관리 모드 활성화 또는 비활성화 추가 옵션. 필요한 경우 다음을 만들 수 있습니다. 사용자 지정 유지 관리 모드 페이지.

  2. 메시지 큐 소비자와 같은 비동기 프로세스가 실행되는 동안 업그레이드 프로세스를 시작하면 데이터가 손상될 수 있습니다. 데이터 손상을 방지하려면 모든 cron 작업을 비활성화하십시오.

    클라우드 인프라의 Adobe Commerce:

    code language-bash
    ./vendor/bin/ece-tools cron:disable
    

    Magento Open Source:

    code language-bash
    bin/magento cron:remove
    
  3. 모든 메시지가 소비되도록 모든 메시지 대기열 소비자를 수동으로 시작합니다.

    code language-bash
    bin/magento cron:run --group=consumers
    

    cron 작업이 완료될 때까지 기다립니다. 프로세스 뷰어를 사용하거나 ps aux | grep 'bin/magento queue' 모든 프로세스가 완료될 때까지 여러 번 명령합니다.

  4. 의 백업 만들기 composer.json 파일.

    code language-bash
    cp composer.json composer.json.bak
    
  5. 필요에 따라 특정 패키지를 추가하거나 제거합니다.

    예를 들어 Magento Open Source에서 Adobe Commerce으로 업그레이드하는 경우 Magento Open Source 패키지를 제거합니다.

    code language-bash
    composer remove magento/product-community-edition --no-update
    

    샘플 데이터를 업그레이드할 수도 있습니다.

    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
      
  6. 다음을 사용하여 인스턴스 업그레이드 composer require-commerce 명령 구문:

    code language-bash
    composer require-commerce magento/<product> <version> --no-update [--interactive-root-conflicts] [--force-root-updates] [--help]
    

    명령 옵션은 다음과 같습니다.

    • <product> —(필수) 업그레이드할 패키지입니다. 온-프레미스 설치의 경우 이 값은 다음 중 하나여야 합니다 product-community-edition 또는 product-enterprise-edition.

    • <version> —(필수) 업그레이드 중인 Adobe Commerce 버전입니다. 예를 들어, 2.4.3.

    • --no-update —(필수) 종속성에 대한 자동 업데이트를 비활성화합니다.

    • --interactive-root-conflicts — (선택 사항) 이전 버전의 오래된 값 또는 업그레이드하려는 버전과 일치하지 않는 사용자 정의된 값을 대화식으로 보고 업데이트할 수 있습니다.

    • --force-root-updates —(선택 사항) 충돌하는 모든 사용자 지정 값을 예상 Commerce 값으로 재정의합니다.

    • --help —(선택 사항) 플러그인에 대한 사용 세부 사항을 제공합니다.

    둘 다 아닌 경우 --interactive-root-conflicts nor --force-root-updates 지정된 경우, 이 명령은 충돌하는 기존 값을 유지하고 경고 메시지를 표시합니다. 플러그인에 대한 자세한 내용은 플러그인 사용 README.

  7. 종속성을 업데이트합니다.

    code language-bash
    composer update
    

예 - 사용 가능한 버전 나열

사용 가능한 2.4.x 버전의 전체 목록을 보려면 다음을 수행하십시오.

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

예 - 품질 패치

품질 패치에는 주로 기능이 포함됩니다 보안 수정 사항. 그러나 이전 버전과 호환되는 새로운 기능이 포함될 수도 있습니다. 작성기를 사용하여 품질 패치를 다운로드합니다.

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

예 - 보안 패치

보안 패치에는 보안 수정 사항만 포함됩니다. 업그레이드 프로세스를 더 빠르고 쉽게 할 수 있도록 설계되었습니다. 보안 패치는 작성기 이름 지정 규칙을 사용합니다 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

메타데이터 업데이트

  1. 업데이트 "name", "version", 및 "description" 의 필드 composer.json 필요에 따라 파일을 생성합니다.

    note note
    NOTE
    에서 메타데이터 업데이트 composer.json 파일이 완전히 피상적이어서 제대로 작동하지 않습니다.
  2. 업데이트를 적용합니다.

    code language-bash
    composer update
    
  3. 지우기 var/generated/ 하위 디렉터리:

    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
    파일 시스템 이외의 캐시 스토리지(예: Redis 또는 Memcached)를 사용하는 경우 해당 캐시도 수동으로 지워야 합니다.
  4. 데이터베이스 스키마 및 데이터를 업데이트합니다.

    code language-bash
    bin/magento setup:upgrade
    
  5. 유지 관리 모드를 비활성화합니다.

    code language-bash
    bin/magento maintenance:disable
    
  6. (선택 사항) 바니쉬를 다시 시작합니다.

    페이지 캐싱에 Vannish를 사용하는 경우 다시 시작합니다.

    code language-bash
    service varnish restart
    

작업 확인

업그레이드가 성공했는지 확인하려면 웹 브라우저에서 상점 URL을 여십시오. 업그레이드에 실패한 경우 상점이 제대로 로드되지 않습니다.

다음 오류가 발생하여 애플리케이션이 실패하는 경우 We're sorry, an error has occurred while generating this email. 오류:

  1. 재설정 파일 시스템 소유권 및 권한 을 사용하는 사용자로서 root 권한.

  2. 다음 디렉터리를 지웁니다.

    • var/cache/
    • var/page_cache/
    • generated/code/
  3. 웹 브라우저에서 상점을 다시 확인하십시오.

recommendation-more-help
83a60e0e-8849-4685-a8cd-c129ecd795ea