Table of Contents

Artifacts

Valid artifact versions for each ring are stored here:

The schema of each file is as follows:

  • Ring: Describes the ring that the file is for
  • Versions: an array containing the set of valid versions that a customer can have deployed
  • ReleaseKey: This is one version number chosen to describe the Altus version as a set of packages. It is the highest version number of the set of valid packages.
    • This field is display to the user to distinguish the version.
    • Duplicate ReleaseKey entries will be ignored.
    • The maximum length of this string is 50 chars.
    • Avoid special chars.
  • Artifacts: The set of packages and the associated valid version numbers. These packages are a supported set.

These files are constructed by the Hub-Publish-AltusVersions Flow in the Altus Prod Dataverse Environment. This Flow runs every night and looks for any new unique changes to the published packages in each Ring/Feed. It adds any newly found combinations to the top of the array.

If the Hub cannot find an artifact in the list this version entry will be ignored.

The location of the Ring JSON files can be configured in the Hub Global Admin page.

For the logic in the Hub see:

Example File:

{
  "Ring": "Canary",
  "Versions": [
    {
      "ReleaseKey": "2024.9.17.5",
      "Artifacts": {
        "Sensei.D365.SenseiControlsV1": "2024.9.17.5",
        "Sensei.D365.SenseiProject": "2024.9.2.1",
        "Sensei.D365.SenseiProjectIndependent": "2024.9.10.3",
        "Sensei.D365.SenseiProjectIndependent_MasterData":"2024.9.24.1"
      }
    },
    {
      "ReleaseKey": "2024.9.10.3",
      "Artifacts": {
        "Sensei.D365.SenseiControlsV1": "2024.9.17.5",
        "Sensei.D365.SenseiProject": "2024.9.2.1",
        "Sensei.D365.SenseiProjectIndependent": "2024.9.10.3",
        "Sensei.D365.SenseiProjectIndependent_MasterData":"2024.1.16.1"
      }
    },
    {
      "ReleaseKey": "2024.5.17.2",
      "Artifacts": {
        "Sensei.D365.SenseiControlsV1": "2024.5.17.2",
        "Sensei.D365.SenseiProject": "2024.4.16.3",
        "Sensei.D365.SenseiProjectIndependent": "2024.5.7.1",
        "Sensei.D365.SenseiProjectIndependent_MasterData":"2024.1.16.1"
      }
    }
  ]
}