[
https://issues.apache.org/jira/browse/UNOMI-1009?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Serge Huber reassigned UNOMI-1009:
----------------------------------
Affects Version/s: unomi-4.0.0
Assignee: Serge Huber
> The 3.0 to 4.0 migration guide misses several breaking changes
> --------------------------------------------------------------
>
> Key: UNOMI-1009
> URL: https://issues.apache.org/jira/browse/UNOMI-1009
> Project: Apache Unomi
> Issue Type: Task
> Affects Versions: unomi-4.0.0
> Reporter: Serge Huber
> Assignee: Serge Huber
> Priority: Major
> Fix For: unomi-4.0.0
>
> Time Spent: 20m
> Remaining Estimate: 0h
>
> h3. Summary
> The migration guide covers the main changes, such as API keys, cookies,
> passwords and REST roles. Several other changes can break existing
> installations or plugins and are not mentioned:
> * Java API: changes to the scheduler, event, definitions and profile
> services, and to condition parameter default values.
> * Plugins: some condition classes moved to a new plugin and package, and some
> artifacts and query builders were removed.
> * Shell: 18 commands, such as profile-list, rule-list and segment-view, were
> replaced by unomi:crud.
> * Stored data: document ids now start with the tenant id. This affects any
> script or dashboard that reads ids directly.
> * REST: creating a profile with no itemId is now refused, and validation
> errors no longer include the detailed message.
> * Configuration: GraphQL is enabled differently, and a health check option
> was renamed.
> * Third-party servers: X-Unomi-Peer and the thirdparty configuration only
> apply in compatibility mode. In normal mode, protected events are controlled
> by tenant settings.
> * The key file written by the migration names headers that do not exist. The
> public key goes in X-Unomi-Api-Key, and the private key is used with Basic
> authentication.
> The goal of this ticket is that someone upgrading from 3.0 finds every
> breaking change in the guide.
> h3. Ways to explore
> * Add a "Breaking changes" section, grouped by audience: operators,
> integrators, plugin developers.
> * Fix the text of the key file written by the migration.
> * Use placeholders for keys and passwords in examples.
> h3. How to test
> Manual check: review the guide against the list above.
> Automated tests and checks to add:
> * A migration test that reads the key file written by the migration and
> checks that it names X-Unomi-Api-Key for the public key and Basic
> authentication for the private key.
> * A test that runs the REST examples of the migration guide, at least the
> admin request with the tenant header, so the guide cannot drift from the code
> again.
> * An API compatibility check in the build that compares the public Java API
> with the previous release, so future breaking changes are seen before a
> release and can be documented.
--
This message was sent by Atlassian Jira
(v10.3.26#10030026)
