doc(release-24.08): change log preparation #34

stephanbcbauer · 2024-07-18T15:48:19Z

Description

PR to collaboratively work on the Changelog for R24.08

[24.08] - 2024-08-05

Added

Component	Helm Chart (s)	App-/KIT Version (s)
Knowledge Agents AAS Bridge	aas-bridge: 1.13.7	1.13.7
Supply Chain Disruption Notifications Kit	n/a	1.0.0
SSI Authority & Schema Registry	ssi-asr: 1.0.0	1.0.0

Updated

Component	Helm Chart (s)	App-/KIT Version (s)
BPDM Kit	n/a	6.0.0
BPN DID Resolution Service (BDRS)	bdrs: 0.5.2	0.5.2
Circularity Kit	n/a	1.2.0
DCM Kit	n/a	1.1.0
Digital Product Pass (DPP)	digital-product-pass: 4.0.1	v4.0.1
Digital Twin Kit	n/a	2.0.1
Digital Twin Registry	digital-twin-registry: 0.5.2	v0.5.0
Discovery Finder	discoveryfinder: 0.3.1	v0.4.0
Discovery Service (BPN Finder)	bpndiscovery: 0.3.1	v0.4.0
Eclipse Data Space Connector (Tractus-X EDC)	tractusx-connector: 0.7.3	0.7.3
EcoPass Kit	n/a	1.5.0
ESS Kit	n/a	0.3.0
Golden Record Business Partner Number (BPN) Service	bpdm: 5.1.0	v6.1.0
Identity and Access Management (IAM)	centralidp: 3.0.1 sharedidp: 3.0.1	keycloak: 23.0.7
Industry Core KIT	n/a	1.1.0
Item Relationship Service (IRS)	item-relationship-service: 7.4.0	5.4.0
Knowledge Agents	remoting-agent: 1.13.22 provisioning-agent: 1.13.22 conforming-agent: 1.13.22 matchmaking-agent: 1.13.22	v1.13.22 matchmaking-agent: v1.13.22
Knowledge Agents EDC	agent-plane: 1.13.22 agent-plane-azure-vault: 1.13.22	v1.13.22
Managed Service Orchestrator	managed-service-orchestrator: 1.6.0	v1.5.7
Managed Simple Data Exchanger (SDE)	sde: 0.1.12	frontend: v2.4.3 backend: v2.4.3
PCF Exchange Kit	n/a	1.2.0
Policy Hub	policy-hub: 1.1.0	v1.1.0
Portal	portal: 2.1.0	registration: v2.0.1 frontend: v2.1.0 backend: v2.1.0 assets: v2.1.0
PURIS	puris: 2.7.0	2.1.0
PURIS Kit	n/a	0.3.0
Self Description (SD) Factory	sdfactory: 2.1.21	v2.1.13
Semantic Hub	semantic-hub: 0.3.1	v0.4.0
SSI Credential Issuer	ssi-credential-issuer: 1.1.0	v1.1.0
Trace-X Traceability Application	traceability-foss: 1.3.43	13.0.1
Traceability Kit	n/a	5.1.0
OSIM Kit	n/a	3.0.0

Unchanged, untested

Component	Helm Chart (s)	App-/KIT Version (s)
Country Risk	country-risk: 4.0.2	1.3.1

Incompatible

Component	Helm Chart (s)	App-/KIT Version (s)
Managed Identity Wallet (MIW)	managed-identity-wallet: 0.5.0	v0.5.0

Known Knowns

:::note
For known knowns of unchanged/untested components, please refer to previous changelog(s)
:::

Relevant components and interfaces developed considering Gaia-X Trust Framework - 22.10
Connection to an external Clearing House service for the entire Catena-X ecosystem is required. The Gaia-X compliance service should generally be capable of recognizing all companies that are able to register with the Catena-X Portal.
This Tractus-X release does not include a Managed Identity Wallet (MIW). The development team decided on a temporary bridging solution, based on a commercial application, to test and ship Release 24.08. Without implementing this interim solution, participants will not be able to fully utilize this Tractus-X release in consequence.
For E2E Testing, the 1.2.0 of the SSI DIM Middle Layer was used - this component is FOSS but the currently used wallet (see previous item) is not.
Documentation content (e.g. architecture, manuals etc) and folder structure have not explicitly been checked for this Release, as relevant TRGs are not yet in force. The vast majority of components are evolutions of previous Releases, with a thorough review undergone. This leads to a high confidence in the quality of existing documentation within the product repositories.
FOSS components developed and pre-tested to TRL6 with artificial test data only
No crosscheck of functionality in verification environment
No execution of Load-, Performance- or Penetration Tests
No assignment of Export Control Classification Numbers (ECCN) to FOSS components
GeoBlocking recommended for Operations (GBaaS)
Security concept (overall) recommended for Operations
Listed components in "Unchanged, untested" category were not verified in combination with the current release package and are only compatible with Catena-X standards as specified. Use at your own risk at this time.
Listed components in "Incompatible" category are not compatible with the current release package and the latest standards.
BPDM has some Known Knowns regarding Portal integration listed in detail here
BPDM standard configuration not compatible with Portal's Central-IDP configuration
Portal's Partner Network page does not currently show business partner member data due to an authorization issue
Currently not possible to add company's site and address business partners over the Portal due to authorization issue
Security concern about exposed technical users when subscribing BPDM services over the Portal
DTR introduces the DTR-EDC Access Control extension. The goal of this EDC extension is to enforce authorized access to submodel implementations according to AAS and Catena-X concluded contracts. It is a Maven artifact that can be used for building their own EDC dataplane image with the extension. For more details, see here.

Runtime

The release has been tested

on Kubernetes versions: 1.28.9
with PostgreSQL versions: 15

Note: Tractus-X EDC has been tested on both Postgresql versions: 15.x and 16.x

Using helm with central helm registry

You can search all released helm charts with the following commands:

helm repo add tractusx-dev https://eclipse-tractusx.github.io/charts/dev
helm repo update tractusx-dev
helm search repo tractusx-dev --versions

For installation details, please see the referenced Repositories / Releases.

Pre-review checks

Please ensure to do as many of the following checks as possible, before asking for committer review:

DEPENDENCIES are up-to-date. Dash license tool. Committers can open IP issues for restricted libs.
Copyright and license header are present on all affected files

…s product

tom-rm-meyer-ISST

Update from PURIS team

CHANGELOG.md

evegufy

Please change to final versions in the release issues?

eclipse-tractusx/sig-release#764
eclipse-tractusx/sig-release#765
eclipse-tractusx/sig-release#767
eclipse-tractusx/sig-release#768

They will be available by the time of release

Co-authored-by: Tom Meyer <[email protected]>

drcgjung

Completed Knowledge Agent Component List & Foresee Final Versions (pending on a branching event to occur in the next days).

CHANGELOG.md

stephanbcbauer · 2024-08-02T06:01:47Z

@eclipse-tractusx/automotive-tractusx-committers @ds-mwesener please have a look again and check the PR, what about the known knowns?

FYI @jSchuetz88 @ther3sa

i checked again the versions and Links with the tool provided by @tom-rm-meyer-ISST (Thx it helps a lot) -> There are still some issues

Checking LINKS for KIT: Supply Chain Disruption Notifications Kit

ERROR: KIT Supply Chain Disruption Notifications Kit has invalid link 'https://eclipse-tractusx.github.io/docs-kits/category/supply-chain-disruption-notifications-kit'
ERROR: Changelog of KIT Supply Chain Disruption Notifications Kit has invalid link 'https://eclipse-tractusx.github.io/docs-kits/kits/Supply%20Chain%20Disruption%20Notifications%20KIT/Supply%20Chain%20Disruption%20Notifications%20Changelog'

=> Thats OK since the KIT was not merged yet

Checking CHART for FOSS Component: Eclipse Data Space Connector (Tractus-X EDC)

ERROR: Could not retrieve latest Helm chart or app version for [0.7.3](https.
ERROR: Chart version of FOSS Chart [0.7.3](https has version 0.7.3 while version None is available in tractusx-dev
ERROR: App version of FOSS Chart [0.7.3](https (app Eclipse Data Space Connector (Tractus-X EDC)) has app version 0.7.3 while version None is set in Chart available in tractusx-dev

=> I heard there is something special with EDC?

Checking CHART for FOSS Component: BPN DID Resolution Service (BDRS)

ERROR: Could not retrieve latest Helm chart or app version for [0.5.2](https.
ERROR: Chart version of FOSS Chart [0.5.2](https has version 0.5.2 while version None is available in tractusx-dev
ERROR: App version of FOSS Chart [0.5.2](https (app BPN DID Resolution Service (BDRS)) has app version 0.5.2 while version None is set in Chart available in tractusx-dev

=> @lgblaumeiser can you please check again? is it the same as for EDC?

Checking CHART for FOSS Component: Portal

ERROR: App version of FOSS Chart portal (app Portal) has app version v2.0.1 while version 2.1.0 is set in Chart available in tractusx-dev

=> @evegufy is this correct?

Checking CHART for FOSS Component: Trace-X Traceability Application

ERROR: Could not retrieve latest Helm chart or app version for helm-charts.
ERROR: Chart version of FOSS Chart helm-charts has version 1.3.43 while version None is available in tractusx-dev
ERROR: App version of FOSS Chart helm-charts (app Trace-X Traceability Application) has app version 13.0.1 while version None is set in Chart available in tractusx-dev

=> @mkanal not sure about this

ThX for your support

lgblaumeiser · 2024-08-02T06:10:43Z

Hello @stephanbcbauer , I do not understand the reason for the errors and the question for that. I checked with TRG 5.01 and the charts have exactly the fields set as defined there. Could the problem be, that both EDC and BDRS provide two helm charts for different distributions of the service? Either way, the versions specified in your overall release item are correct.

stephanbcbauer · 2024-08-02T06:27:50Z

Hello @stephanbcbauer , I do not understand the reason for the errors and the question for that. I checked with TRG 5.01 and the charts have exactly the fields set as defined there. Could the problem be, that both EDC and BDRS provide two helm charts for different distributions of the service? Either way, the versions specified in your overall release item are correct.

@tom-rm-meyer-ISST haven't looked into the tool, but can this be the reason? i checked the links a.s.o manually and everything seems to be fine

ds-mwesener · 2024-08-02T06:43:01Z

Checking CHART for FOSS Component: Trace-X Traceability Application

ERROR: Could not retrieve latest Helm chart or app version for helm-charts.

ERROR: Chart version of FOSS Chart helm-charts has version 1.3.43 while version None is available in tractusx-dev

ERROR: App version of FOSS Chart helm-charts (app Trace-X Traceability Application) has app version 13.0.1 while version None is set in Chart available in tractusx-dev

=> @mkanal not sure about this

ThX for your support

Hi @stephanbcbauer we have rechecked the chart / app versions and everything seems to be fine:

Looking the versions up here: https://eclipse-tractusx.github.io/charts/dev/index.yaml
We will find the helm chart 1.3.43 as well as the app version 13.0.1

Could you please explain what you mean with None is set / found?

Regarding the Known-Knowns we have listed them in our release log. All of them have very small impact on the functionalities and will be accepted from our perspective. Do you need anything else?

stephanbcbauer · 2024-08-02T08:50:46Z

Checking CHART for FOSS Component: Trace-X Traceability Application

ERROR: Could not retrieve latest Helm chart or app version for helm-charts.

ERROR: Chart version of FOSS Chart helm-charts has version 1.3.43 while version None is available in tractusx-dev

ERROR: App version of FOSS Chart helm-charts (app Trace-X Traceability Application) has app version 13.0.1 while version None is set in Chart available in tractusx-dev

=> @mkanal not sure about this
ThX for your support

Hi @stephanbcbauer we have rechecked the chart / app versions and everything seems to be fine:

Looking the versions up here: https://eclipse-tractusx.github.io/charts/dev/index.yaml We will find the helm chart 1.3.43 as well as the app version 13.0.1

Could you please explain what you mean with None is set / found?

Regarding the Known-Knowns we have listed them in our release log. All of them have very small impact on the functionalities and will be accepted from our perspective. Do you need anything else?

@ds-mwesener thx, checked it also again. It should be fine. Marked the errors as done

evegufy · 2024-08-02T10:56:19Z

@eclipse-tractusx/automotive-tractusx-committers @ds-mwesener please have a look again and check the PR, what about the known knowns?

FYI @jSchuetz88 @ther3sa

i checked again the versions and Links with the tool provided by @tom-rm-meyer-ISST (Thx it helps a lot) -> There are still some issues

Checking LINKS for KIT: Supply Chain Disruption Notifications Kit

ERROR: KIT Supply Chain Disruption Notifications Kit has invalid link 'https://eclipse-tractusx.github.io/docs-kits/category/supply-chain-disruption-notifications-kit'

ERROR: Changelog of KIT Supply Chain Disruption Notifications Kit has invalid link 'https://eclipse-tractusx.github.io/docs-kits/kits/Supply%20Chain%20Disruption%20Notifications%20KIT/Supply%20Chain%20Disruption%20Notifications%20Changelog'

=> Thats OK since the KIT was not merged yet

Checking CHART for FOSS Component: Eclipse Data Space Connector (Tractus-X EDC)

ERROR: Could not retrieve latest Helm chart or app version for [0.7.3](https.

ERROR: Chart version of FOSS Chart [0.7.3](https has version 0.7.3 while version None is available in tractusx-dev

ERROR: App version of FOSS Chart [0.7.3](https (app Eclipse Data Space Connector (Tractus-X EDC)) has app version 0.7.3 while version None is set in Chart available in tractusx-dev

=> I heard there is something special with EDC?

Checking CHART for FOSS Component: BPN DID Resolution Service (BDRS)

ERROR: Could not retrieve latest Helm chart or app version for [0.5.2](https.

ERROR: Chart version of FOSS Chart [0.5.2](https has version 0.5.2 while version None is available in tractusx-dev

ERROR: App version of FOSS Chart [0.5.2](https (app BPN DID Resolution Service (BDRS)) has app version 0.5.2 while version None is set in Chart available in tractusx-dev

=> @lgblaumeiser can you please check again? is it the same as for EDC?

Checking CHART for FOSS Component: Portal

ERROR: App version of FOSS Chart portal (app Portal) has app version v2.0.1 while version 2.1.0 is set in Chart available in tractusx-dev

=> @evegufy is this correct?

Checking CHART for FOSS Component: Trace-X Traceability Application

ERROR: Could not retrieve latest Helm chart or app version for helm-charts.

ERROR: Chart version of FOSS Chart helm-charts has version 1.3.43 while version None is available in tractusx-dev

ERROR: App version of FOSS Chart helm-charts (app Trace-X Traceability Application) has app version 13.0.1 while version None is set in Chart available in tractusx-dev

=> @mkanal not sure about this

ThX for your support

@stephanbcbauer I'm not sure to what you're referring to, the overarching appVersion is 2.1.0 as well, there's just the registration app where we had a patch version (2.0.1) for the rest 2.1.0, so all fine.

matbmoser · 2024-08-02T11:42:23Z

Lets check of the known knowns 👍🏻 But in case I am not here to approve it, it looks already for me.

tom-rm-meyer-ISST

Common effort of committers

CHANGELOG.md

Co-authored-by: Tom Meyer <[email protected]>

stephanbcbauer · 2024-08-05T07:56:47Z

@eclipse-tractusx/automotive-tractusx-committers thx for your help, I think we are good to go and merge the PR ⇾ Exactly the content will also be merged with this PR eclipse-tractusx/eclipse-tractusx.github.io#1011

tom-rm-meyer-ISST

Cross checked PURIS related stuff and outputs of sanity tool. Two (potential) findings

CHANGELOG.md

Co-authored-by: Tom Meyer <[email protected]>

initial commit for release 24.08

89008fa

stephanbcbauer added the documentation Improvements or additions to documentation label Jul 18, 2024

stephanbcbauer requested review from arnoweiss and tom-rm-meyer-ISST July 18, 2024 15:54

stephanbcbauer marked this pull request as draft July 18, 2024 15:54

stephanbcbauer requested review from evegufy and RolaH1t July 18, 2024 15:54

add initial table for added, updated, unchanged

e529111

stephanbcbauer mentioned this pull request Jul 23, 2024

[Product] Release Checks - Summary check - R24.08 eclipse-tractusx/sig-release#821

Closed

4 tasks

stephanbcbauer and others added 8 commits July 23, 2024 10:51

adapt EDC version to 0.7.3 and delete 2E_Data_Exchange_Test_Service a…

6059181

…s product

udpate Kubernetes version for release 24.08

a139572

adapt helm and app version -> latest release

31be499

adapt versioning for helm and app version -> latest release

889837b

adapt versions

28df316

delete dcm app

ff65cad

add KITs and versions to tables

e48fddc

update dpp version

360eed8

tom-rm-meyer-ISST requested changes Jul 26, 2024

View reviewed changes

CHANGELOG.md Outdated Show resolved Hide resolved

CHANGELOG.md Outdated Show resolved Hide resolved

CHANGELOG.md Outdated Show resolved Hide resolved

tom-rm-meyer-ISST mentioned this pull request Jul 26, 2024

[R24.08] [PURIS] Release Checks eclipse-tractusx/sig-release#795

Closed

3 tasks

evegufy requested changes Jul 26, 2024

View reviewed changes

stephanbcbauer and others added 3 commits July 29, 2024 14:05

adapt PURIS version

2d5daaa

Co-authored-by: Tom Meyer <[email protected]>

update IAM, Portal, Policy Hub versions

3e7693b

combine different services and map to products

2e38ba9

stephanbcbauer requested review from ther3sa, a team, evegufy and tom-rm-meyer-ISST and removed request for arnoweiss July 30, 2024 05:50

stephanbcbauer marked this pull request as ready for review July 30, 2024 05:52

drcgjung suggested changes Jul 30, 2024

View reviewed changes

CHANGELOG.md Outdated Show resolved Hide resolved

CHANGELOG.md Show resolved Hide resolved

stephanbcbauer requested review from drcgjung, tom-rm-meyer-ISST, evegufy and jSchuetz88 August 2, 2024 05:40

adapt aas bridge version link

bdeb771

nicoprow approved these changes Aug 2, 2024

View reviewed changes

stephanbcbauer added 2 commits August 2, 2024 10:57

add note for known knowns

73ee8f7

update release date

55ee146

stephanbcbauer mentioned this pull request Aug 2, 2024

doc(changelog): add new changelog for release 24.08 eclipse-tractusx/eclipse-tractusx.github.io#1011

Merged

4 tasks

add closing tag vor <br>

3d9076b

matbmoser approved these changes Aug 2, 2024

View reviewed changes

tom-rm-meyer-ISST requested changes Aug 2, 2024

View reviewed changes

stephanbcbauer and others added 4 commits August 2, 2024 14:31

Apply suggestions from code review

3336d6e

Co-authored-by: Tom Meyer <[email protected]>

Update CHANGELOG.md

2502831

Co-authored-by: Tom Meyer <[email protected]>

Remove duplicated entries from 2024.08

5d5a8a2

Remove duplicated entries

ec7bab7

stephanbcbauer requested a review from tom-rm-meyer-ISST August 5, 2024 07:52

Add EDC Extension feature

de14c52

tom-rm-meyer-ISST requested changes Aug 5, 2024

View reviewed changes

CHANGELOG.md Outdated Show resolved Hide resolved

CHANGELOG.md Show resolved Hide resolved

update traceability-foss helm chart name

7e3939b

Co-authored-by: Tom Meyer <[email protected]>

evegufy approved these changes Aug 6, 2024

View reviewed changes

stephanbcbauer merged commit a8f51b8 into main Aug 6, 2024
2 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

doc(release-24.08): change log preparation #34

doc(release-24.08): change log preparation #34

stephanbcbauer commented Jul 18, 2024 •

edited

Loading

tom-rm-meyer-ISST left a comment

evegufy left a comment

drcgjung left a comment

stephanbcbauer commented Aug 2, 2024 •

edited

Loading

lgblaumeiser commented Aug 2, 2024

stephanbcbauer commented Aug 2, 2024

ds-mwesener commented Aug 2, 2024 •

edited by stephanbcbauer

Loading

stephanbcbauer commented Aug 2, 2024 •

edited

Loading

evegufy commented Aug 2, 2024 •

edited by stephanbcbauer

Loading

matbmoser commented Aug 2, 2024

tom-rm-meyer-ISST left a comment

stephanbcbauer commented Aug 5, 2024

tom-rm-meyer-ISST left a comment

doc(release-24.08): change log preparation #34

doc(release-24.08): change log preparation #34

Conversation

stephanbcbauer commented Jul 18, 2024 • edited Loading

Description

[24.08] - 2024-08-05

Added

Updated

Unchanged, untested

Incompatible

Known Knowns

Runtime

Using helm with central helm registry

Pre-review checks

tom-rm-meyer-ISST left a comment

Choose a reason for hiding this comment

evegufy left a comment

Choose a reason for hiding this comment

drcgjung left a comment

Choose a reason for hiding this comment

stephanbcbauer commented Aug 2, 2024 • edited Loading

lgblaumeiser commented Aug 2, 2024

stephanbcbauer commented Aug 2, 2024

ds-mwesener commented Aug 2, 2024 • edited by stephanbcbauer Loading

stephanbcbauer commented Aug 2, 2024 • edited Loading

evegufy commented Aug 2, 2024 • edited by stephanbcbauer Loading

matbmoser commented Aug 2, 2024

tom-rm-meyer-ISST left a comment

Choose a reason for hiding this comment

stephanbcbauer commented Aug 5, 2024

tom-rm-meyer-ISST left a comment

Choose a reason for hiding this comment

stephanbcbauer commented Jul 18, 2024 •

edited

Loading

stephanbcbauer commented Aug 2, 2024 •

edited

Loading

ds-mwesener commented Aug 2, 2024 •

edited by stephanbcbauer

Loading

stephanbcbauer commented Aug 2, 2024 •

edited

Loading

evegufy commented Aug 2, 2024 •

edited by stephanbcbauer

Loading