패치 적용

Commerce용 클라우드 패치품질 패치 도구 설치된 Adobe Commerce 애플리케이션에 패치를 제공합니다.

  • Cloud Patches for Commerce 패키지는 중요한 수정 사항이 있는 필요한 패치를 제공합니다
  • 품질 패치는 다음과 같이 영향이 적은 품질 수정 사항을 옵션으로 제공합니다. 개별 패치 이전 버전과 호환 불가능한 변경 사항이 포함되지 않은 경우

다음을 참조하십시오 사용 가능한 패치 다음에서 Commerce Operations Tools 안내서 릴리스된 패치의 전체 목록을 검토합니다.

두 패키지 모두 클라우드 환경과 모든 Adobe Commerce 버전의 통합을 개선하고 중요, 선택 사항 및 사용자 지정 수정 사항의 빠른 전달을 지원합니다. 이러한 패키지를 사용하여 Commerce에 사용할 수 있는 모든 개별 패치에 대한 일반 정보를 적용, 되돌리기 및 볼 수 있습니다.

TIP
다음을 사용할 수 있습니다. 품질 패치 도구 Magento Open Source 및 Adobe Commerce 프로젝트를 위한 독립형 패키지로 Commerce용 클라우드 패치 클라우드가 아닌 프로젝트에는 품질 패치 도구 를 사용하는 것이 좋습니다.

원격 환경에 변경 사항을 배포하는 경우 ece-tools 패키지 사용 magento/magento-cloud-patchesmagento/quality-patches 보류 중인 패치를 확인하고 다음 순서로 자동으로 적용하려면

  1. Commerce용 클라우드 패치 패키지에 포함된 모든 필수 Commerce 패치를 적용합니다.
  2. 품질 패치 도구에 포함된 선택한 선택적 Commerce 패치를 적용합니다.
  3. 에서 사용자 정의 패치 적용 /m2-hotfixes 디렉토리(패치 이름별 알파벳순)
NOTE
업데이트 시 ece-tools 패키지 또는 Cloud Patches for Commerce 패키지를 사용하면 다음에 프로젝트를 배포할 때 필요한 최신 패치가 적용되거나 를 사용하여 즉시 배포할 수 있습니다. ece-patches apply CLI 명령 및 클라우드 환경 재배포 건너뛸 수 없습니다. 필요한 패치 배포 프로세스 동안.

전제 조건

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

품질 패치 도구는 Cloud Patches for Commerce 및 ece-tools 패키지. 최신 패치를 적용하려면 다음을 수행해야 합니다 최신 버전의 ECE-Tools 설치됨. ECE-Tools의 최소 필요 버전은 2002.1.2입니다.

사용 가능한 패치 및 상태 보기

사용 가능한 개별 패치 목록을 보려면 다음과 같이 하십시오.

php ./vendor/bin/ece-patches status

샘플 응답:

More detailed information about patches you can find on https://support.magento.com/
╔════════════════╤═════════════════════════════════════════════════╤══════════╤═════════════╤═════════════════════════════════╗
║ Id             │ Title                                           │ Type     │ Status      │ Details                         ║
╠════════════════╪═════════════════════════════════════════════════╪══════════╪═════════════╪═════════════════════════════════╣
║ MAGECLOUD-5069 │ FPC is getting disabled during deployments      │ Required │ Applied     │ Affected components:            ║
║                │                                                 │          │             │  - magento/module-page-cache    ║
╟────────────────┼─────────────────────────────────────────────────┼──────────┼─────────────┼─────────────────────────────────╢
║ MCLOUD-5650    │ Hold deployment config after reading from file  │ Required │ Applied     │ Affected components:            ║
║                │                                                 │          │             │  - magento/framework            ║
╟────────────────┼─────────────────────────────────────────────────┼──────────┼─────────────┼─────────────────────────────────╢
║ MCLOUD-5684    │ Pagination Not working - product_list_limit=all │ Required │ Applied     │ Affected components:            ║
║                │                                                 │          │             │  - magento/module-elasticsearch ║
╟────────────────┼─────────────────────────────────────────────────┼──────────┼─────────────┼─────────────────────────────────╢
║ MC-65837       │ Fix load balancer issue                         │Deprecated│ Applied     │ Recommended replacement: MC-1   ║
║                │                                                 │          │             │ Affected components:            ║
║                │                                                 │          │             │  - magento/framework            ║
╟────────────────┼─────────────────────────────────────────────────┼──────────┼─────────────┼─────────────────────────────────╢
║ BUNDLE-2554    │ Set Payment info bug                            │ Required │ Not applied │ Affected components:            ║
║                │                                                 │          │             │  - amzn/amazon-pay-module       ║
╟────────────────┼─────────────────────────────────────────────────┼──────────┼─────────────┼─────────────────────────────────╢
║ MC-1           │ Fixes issue 1                                   │ Optional │ Applied     │ Affected components:            ║
║                │                                                 │          │             │  - magento/module-cms           ║
╟────────────────┼─────────────────────────────────────────────────┼──────────┼─────────────┼─────────────────────────────────╢
║ MC-2           │ Fixes issue 2                                   │ Optional │ Not applied │ Affected components:            ║
║                │                                                 │          │             │  - magento/module-cms           ║
╟────────────────┼─────────────────────────────────────────────────┼──────────┼─────────────┼─────────────────────────────────╢
║ MC-3           │ Fixes issue 3                                   │ Optional │ Not applied │ Required patches:               ║
║                │                                                 │          │             │  - MC-2                         ║
║                │                                                 │          │             │ Affected components:            ║
║                │                                                 │          │             │  - magento/module-cms           ║
╟────────────────┼─────────────────────────────────────────────────┼──────────┼─────────────┼─────────────────────────────────╢
║ N/A            │ ../m2-hotfixes/MDVA_custom__2.3.5_ce.patch      │ Custom   │ N/A         │ Affected components:            ║
║                │                                                 │          │             │  - magento/module-framework     ║
╚════════════════╧═════════════════════════════════════════════════╧══════════╧═════════════╧═════════════════════════════════╝
Magento 2 Enterprise Edition, version 2.3.5.0

상태 테이블에는 다음 유형의 정보가 포함되어 있습니다.

  • 유형:

    • Optional- 품질 패치 도구 및 클라우드 패치 패키지의 모든 패치는 Adobe Commerce 및 Magento Open Source 설치에 선택 사항입니다. 클라우드 인프라의 Adobe Commerce의 경우 모든 패치는 선택 사항입니다.
    • Required—Cloud Patches for Commerce 패키지의 모든 패치가 Cloud 고객에게 필요합니다.
    • Deprecated- 개별 패치는 더 이상 사용되지 않는 것으로 표시되며 적용한 경우 되돌리는 것이 좋습니다. 더 이상 사용되지 않는 패치를 되돌리면 상태 표에 더 이상 표시되지 않습니다.
    • Custom- 'm2-hotfixes' 디렉토리의 모든 패치.
  • 상태:

    • Applied- 패치가 적용되었습니다.
    • Not applied- 패치가 적용되지 않았습니다.
    • N/A- 충돌로 인해 패치 상태를 정의할 수 없습니다.
  • 세부 사항:

    • Affected components- 영향을 받는 모듈 목록입니다.
    • Required patches- 필요한 패치(종속성) 목록입니다.
    • Recommended replacement- 더 이상 사용되지 않는 패치의 권장 대체 패치입니다.

로컬 환경에서 패치 적용

배포하기 전에 로컬 환경에서 패치를 수동으로 적용하고 테스트할 수 있습니다.

로컬 개발 환경에서 개별 패치를 적용하려면:

  1. 'QUALITY_VARIABLES' PATCH을 .magento.env.yaml 파일을 만들고 아래에 필요한 패치를 나열합니다.

    code language-yaml
    stage:
      build:
        QUALITY_PATCHES:
          - MCTEST-1002
          - MCTEST-1003
    
  2. 프로젝트 루트에서 패치를 적용합니다.

    code language-bash
    php ./vendor/bin/ece-patches apply
    

    다음 ece-patches apply 명령은 다음 순서로 패치를 적용합니다.

    • 필수 패치
    • 개별 패치 옵션
    • 에서 사용자 정의 패치 /m2-hotfixes 디렉터리
  3. 캐시를 지웁니다.

    code language-bash
    php ./bin/magento cache:clean
    
  4. 패치를 테스트하고 사용자 지정 패치를 필요한 대로 변경합니다.

원격 환경에 패치 적용

WARNING
프로덕션 환경에 배포하기 전에 통합 또는 스테이징 환경에서 모든 패치를 테스트하는 것이 좋습니다.

원격 환경에 패치를 적용하려면:

  1. 추가 QUALITY_PATCHES 변수에 대한 .magento.env.yaml 파일을 만들고 아래에 필요한 패치를 나열합니다.

    code language-yaml
    stage:
      build:
        QUALITY_PATCHES:
          - MCTEST-1002
          - MCTEST-1003
    
    note note
    NOTE
    새 버전의 Adobe Commerce으로 업그레이드한 후 새 버전에 패치가 포함되지 않은 경우 패치를 다시 적용해야 합니다.
  2. 업데이트된 항목 추가, 커밋 및 푸시 .magento.env.yaml 파일.

    code language-bash
    git add .magento.env.yaml
    
    code language-bash
    git commit -m "Apply patch"
    
    code language-bash
    git push origin <branch-name>
    

사용자 정의 패치 적용

배포하면 ECE-Tools가 모든 Adobe 패치와 사용자가 추가한 사용자 정의 패치를 /m2-hotfixes 프로젝트 루트에 있는 디렉터리입니다.

NOTE
모든 패치 파일 이름은 .patch 확장명.

클라우드 환경에서 사용자 지정 패치를 적용하고 테스트하려면:

  1. 프로젝트 루트에서 라는 디렉터리를 만듭니다. m2-hotfixes 존재하지 않는 경우

    code language-bash
    mkdir m2-hotfixes
    
  2. 패치 파일을 /m2-hotfixes 디렉토리.

  3. 코드 변경 사항을 추가, 커밋 및 푸시합니다.

    code language-bash
    git add m2-hotfixes/
    
    code language-bash
    git commit -m "Apply patch"
    
    code language-bash
    git push origin <branch-name>
    
    note note
    NOTE
    프로덕션 이전 환경에서 모든 패치를 테스트해야 합니다. 클라우드 인프라의 Adobe Commerce의 경우 magento-cloud environment:branch <branch-name> CLI 명령입니다.

사용자 정의 패치 되돌리기

이전에 적용된 사용자 지정 패치를 되돌리거나 제거하려면 다음 작업을 수행하십시오.

  1. 에서 패치 파일 삭제 /m2-hotfixes 디렉토리.

  2. 코드 변경 사항을 추가, 커밋 및 푸시합니다.

    code language-bash
    git add m2-hotfixes/
    
    code language-bash
    git commit -m "Revert patch"
    
    code language-bash
    git push origin <branch-name>
    
    note note
    NOTE
    프로덕션 이전 환경에서 테스트해야 합니다. 클라우드 인프라의 Adobe Commerce의 경우 magento-cloud environment:branch <branch-name> CLI 명령입니다.

비클라우드 프로젝트에 패치 적용

사용 품질 패치 도구 Magento Open Source 및 Adobe Commerce 프로젝트용.

로컬 환경에서 패치 되돌리기

를 사용하여 로컬 개발 환경에서 이전에 적용된 모든 패치를 되돌릴 수 있습니다. ece-patches CLI.

적용된 모든 패치를 되돌리려면 다음을 수행합니다.

php ./vendor/bin/ece-patches revert

이 명령은 다음 순서로 모든 패치를 되돌립니다.

  • /m2-hotfixes 디렉토리에서 적용된 모든 사용자 정의 패치를 되돌립니다.
  • 적용된 모든 선택적 개별 패치를 되돌립니다.
  • 적용된 모든 필수 패치를 되돌립니다.

로깅

품질 패치 도구는 모든 작업을 <Project_root>/var/log/patch.log 파일.

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26