Red Hat Summit이 콘텐츠는 선택한 언어로 제공되지 않습니다.
Chapter 6. Migrating Apicurio Registry data
Use the export and import APIs to migrate persisted content from Apicurio Registry 2.6 to a new Apicurio Registry 3.x deployment. The APIs preserve artifact identifiers, metadata, and references, ensuring downstream Kafka payloads remain compatible.
You must use the export/import procedure for migration. Apicurio Registry 3.x cannot directly read 2.6 storage because the underlying data structures have changed significantly:
- SQL storage: The v3 database schema is completely redesigned and incompatible with v2. The data model changes (separate artifact and version metadata, new branch support) require a different table structure.
- KafkaSQL storage: The v3 Kafka journal topic uses a new event journaling format that is incompatible with v2. The v2 topic cannot be reused.
Export data from v2 and import it into v3 using the export/import APIs. The import process automatically transforms the data to the v3 format.
Apicurio Registry 3.x accepts the export archive generated from a 2.6 instance. Capture the archive from your existing deployment, provision the 3.x environment, and import the archive into the new cluster.
Prerequisites
- Ensure both the source Apicurio Registry 2.6 server and the destination 3.x server are currently running.
-
Administrative credentials that allow access to the
/apis/registry/v2/admin/exportand/apis/registry/v3/admin/importendpoints. -
If using OAuth2 authentication, valid client credentials with admin role (for example,
sr-admin).
Procedure
The migration scripts automate the export, import, and validation process. They support OAuth2 authentication and provide detailed error handling.
Export all data from Apicurio Registry 2.6 using the export script:
./apicurio-export-registry-data.sh
./apicurio-export-registry-data.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow The script:
- Connects to your 2.6 deployment
- Exports all artifacts, versions, metadata, and rules
-
Saves the data to a ZIP file (default:
registry-export.zip) - Validates the export file format and size
Reports export duration and file details
For detailed configuration options and OAuth2 authentication setup, see Migration scripts reference.
Import the export archive into Apicurio Registry 3.x using the import script:
./apicurio-import-registry-data.sh
./apicurio-import-registry-data.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow The script:
- Validates the import ZIP file exists and is valid
- Checks Apicurio Registry 3.x accessibility and version
- Imports all data from the export file
- Verifies artifact counts before and after import
Reports global rules configuration
For detailed configuration options, see Migration scripts reference.
Validate the imported data using the verification script:
./apicurio-verify-registry-version.sh
./apicurio-verify-registry-version.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow The script performs comprehensive validation:
- Health endpoint verification
- System information and version check
- Artifact count comparison
- Global rules validation
v2 API backward compatibility check (optional)
For detailed configuration options, see Migration scripts reference.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}