⚠️ Updating more than one major version at a time can lead to issues. We strongly recommend updating sequentially from one major version to the next.
⚠️ Remember to double-check always all modifications made by the migrations to avoid potentially unwanted changes in rare use cases.
We highly recommend regularly updating your TALY packages to the latest version to benefit from the newest features, bug fixes, and improvements. See the step-by-step instructions below on how to update TALY.
TALY fully relies on Nx workspace and Nx migration mechanisms. Before proceeding, if you are still on an Angular workspace, please migrate it to Nx by following the instructions in the Nx migration guide.
Nx migrations for your workspace are shipped with the @allianz/taly-nx package. To automatically migrate your workspace to a more recent TALY version, run this command
npx nx migrate @allianz/taly-nx@<your_next_major_version>
# If the migrations.json file is automatically generated,
# please run the command below afterwards.
npx nx migrate --run-migrations⚠️ Do not run
nx migratewithyarn, as the.npmrcconfiguration isn't respected, which may result in a broken installation.
The available options can be found here. You can repeat this command until you reach the desired version.
⚠️ Migrations are only shipped with the version they should be applied to. Therefore, migrations need to be done step by step, with only one major version migrated at a time.
Some breaking changes cannot be automatically migrated. In such cases, you will see actions that need to be done manually in the TALY Changelog. Please follow the instructions to avoid potential issues.
If you are working outside a workspace, we offer the CLI migrate command in the @allianz/taly-sdk package to update your configuration file. For more information, please check the dedicated documentation for the TALY SDK.