Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Merged
merged 32 commits into from
Aug 6, 2024
Merged

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

merged 32 commits into from
Aug 6, 2024

Conversation

stephanbcbauer
Copy link
Member

@stephanbcbauer stephanbcbauer commented Jul 18, 2024

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

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:

@stephanbcbauer stephanbcbauer added the documentation Improvements or additions to documentation label Jul 18, 2024
@stephanbcbauer stephanbcbauer marked this pull request as draft July 18, 2024 15:54
Copy link
Contributor

@tom-rm-meyer-ISST tom-rm-meyer-ISST left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Update from PURIS team

CHANGELOG.md Outdated Show resolved Hide resolved
CHANGELOG.md Outdated Show resolved Hide resolved
CHANGELOG.md Outdated Show resolved Hide resolved
Copy link

@evegufy evegufy left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

@stephanbcbauer stephanbcbauer requested review from ther3sa, a team, evegufy and tom-rm-meyer-ISST and removed request for arnoweiss July 30, 2024 05:50
@stephanbcbauer stephanbcbauer marked this pull request as ready for review July 30, 2024 05:52
Copy link

@drcgjung drcgjung left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

CHANGELOG.md Outdated Show resolved Hide resolved
CHANGELOG.md Show resolved Hide resolved
@stephanbcbauer
Copy link
Member Author

stephanbcbauer commented Aug 2, 2024

@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

=> 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
Copy link

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
Copy link
Member Author

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
Copy link

ds-mwesener commented Aug 2, 2024

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
Copy link
Member Author

stephanbcbauer commented Aug 2, 2024

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
Copy link

evegufy commented Aug 2, 2024

@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

=> 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
Copy link
Contributor

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

Copy link
Contributor

@tom-rm-meyer-ISST tom-rm-meyer-ISST left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Common effort of committers

CHANGELOG.md Outdated Show resolved Hide resolved
CHANGELOG.md Outdated Show resolved Hide resolved
CHANGELOG.md Outdated Show resolved Hide resolved
CHANGELOG.md Outdated Show resolved Hide resolved
CHANGELOG.md Outdated Show resolved Hide resolved
CHANGELOG.md Outdated Show resolved Hide resolved
CHANGELOG.md Outdated Show resolved Hide resolved
CHANGELOG.md Show resolved Hide resolved
stephanbcbauer and others added 4 commits August 2, 2024 14:31
Co-authored-by: Tom Meyer <tom.meyer@isst.fraunhofer.de>
Co-authored-by: Tom Meyer <tom.meyer@isst.fraunhofer.de>
@stephanbcbauer
Copy link
Member Author

@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

Copy link
Contributor

@tom-rm-meyer-ISST tom-rm-meyer-ISST left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

CHANGELOG.md Outdated Show resolved Hide resolved
CHANGELOG.md Show resolved Hide resolved
Co-authored-by: Tom Meyer <tom.meyer@isst.fraunhofer.de>
@stephanbcbauer stephanbcbauer merged commit a8f51b8 into main Aug 6, 2024
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.