Data Migration Tool 구성
Data Migration Tool을(를) 설치한 후 다음 디렉터리에 매핑 및 구성 파일이 있습니다.
-
Magento Open Source:
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-opensource: Magento Open Source 1에서 Magento Open Source 2로 마이그레이션하기 위한 구성 및 스크립트
-
Adobe Commerce:
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-commerce: Magento Open Source 1에서 Adobe Commerce 2로 마이그레이션하기 위한 구성 및 스크립트<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/commerce-to-commerce: Adobe Commerce 1에서 Adobe Commerce 2로 마이그레이션하기 위한 구성 및 스크립트
위의 디렉토리에는 지원되는 각 버전에 대한 하위 디렉토리가 있습니다.
마이그레이션 구성
Data Migration Tool을(를) 구성하는 방법에는 두 가지가 있습니다.
- 별도의 모듈에서 Data Migration Tool 구성(권장)
- Data Migration Tool 디렉터리에서
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/구성을 변경합니다.
소스 제어를 사용하여 마이그레이션 구성을 관리하고 배포에 사용하려면 별도의 모듈을 만들어야 합니다.
로컬에서만 Data Migration Tool을(를) 실행할 계획이라면 <your Magento 2 install dir>/vendor/magento/data-migration-tool/ 디렉터리에서 직접 파일을 편집할 수 있습니다.
별도의 모듈에서 마이그레이션 구성
데이터를 마이그레이션하기 전에 Magento 2 모듈을 만들어야 합니다.
-
Magento 2 모듈을 만듭니다.
<your Magento 2 install dir>/app/code/Vendor/Migration/composer.json
code language-json { "name": "vendor/migration", "description": "Providing config for migration", "config": { "sort-packages": true }, "require": { "magento/framework": "*", "magento/data-migration-tool": "*" }, "type": "magento2-module", "autoload": { "files": [ "registration.php" ], "psr-4": { "Vendor\\Migration\\": "" } }, "version": "1.0.0" }<your Magento 2 install dir>/app/code/Vendor/Migration/registration.php
code language-php <?php \Magento\Framework\Component\ComponentRegistrar::register( \Magento\Framework\Component\ComponentRegistrar::MODULE, 'Vendor_Migration', __DIR__ );<your Magento 2 install dir>/app/code/Vendor/Migration/etc/module.xml
code language-xml <?xml version="1.0"?> <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd"> <module name="Vendor_Migration" setup_version="1.0.0"> <sequence> <module name="Magento_DataMigrationTool"/> </sequence> </module> </config> -
config.xml.dist구성 파일을 Data Migration Tool(<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>)의 적절한 디렉터리에서<your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/config.xml파일로 복사합니다.예를 들어
Magento 1.9.3.6 Community Edition을(를)Magento 2 Open Source(으)로 마이그레이션하는 경우:code language-bash cd <your Magento 2 install dir>code language-bash cp vendor/magento/data-migration-tool/etc/opensource-to-opensource/1.9.3.6/config.xml.dist app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.3.6/config.xml -
config.xml파일에서 액세스 세부 정보를 M1 및 M2 데이터베이스 및 암호화 키로 설정해야 합니다. -
M1 저장소에 사용자 지정 변경 사항이 있는 경우 나머지 구성 파일을 Magento 1 저장소 사용자 지정에 매핑해야 합니다. 구성 및 매핑 파일 작업을 참조하세요.
vendor 폴더에서 마이그레이션 구성
데이터를 마이그레이션하기 전에 제공된 샘플에서 config.xml 구성 파일을 만들어야 합니다.
마이그레이션할 Data Migration Tool을(를) 구성하려면:
-
응용 프로그램 서버에 파일 시스템 소유자(으)로 로그인하거나 응용 프로그램 서버로 전환합니다.
-
다음 디렉토리로 변경합니다.
code language-bash <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version> -
제공된 샘플에서
config.xml을(를) 만들려면 다음 명령을 입력하십시오.code language-bash cp config.xml.dist config.xml -
텍스트 편집기에서
config.xml열기 -
최소한 config.xml 파일에는 M1 및 M2 데이터베이스 및 암호화 키에 대한 액세스 세부 정보가 포함되어야 합니다.
code language-xml <source> <database host="127.0.0.1" name="magento1" user="root"/> </source> <destination> <database host="127.0.0.1" name="magento2" user="root"/> </destination> <options> <crypt_key /> </options><crypt_key> 태그에 값이 있어야 합니다. Magento 1 인스턴스의 app/etc/local.xml 파일에 있는
<key>태그에서 찾을 수 있습니다.선택적 매개 변수:
- 데이터베이스 사용자 암호:
password=<password> - 데이터베이스 사용자 지정 포트:
port=<port> - 테이블 접두사:
<source_prefix>,<dest_prefix>
예를 들어 데이터베이스 소유자의 사용자 이름이 암호가
root인pass이고 Magento 1 데이터베이스에서 접두사magento1을(를) 사용하는 경우config.xml에서 다음을 사용하십시오.code language-xml <source> <database host="127.0.0.1" name="magento1" user="root" password="pass"/> </source> <destination> <database host="127.0.0.1" name="magento2" user="root" password="pass"/> </destination> <options> <source_prefix>magento1</source_prefix> <crypt_key>f3e25abe619dae2387df9fs594f01985</crypt_key> </options> - 데이터베이스 사용자 암호:
완료되면 변경 내용을 config.xml에 저장하고 텍스트 편집기를 종료합니다.
TLS 프로토콜을 사용하여 연결
TLS 프로토콜(즉, 공개/개인 암호화 키 사용)을 사용하여 데이터베이스에 연결할 수도 있습니다. database 요소에 다음 선택적 특성을 추가합니다.
ssl_cassl_certssl_key
For example:
<source>
<database host="localhost" name="magento1" user="root" ssl_ca="/path/to/file" ssl_cert="/path/to/file" ssl_key="/path/to/file"/>
</source>
<destination>
<database host="localhost" name="magento2" user="root" ssl_ca="/path/to/file" ssl_cert="/path/to/file" ssl_key="/path/to/file"/>
</destination>
구성 및 매핑 파일 작업
Data Migration Tool은(는) 매핑 파일 을(를) 사용하여 다음을 포함하여 Magento 1과 Magento 2 데이터베이스 간에 사용자 지정 데이터베이스 매핑을 수행할 수 있습니다.
-
테이블 이름 변경
-
필드 이름 변경
-
테이블 또는 필드 무시
-
필드의 데이터를 Magento 2 형식으로 전송하도록 조정
지원되는 Magento 버전에 대한 매핑 파일이 <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc의 하위 디렉터리에 있습니다.
매핑 파일을 사용하려면 다음을 수행합니다.
-
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>/에서<your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/(으)로 복사하고.dist확장을 제거합니다. -
<options>의config.xml노드에서 새로 복사된 파일의 경로를 업데이트합니다. 업데이트된 경로는 다음 중 하나여야 합니다.- 절대 파일 경로(예:
/var/www/html/app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml) - magento/data-migration-tool 모듈 상대 파일 경로:
etc/opensource-to-opensource/1.9.4.1/map.xml - Magento 루트 상대 파일 경로:
app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml
- 절대 파일 경로(예:
<Magento 2 dir>/vendor/magento/data-migration-tool/etc 및 <Magento 2 dir>/vendor/magento/data-migration-tool/etc/<ce version> 디렉터리에 다음 구성 파일이 있습니다.
대부분의 경우 map.xml.dist 파일을 사용하여 작업하지만 다음 표에서는 각 매핑과 다른 파일에 대해 설명합니다.
class-map.xml.distconfig.xml.distcustomer-attr-document-groups.xml.distcustomer-attr-map.xml.distdeltalog.xml.disteav-attribute-groups.xml.disteav-document-groups.xml.distlog-document-groups.xml.distmap-eav.xml.distmap-log.xml.distmap-sales.xml.distmap.xml.distsettings.xml.distcore_config_data 테이블을 마이그레이션하는 데 필요한 규칙을 지정하는 마이그레이션 구성 파일을 설정하는 중입니다.customer-attribute-groups.xml.distcustomer-document-groups.xml.distmap-customer.xml.distorder-grids-document-groups.xml.distmap-document-groups.xml.distmap-stores.xml.distmap-tier-price.xml.distvisual_merchandiser_map.xml.distvisual_merchandiser_attribute_groups.xml.distvisual_merchandiser_document_groups.xml.dist자세한 내용은 Data Migration Tool 기술 사양을 참조하십시오.