데이터 마이그레이션 설정

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

Settings 모드는 상점, 웹 사이트 및 배송, 결제 및 세금 설정과 같은 시스템 구성을 마이그레이션합니다. 데이터 마이그레이션 순서에 따라 먼저 설정을 마이그레이션해야 합니다.

시작하기 전에 다음 단계를 수행하여 준비하십시오.

NOTE

Magento 2가 default 모드에서 배포되었는지 확인하십시오. 개발자 모드에서는 마이그레이션 도구에서 유효성 검사 오류가 발생할 수 있습니다.

자세한 내용은 첫 번째 단계 섹션을 참조하십시오.

settings migration 명령 실행

설정 마이그레이션을 시작하려면 다음을 실행합니다.

bin/magento migrate:settings [-r|--reset] [-a|--auto] {<path to config.xml>}

위치:

[-r|--reset]은(는) 처음부터 마이그레이션을 시작하는 선택적 인수입니다. 이 인수를 사용하여 마이그레이션을 테스트할 수 있습니다
[-a|--auto]은(는) 무결성 검사 오류가 발생할 때 마이그레이션이 중지되지 않도록 하는 선택적 인수입니다.
{<path to config.xml>}은(는) 마이그레이션 도구의 config.xml 파일에 대한 절대 파일 시스템 경로입니다. 이 인수는 필수입니다.

NOTE

이 명령은 모든 구성 설정을 마이그레이션하지 않습니다. 계속하기 전에 Magento 2 관리자의 모든 설정을 확인하십시오.

설정이 성공적으로 전송되면 Migration completed 메시지가 표시됩니다.

설정을 마이그레이션할 때 시스템 구성을 무시하거나 이름을 바꾸거나 변경할 수 있습니다. 이를 위해 settings.xml 파일에 사용자 지정 규칙을 지정하십시오.

다음 디렉토리로 변경합니다.

code language-bash
`cd <your application 2 install dir>/vendor/magento/data-migration-tool/etc/<edition-to-edition>`

예를들어 응용 프로그램이 /var/www/html에 설치된 경우 settings.xml.dist 파일은 다음 디렉터리 중 하나에 있습니다.

제공된 샘플에서 settings.xml 파일을 만들려면 다음을 실행하십시오.

code language-bash
`cp settings.xml.dist settings.xml`

settings.xml에서 변경합니다.
매핑할 설정 파일의 새 이름을 지정하려면 <settings_map_file> 파일에서 path/to/config.xml 태그를 변경하십시오.

자세한 내용은 도구 사양의 설정 마이그레이션 모드 섹션을 참조하십시오.

recommendation-more-help

c2d96e17-5179-455c-ad3a-e1697bb4e8c3