Commerce 버전 업그레이드

config.local.php 파일의 복사본을 만들고 이름을 config.php(으)로 지정합니다.

이 파일을 프로젝트의 app/etc 폴더에 추가합니다.

파일을 추가하여 분기에 커밋합니다.

파일을 통합 분기에 푸시합니다.

업그레이드 프로세스를 계속합니다.

로컬 워크스테이션에서 프로젝트 디렉터리로 변경합니다.

통합 분기를 확인하십시오.

텍스트 편집기에서 composer.json 파일을 엽니다.

컨트롤러 종속성에 대한 Zend 플러그 인 관리자 구현에 대한 autoload:psr-4 섹션을 확인하십시오.

 "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/"
    },
}

Zend 종속성이 없으면 composer.json 파일을 업데이트하십시오.

• autoload:psr-4 섹션에 다음 줄을 추가하십시오.

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

• 프로젝트 종속성을 업데이트합니다.

  code language-bash
  composer update

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

  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>

• 변경 사항을 스테이징 환경에 병합한 다음 프로덕션에 병합합니다.

로컬 워크스테이션에서 프로젝트 디렉터리로 변경합니다.

magento.app.yaml 파일을 열고 편집합니다.

PHP 옵션을 업데이트합니다.

type: php:8.3

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

hooks 속성 build 및 deploy 명령을 수정합니다.

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

파일 끝에 다음 환경 변수를 추가합니다.

Adobe Commerce 2.2.x - 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'

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'

파일을 저장합니다. 아직 원격 환경에 변경 사항을 커밋하거나 푸시하지 마십시오.

업그레이드 프로세스를 계속합니다.

config 섹션에 다음 allow-plugins을(를) 추가합니다.

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

require 섹션에 다음 플러그인을 추가하십시오.

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

extra:component_paths 섹션에 다음 구성 요소를 추가합니다.

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

파일을 저장합니다. 아직 분기에 변경 사항을 커밋하거나 푸시하지 마십시오.

업그레이드 프로세스를 계속합니다.

원격 데이터베이스의 로컬 백업을 만듭니다.

magento-cloud db:dump

코드 및 미디어를 백업합니다.

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

소스 제어에 이미 많은 정적 파일이 있는 경우 [--media]을(를) 생략할 수도 있습니다.

SSH를 사용하여 원격 환경에 로그인합니다.

데이터베이스 덤프를 만듭니다. DB 덤프의 대상 디렉터리를 선택하려면 --dump-directory 옵션을 사용합니다.

vendor/bin/ece-tools db-dump

덤프 작업에서 원격 프로젝트 디렉터리에 dump-<timestamp>.sql.gz 보관 파일을 만듭니다. 데이터베이스 백업을 참조하십시오.

로컬 워크스테이션에서 프로젝트 디렉터리로 변경합니다.

버전 제약 조건 구문을 사용하여 업그레이드 버전을 설정합니다.

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

프로젝트를 업데이트합니다.

composer update

현재 적용된 패치를 검토합니다.

• m2-hotfixes 디렉터리에 패치가 설치되어 있는 경우 Adobe Commerce 지원 티켓을 제출하고 Adobe Commerce 지원 팀과 함께 새 버전에 적용할 수 있는 패치를 확인하십시오. m2-hotfixes 디렉터리에서 적용할 수 없는 패치를 제거합니다.

• .magento.env.yaml 파일에 [품질 패치]가 적용된 경우 새 버전에 계속 적용할 수 있는지 확인하십시오. .magento.env.yaml 파일의 QUALITY_PATCHES 섹션에서 적용할 수 없는 패치를 제거합니다.

메서드 1: 품질 패치 릴리스 정보에서 해당 버전을 확인

메서드 2: 사용 가능한 패치와 상태 보기

메서드 3: 패치 검색

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

git add -A

git commit -m "Upgrade"

git push origin <branch-name>

Composer가 기본 패키지를 마샬링하는 방식 때문에 변경된 모든 파일을 소스 제어에 추가하려면 git add -A이(가) 필요합니다. 기본 패키지(magento/magento2-base 및 magento/magento2-ee-base)의 composer install 및 composer update 파일을 모두 패키지 루트로 마샬링합니다.

작성기가 마샬링하는 파일은 새 버전의 Adobe Commerce에 속하므로 동일한 파일의 오래된 버전을 덮어씁니다. 현재 Adobe Commerce에서는 마샬링을 사용할 수 없으므로 마샬링된 파일을 소스 제어에 추가해야 합니다.

배포가 완료될 때까지 기다립니다.

SSH를 사용하여 로그인하고 버전을 확인하여 통합, 스테이징 또는 프로덕션 환경에서 업그레이드를 확인합니다.

php bin/magento --version

터미널에서 SSH 명령을 사용하여 환경에 대한 /app/etc/config.php 파일을 생성합니다.

ssh <SSH-URL> "<Command>"

예를 들어 Pro의 경우 integration 분기에서 scd-dump을(를) 실행하려면 다음을 수행합니다.

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

rsync 또는 scp을(를) 사용하여 config.php 파일을 로컬 워크스테이션에 전송하십시오. 이 파일은 로컬에서만 분기에 추가할 수 있습니다.

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

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

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

모듈 목록과 구성 설정을 사용하여 업데이트된 /app/etc/config.php 파일을 생성합니다.

로컬 워크스테이션에 분기를 만듭니다.

필요에 따라 확장을 비활성화합니다.

사용 가능한 경우 확장 업그레이드를 다운로드합니다.

타사 설명서에 따라 업그레이드를 설치합니다.

확장을 활성화하고 테스트합니다.

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

을 푸시하고 통합 환경에서 테스트합니다.

스테이징 환경으로 푸시하여 사전 프로덕션 환경에서 테스트합니다.

로컬 워크스테이션에서 프로젝트 디렉터리로 변경합니다.

SSH를 사용하여 원격 환경에 로그인합니다.

magento-cloud ssh

./app/var/report/<error number> 파일을 엽니다.

로그를 검사하고 문제의 원인을 확인합니다.

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

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