PCM Development/Palladio Release Process

Aus SDQ-Wiki
Zur Navigation springen Zur Suche springen


Einleitung mit best practices/prerequisites -> auschecken aller projekte etc.

  • All projects are ready to be released
    • If meta model has been changed, increment version in namespace URI and update version in all projects
    • All bundle and feature versions have been updated to the new version -> Link
    • The version information in the PCM UI bundle has been updated
      • Version in splash screen
      • Version in about text of PalladioProduct extension
    • All manual test cases for the projects to be released have been successfully executed
    • No open issues for version to be released
    • All nightly builds of bundles to be released work
  • All examples have been migrated to work with nightly branch

Release Process

  1. Create and release a new target platform for new Eclipse version
  2. Release new versions of parent POMs
  3. Make all Palladio project use the new parent version and update the individual target platform definitions
  4. Increase the version of bundles/features to new release version
  5. Release new version artifacts
  6. Create Marketplace Entry
  7. Update Documentation
  8. Update Palladio Website
  9. Publish Release

Update Feature and Bundle Versions

  • Set all versions of released artifacts to new release version, by using the forked version of tycho versions plugin (how to use is explained on GitHub).
    • Do not update the bundle/feature versions for the following repositories, as there exist dependencies to third-party tools, licenses, etc. that could result in errors:
      • Palladio-Build-BuckminsterToTychoMigrationPlugin
      • Palladio-Build-DependencyTool
      • Palladio-Build-MavenJavaDocPlugin
      • Palladio-Build-MavenParent
      • Palladio-Build-MavenTP
      • Palladio-Build-MavenTPPlugin
      • Palladio-Build-MavenTychoVersionsPlugin
      • Palladio-Supporting-Branding
      • Palladio-ThirdParty-PerformanceModeleXtractor
      • Palladio-ThirdParty-Wrapper
      • Palladio-ThirdParty-YakinduStateCharts

Artifact Release

  • Ensure that the release update site aggregation file is up to date by regenerating it with the ant script located besides the aggregation file
  • Perform a release for every project to be released
    • Adhere to the order used in the nightly build job
    • Start a parameterized build on the build server with the release flag and the version set
    • Tag the commit used for the release on Github with the version number

Create Marketplace Entry

Update Documentation

  • Create a new wiki page for the release (adhere to the structure of existing wiki pages)
    • create release notes based on solved JIRA issues
    • if fix version might not always be set correctly, the issues resolved since last release might be helpful
    • update system requirements (Java, Eclipse version)
    • update notes about migration of models (if required)
  • Create a section for the release on the PCM Installation page
  • Update the redirect from the PCM stable page to the new release page
  • Add the release to PCM Releases
  • Update release version number on Palladio Component Model in section 'Installation -> Download Palladio-Bench Release XY'

Update Palladio Website

Updating Palladio website content shall be done via typo3 webinterface

  • Open https://www.palladio-simulator.com/typo3/ and login with your ATIS credentials
  • Edit the following content sections
    • Update header image with latest version number
    • Update version and links in section Tools - Download
    • Create a new release news entry visible in section Menu -> AboutPalladio -> Drop-down menu 'News'
      • Tab 'General'
        • Select in the left-hand menu WEB -> 'News Administration'
        • Select in the SDQ-Typo3 Tree view -> News storage => the News administration details view is displayed
        • Click the button 'Create new news record' on top of page of the displayed details view => a form to create the 'News' entry is displayed
        • Fill out the form with all required information
      • Tab 'Media'
        • Pre-requiste: the icon is uploaded to left-hand menu Filelist -> News -> <new release folder>
        • Upload news icon in section Media file
        • Set Image Metadata: Check 'Show in view, specify Title, Alternative Text and Description
      • Tab 'Categories'
        • Check 'Palladio News'
      • Click button 'Save' to publish new news entry

Publish Release