feat: Enable UpgradePlugins to restrict to a specific graph and update the knora base version to 26

[seakayone]

Pull Request Checklist

Task Description/Number

This PR allows an UpgradePlugin to confine its changes to a specific set of graphs. This speed up the upgrade process substantially. If UpgradePlugins only need to update the builtIn ontology graphs there is no need to drop all other ontology or data graphs.

Moves knora-ontologies to webapi/src/main/resources/knora-ontologies in order to make the ontologies part of the classpath. This is necessary for local development in order to run the UpgradePlugins locally. Hence, we can remove adding them to the container manually. Retains a symbolic link on the root level of this repo so that other scripts and test code still can find them. Cleaning this up is left for a followup issue in order to keep the size of this PR manageable.

Replaces NoopPlugin with a more adequately named MigrateOnlyBuiltInGraphs. This plugin is updating the builtIn graphs (i.e. the ones found in knora-ontologies) once applied.

Upgrades the knora base version to 26 and applies above migration plugin in order to update the builtIn graphs to the latest version.

PR Type

• build/chore: maintenance tasks (no production code change)
• docs: documentation changes (no production code change)
• feat: represents new features
• fix: represents bug fixes
• perf: performance improvements
• refactor: represents production code refactoring
• test: adding or refactoring tests (no production code change)

Basic requirements for bug fixes and features

• Tests for the changes have been added
• Docs have been added / updated

Does this PR introduce a breaking change?

• Yes

Does this PR change client-test-data?

• Yes

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (eac5751) 11.74% compared to head (bb957d2) 88.50%.
Report is 35 commits behind head on main.

Additional details and impacted files

@@             Coverage Diff             @@
##             main    #3005       +/-   ##
===========================================
+ Coverage   11.74%   88.50%   +76.76%     
===========================================
  Files         246      263       +17     
  Lines       22907    23099      +192     
===========================================
+ Hits         2690    20444    +17754     
+ Misses      20217     2655    -17562     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[mpro7]

Thanks for this update, it looks promising! Although I approve it please wait in this case for all reviewers feedback.

[seakayone]

Thanks for this update, it looks promising! Although I approve it please wait in this case for all reviewers feedback.

I appreciate your review, have you been able to test this out locally?

[mpro7]

Thanks for this update, it looks promising! Although I approve it please wait in this case for all reviewers feedback.

I appreciate your review, have you been able to test this out locally?

Yes, repository upgrade test passed locally.

[BalduinLandolt]

Moves knora-ontologies to webapi/src/main/resources/knora-ontologies ...

@jnussbaum FYI - my guess is that symlinks will not work over github, so it's probably best to change it in TOOLS right away when this is merged. (And RDU will then have to update their DSP-TOOLS version, I suppose.)

[BalduinLandolt]

As discussed, I like the changes and I'm looking forward to continue improving the plugin situation, but this takes away the immediate pressure, which is great!

[jnussbaum]

Moves knora-ontologies to webapi/src/main/resources/knora-ontologies ...

@jnussbaum FYI - my guess is that symlinks will not work over github, so it's probably best to change it in TOOLS right away when this is merged. (And RDU will then have to update their DSP-TOOLS version, I suppose.)

@BalduinLandolt So if I get you right, we have to modify our URLs as follows:

webapi/scripts/fuseki-repository-config.ttl.template   stays as is
knora-ontologies/xyz.ttl                               webapi/src/main/resources/knora-ontologies/xyz.ttl
test_data/project_data/xyz.ttl                         stays as is
test_data/project_ontologies/xyz.ttl                   stays as is

[BalduinLandolt]

Moves knora-ontologies to webapi/src/main/resources/knora-ontologies ...

@jnussbaum FYI - my guess is that symlinks will not work over github, so it's probably best to change it in TOOLS right away when this is merged. (And RDU will then have to update their DSP-TOOLS version, I suppose.)

@BalduinLandolt So if I get you right, we have to modify our URLs as follows:

webapi/scripts/fuseki-repository-config.ttl.template   stays as is
knora-ontologies/xyz.ttl                               webapi/src/main/resources/knora-ontologies/xyz.ttl
test_data/project_data/xyz.ttl                         stays as is
test_data/project_ontologies/xyz.ttl                   stays as is

Looks right, but I would suggest quickly testing it to verify, once this is merged, just to be sure.