Updating from older versions to BDS 1.11 or higher

The following steps outline the process of updating the Work Repository to use the new version of DevOps package:

1. Local Development Environment initialization.
2. Determine the version of Aras DevOps to install.
3. Update version of the Aras DevOps PowerShell module.
4. Run Update-ArasDevopsFrameworkVersion cmdlet.

1. Clone the repository and check out the branch (See Cloning Repo to Local Working Directory)
2. Open Windows PowerShell as Administrator.
3. Run ./repo-init.ps1 command for initializing the Repository with initial Packages

1. To identify the source name of the DevOps package that points to the NuGet feed containing the DevOps package, run the Get-PackageSource command.

   

   

2. Run of the following commands to find last released version of DevOps package:

   Expand Collapse

   Find-Package -Source azure.artifacts.aras.com -Name "{package_name}" -ProviderName Nuget -MinimumVersion 1 -MaximumVersion 9999

   where "{package_name}" can be Aras.Saas.DevOpsFramework.Msi or Aras.Saas.DevOpsFramework.Aicd or Aras.DevOpsFramework.SaaS3 based on current name of the package used in AutomatedProcedures\Tools\packages.config

   As a result, command will return the latest version:

Note down received version and use it during update instead of "{new version}".

1. Remove the current installed Aras DevOps Module: Run the following command to remove old module in the Windows PowerShell :
   
   Expand Collapse

   Remove-Module -Name "Aras.Devops" -Force

2. Install new version of Aras DevOps Module: It is very important to use the relevant version of Aras DevOps module as there might be changes inside commands that can be critical for update, so run the following command to install the new module in the Windows PowerShell:
   
   Expand Collapse

   Install-Module -Name "Aras.Devops" -RequiredVersion "{new version}" 

   where "{new version}" is version received during Determine the version of Aras DevOps to install step of this chapter.
3. Import new version of Aras DevOps Module: Run the following command to import new module in the Windows PowerShell:
   
   Expand Collapse

   Import-Module -Name "Aras.Devops" -RequiredVersion "{new version}" 

   where "{new version}" is version received during Determine the version of Aras DevOps to install step of this chapter.

1. Open Windows PowerShell as Administration and run the following command:
   
   Expand Collapse

   Update-ArasDevopsFrameworkVersion -DevopsFrameworkReleaseVersion "{BDS simple version}" -RepositoryPath "{Work Repository path}”

   {Work Repository path} - should be replaced with the Work Repository path.
   {BDS simple version} - should be replaced with the new BDS version you want to use, for example:
   
   Expand Collapse

   20. Update-ArasDevopsFrameworkVersion -DevopsFrameworkReleaseVersion "1.11" -RepositoryPath "C:\work\path\to\my\nepo”

2. Verify Success:
   Ensure the command is executed successfully and no errors appear in the console.
   Confirm a new commit is added, containing at least:
   
   • An updated single package version in AutomatedProcedures\tools\packages.config
   • An updated DevOps.Framework.Version in AutomatedProcedures\Default.Settings.include