Upgrade Compatibility Tool 다운로드

명령줄 인터페이스에서 Upgrade Compatibility Tool을(를) 시작하려면 다음 명령을 실행하여 다운로드합니다.

composer create-project magento/upgrade-compatibility-tool uct --repository https://repo.magento.com

chmod 명령을 사용하여 도구 실행 권한을 부여해야 할 수 있습니다.

chmod +x ./uct/bin/uct

명령줄 인터페이스의 Upgrade Compatibility Tool

Upgrade Compatibility Tool은(는) 설치된 모든 모듈을 분석하여 특정 버전에 대한 Adobe Commerce 사용자 지정 인스턴스를 확인하는 도구입니다. 최신 버전의 Adobe Commerce으로 업그레이드하기 전에 해결해야 하는 중요한 문제, 오류 및 경고 목록을 반환합니다.

Upgrade Compatibility Tool에 대한 자세한 내용은 이 비디오 튜토리얼(06:02)을 참조하세요.

명령줄 인터페이스에서 Upgrade Compatibility Tool에 사용할 수 있는 명령:

upgrade:check 명령 사용

upgrade:check 명령은 해당 특정 Adobe Commerce 인스턴스에 대한 핵심 코드 변경 내용과 여기에 설치된 모든 사용자 지정 코드 변경 내용을 확인합니다.

upgrade:check 명령은 도구를 실행하는 기본 명령입니다.

bin/uct upgrade:check <dir>

여기서 <dir> 값은 Adobe Commerce 인스턴스가 있는 디렉터리입니다.

upgrade:check 명령에 사용 가능한 옵션:

Upgrade Compatibility Tool을(를) 사용하면 --ignore-current-version-compatibility-issues 옵션을 사용하여 upgrade:check 명령을 실행할 수 있습니다. Upgrade Compatibility Tool 보고서의 현재 버전에서 대상 버전으로의 업데이트와 함께 도입된 새로운 문제를 가져오려는 경우에만 이 옵션을 사용하십시오.

bin/uct upgrade:check --ignore-current-version-compatibility-issues <dir>

--coming-version 옵션 추가 중

--coming-version 옵션을 사용하여 현재 Adobe Commerce 설치와 모든 Adobe Commerce 버전 >=2.3을(를) 비교할 수 있습니다.

upgrade:check 명령을 실행할 때 버전을 매개 변수로 제공해야 합니다.

bin/uct upgrade:check <dir> -c 2.4.3

여기서 -c, --coming-version[=COMING-VERSION]은(는) Adobe Commerce 대상 버전을 참조합니다.

--coming-version을(를) 실행할 때 몇 가지 제한 사항이 있습니다.

dbschema:diff 명령 사용

두 Adobe Commerce 버전의 데이터베이스 스키마 간의 차이점을 검색할 수 있습니다.

bin/uct dbschema:diff <current-version> <target-version>

여기서 인수는 다음과 같습니다.

실행 예:

bin/uct dbschema:diff 2.4.3 2.4.3-p3

DB schema differences between versions 2.4.3 and 2.4.3-p3:

Table klarna_payments_quote constraint QUOTE_ID_KLARNA_PAYMENTS_QUOTE_QUOTE_ID_QUOTE_ENTITY_ID is present only in version 2.4.3-p3
Table klarna_payments_quote index KLARNA_PAYMENTS_QUOTE_SESSION_ID is present only in version 2.4.3-p3
Table customer_entity column session_cutoff is present only in version 2.4.3-p3
Table customer_visitor column session_id length value is different. 2.4.3: "64", 2.4.3-p3: "1"
Table customer_visitor column session_id comment value is different. 2.4.3: "Session ID", 2.4.3-p3: "Deprecated: Session ID value no longer used"
Table customer_visitor column created_at is present only in version 2.4.3-p3
Table oauth_consumer column secret length value is different. 2.4.3: "32", 2.4.3-p3: "128"
Table oauth_token column secret length value is different. 2.4.3: "32", 2.4.3-p3: "128"
Table admin_user_session column session_id nullable value is different. 2.4.3: "false", 2.4.3-p3: "true"
Table admin_user_session column session_id length value is different. 2.4.3: "128", 2.4.3-p3: "1"
Table admin_user_session column session_id comment value is different. 2.4.3: "Session ID value", 2.4.3-p3: "Deprecated: Session ID value no longer used"

Total detected differences between version 2.4.3 and 2.4.3-p3: 11

core:code:changes 명령 사용

현재 Adobe Commerce 설치를 비교하여 Adobe Commerce의 핵심 코드가 사용자 지정을 구현하기 위해 수정되었는지 확인할 수 있습니다. 이 명령은 핵심 수정 사항 목록만 표시합니다.

bin/uct core:code:changes <dir> <vanilla dir>

여기서 인수는 다음과 같습니다.

core:code:changes 명령에 사용 가능한 옵션:

바닐라 설치

vanilla 설치는 특정 릴리스 버전에 대해 지정된 버전 태그 또는 분기를 깔끔하게 설치하는 것입니다.

bin/uct core:code:changes 명령은 시스템에 바닐라 인스턴스가 있는지 확인합니다. 바닐라 설치를 처음 사용하는 경우 대화형 명령줄 질문이 Adobe Commerce 저장소(https://repo.magento.com/)에서 바닐라 프로젝트를 다운로드하라는 메시지를 표시합니다.

--vanilla-dir 옵션을 사용하여 Upgrade Compatibility Tool 명령을 실행하여 Adobe Commerce vanilla 설치 디렉터리를 지정할 수 있습니다.

자세한 내용은 바닐라 인스턴스 배포 항목을 참조하십시오.

refactor 명령 사용

Upgrade Compatibility Tool은(는) 축소된 문제 집합을 자동으로 수정하는 기능이 있습니다.

이를 위해 refactor 명령을 실행합니다.

bin/uct refactor <dir>

여기서 <dir> 값은 Adobe Commerce 인스턴스가 있는 디렉터리입니다.

refactor 명령에 사용 가능한 옵션:

graphql:compare 명령 사용

이 명령은 두 GraphQL 끝점을 검사하고 두 끝점 간의 변경 내용 또는 위험한 변경 내용을 찾는 스키마를 비교하기 위한 옵션을 Upgrade Compatibility Tool에 제공합니다.

bin/uct graphql:compare <schema1> <schema2>

여기서 인수는 다음과 같습니다.

graphql:compare 명령에 사용 가능한 옵션:

list 명령 사용

사용 가능한 Upgrade Compatibility Tool 명령 목록을 반환하려면 다음을 실행하십시오.

bin/uct list

help 명령 사용

Upgrade Compatibility Tool 명령의 일반 옵션 및 도움말을 보려면 다음을 실행하십시오.

bin/uct --help

명령줄 인터페이스에서 Upgrade Compatibility Tool에 대해 사용 가능한 모든 help 옵션이 있는 목록을 반환합니다.

- --raw             To output raw command list
- --format=FORMAT   The output format (txt, xml, json, or md) [default: "txt"]
- --short           To skip describing commands' arguments
- -h, --help            Display help for the given command. When no command is given display help for the list command
- -q, --quiet           Do not output any message
- -V, --version         Display this application version
- --ansi|--no-ansi  Force (or disable --no-ansi) ANSI output
- -n, --no-interaction  Do not ask any interactive question
- -v|vv|vvv, --verbose  Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

특정 명령을 실행할 때 옵션으로 --help을(를) 실행할 수 있습니다. 지정한 명령에 대해 --help 옵션을 반환합니다.

--help 옵션이 있는 upgrade:check 명령의 예:

bin/uct upgrade:check --help

upgrade:check 명령에 대해 실행할 수 있는 특정 옵션을 반환합니다.

- -a, --current-version[=CURRENT-VERSION]: Current Adobe Commerce version, version of the Adobe Commerce installation will be used if omitted.
- -c, --coming-version[=COMING-VERSION]: Target Adobe Commerce version, latest released version of Adobe Commerce will be used if omitted. Provides a list of all available Adobe Commerce versions.
- --json-output-path[=JSON-OUTPUT-PATH]: Path of the file where the output will be exported in json format.
- --html-output-path[=HTML-OUTPUT-PATH]: Path of the file where the output will be exported in HTML format.
- --min-issue-level[=MIN-ISSUE-LEVEL]            Minimal issue level you want to see in the report (warning, error or critical). [default: "warning"]
- -i, --ignore-current-version-compatibility-issues  Ignore common issues for current and coming version
- --context=CONTEXT: Execution context. This option is for integration purposes and does not affect the execution result.
- -h, --help: Display help for that specific command. If no command is provided, `list` command is the default result.
- -q, --quiet: Do not output any messages while executing the command.
- -v, --version: Display application version.
- --ansi, --no-ansi: Enable ANSI output.
- -n, --no-interaction: Do not ask any interactive question while executing the command.
- -v, --vv, --vvv, --verbose: Increase verbosity of output communications. 1 for normal output, 2 for verbose output, and 3 for DEBUG output.

Adobe Commerce 모범 사례 따르기

결과 최적화

Upgrade Compatibility Tool은(는) 기본적으로 프로젝트에서 식별된 모든 문제가 포함된 결과를 포함하는 보고서를 제공합니다. 업그레이드를 완료하기 위해 수정해야 하는 문제에 집중하도록 결과를 최적화할 수 있습니다.