Skip to content

Commit

Permalink
Migrate to winget #2 (#1678)
Browse files Browse the repository at this point in the history
* Replaced documented references with Winget
* Update telemitery message
* Updated execute to devops-migration.exe
* Updated all packages to latest
* Updated executable in winget
* Updated to devopsmigration.exe
  • Loading branch information
MrHinsh authored Oct 10, 2023
1 parent 868105d commit 4cfec9e
Show file tree
Hide file tree
Showing 9 changed files with 11 additions and 11 deletions.
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ The Azure DevOps Migration Tools allow you to bulk edit and migrate data between

We use [winget](https://learn.microsoft.com/en-us/windows/package-manager/winget/) to host the tools, and you can use the command `winget install nkdAgility.AzureDevOpsMigrationTools` to install them on Windows 10 and Windows 11. For other operating systems you can download the [latest release](https://github.com/nkdAgility/azure-devops-migration-tools/releases/latest) and unzip it to a folder of your choice.

The tools will be installed to `%Localappdata%\Microsoft\WinGet\Packages\nkdAgility.AzureDevOpsMigrationTools_Microsoft.Winget.Source_XXXXXXXXXX` and a symbolic link to `devops-migration.exe` that lets you run it from anywhere using `devops-migration init`.
The tools will be installed to `%Localappdata%\Microsoft\WinGet\Packages\nkdAgility.AzureDevOpsMigrationTools_Microsoft.Winget.Source_XXXXXXXXXX` and a symbolic link to `devopsmigration.exe` that lets you run it from anywhere using `devopsmigration init`.

For a more detailed getting started guide please see the [documentation](https://nkdagility.com/docs/azure-devops-migration-tools/getting-started.html).

Expand All @@ -79,7 +79,7 @@ We use these tools with our customers, and for fun, to do real world migrations

## Change Log

- 14.0 - Move from Chocolaty to Winget as the base installer. We will continue to publish to Chocolaty, but we recommend using `winget install nkdAgility.AzureDevOpsMigrationTools` for future installs. Main executable renamed to "devops-migration.exe" to prevent conflict with other applications with symbolic links.
- 14.0 - Move from Chocolaty to Winget as the base installer. We will continue to publish to Chocolaty, but we recommend using `winget install nkdAgility.AzureDevOpsMigrationTools` for future installs. Main executable renamed to "devopsmigration.exe" to prevent conflict with other applications with symbolic links.
- 13.2 - Added [ExportUsersForMapping](https://nkdagility.com/learn/azure-devops-migration-tools/Reference/v1/Processors/TeamMigrationContext/) to export a json file with a list of users ready for a field mapping.
- 13.1 - Update all NuGet packages to latest version.
- 13.0 - Update to .net 7.0 with all dependancies. Focus on documentation improvements to support future updates.
Expand Down
2 changes: 1 addition & 1 deletion docs/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,5 +80,5 @@ For details on how to add the field in each case, and trouble shooting check the
Yes! You can turn off telemetry from v13.2 by passing `true` as a value for `--disableTelemetry` on the command line.

```
devops-migration.exe --config configuration.json --disableTelemetry true
devopsmigration.exe --config configuration.json --disableTelemetry true
```
6 changes: 3 additions & 3 deletions docs/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ In order to run the migration you will need to install the tools first.
1. Install [winget](https://learn.microsoft.com/en-us/windows/package-manager/winget/)
1. Run `winget install nkdAgility.AzureDevOpsMigrationTools` from the [Windows Terminal](https://learn.microsoft.com/en-us/windows/terminal/) to install on Windows 10 and Windows 11. For other operating systems you can download the [latest release](https://github.com/nkdAgility/azure-devops-migration-tools/releases/latest) and unzip it to a folder of your choice.

The tools will be installed to `%Localappdata%\Microsoft\WinGet\Packages\nkdAgility.AzureDevOpsMigrationTools_Microsoft.Winget.Source_XXXXXXXXXX` and a symbolic link to `devops-migration.exe` that lets you run it from anywhere using `devops-migration init`.
The tools will be installed to `%Localappdata%\Microsoft\WinGet\Packages\nkdAgility.AzureDevOpsMigrationTools_Microsoft.Winget.Source_XXXXXXXXXX` and a symbolic link to `devopsmigration.exe` that lets you run it from anywhere using `devopsmigration init`.

## Upgrade

Expand Down Expand Up @@ -70,14 +70,14 @@ The default [WorkItemMigrationConfig](/docs/Reference/v1/Processors/WorkItemMigr
5. Enable the `WorkItemMigrationConfig` processor by setting `Enabled` to `true`
6. [OPTIONAL] Modify the `WIQLQueryBit` to migrate only the work items you want. The default WIQL will migrate all open work items and revisions excluding test suites and plans
7. Adjust the [`NodeBasePaths`](/docs/Reference/v1/Processors/WorkItemMigrationConfig.md) or leave empty to migrate all nodes
8. From your working folder run `devops-migration execute --config .\configuration.json`
8. From your working folder run `devopsmigration execute --config .\configuration.json`

**Remember:** If you want a processor to run, its `Enabled` attribute must be set to `true`.

Refer to the [Reference Guide](/docs/Reference/index.md) for more details.

## Other Configuration Options
When running `devops-migration init` you can also pass `--options` with one of the following:
When running `devopsmigration init` you can also pass `--options` with one of the following:

- *Full* -
- *WorkItemTracking* -
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<OutputType>Exe</OutputType>
<TargetFramework>net7.0</TargetFramework>
<Product>Azure DevOps Migration Tools [REST API]</Product>
<AssemblyName>migration</AssemblyName>
<AssemblyName>devopsmigration</AssemblyName>
</PropertyGroup>

<ItemGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<OutputType>Exe</OutputType>
<TargetFramework>net472</TargetFramework>
<Product>Azure DevOps Migration Tools [Object Model]</Product>
<AssemblyName>devops-migration</AssemblyName>
<AssemblyName>devopsmigration</AssemblyName>
<PlatformTarget>AnyCPU</PlatformTarget>
</PropertyGroup>

Expand Down
2 changes: 1 addition & 1 deletion src/MigrationTools.Extension/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ The Azure DevOps Migration Tools allow you to bulk edit and migrate data between

We use [winget](https://learn.microsoft.com/en-us/windows/package-manager/winget/) to host the tools, and you can use the command `winget install nkdAgility.AzureDevOpsMigrationTools` to install them on Windows 10 and Windows 11. For other operating systems you can download the [latest release](https://github.com/nkdAgility/azure-devops-migration-tools/releases/latest) and unzip it to a folder of your choice.

The tools will be installed to `%Localappdata%\Microsoft\WinGet\Packages\nkdAgility.AzureDevOpsMigrationTools_Microsoft.Winget.Source_XXXXXXXXXX` and a symbolic link to `devops-migration.exe` that lets you run it from anywhere using `devops-migration init`.
The tools will be installed to `%Localappdata%\Microsoft\WinGet\Packages\nkdAgility.AzureDevOpsMigrationTools_Microsoft.Winget.Source_XXXXXXXXXX` and a symbolic link to `devopsmigration.exe` that lets you run it from anywhere using `devopsmigration init`.

For a more detailed getting started guide please see the [documentation](https://nkdagility.com/docs/azure-devops-migration-tools/getting-started.html).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Installers:
InstallerType: zip
NestedInstallerType: portable
NestedInstallerFiles:
- RelativeFilePath: migration.exe
- RelativeFilePath: devopsmigration.exe
InstallerUrl: https://github.com/nkdAgility/azure-devops-migration-tools/releases/download/v13.0.4/MigrationTools-13.0.4.zip
InstallerSha256: 68D12EE65166CE03FF891D97564BD183D6139E432F6B90A842E71311BCA07535
ManifestType: installer
Expand Down
Binary file added src/MigrationTools.WinGet/wingetcreate.exe
Binary file not shown.
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ public EngineConfiguration BuildFromFile(string configFile = "configuration.json
_logger.LogTrace(ex, "Configuration Error");
_logger.LogCritical("Your configuration file was loaded but was unable to be mapped to ");
_logger.LogError(ex.Message);
_logger.LogError("How to Solve: Malformed configurations are usually a result of changes between versions. The best way to understand the change is to run 'devops-migration init' to create a new wel formed config and determin where the problem is!");
_logger.LogError("How to Solve: Malformed configurations are usually a result of changes between versions. The best way to understand the change is to run 'devopsmigration init' to create a new wel formed config and determin where the problem is!");
Environment.Exit(-1);
return null;
}
Expand Down

0 comments on commit 4cfec9e

Please sign in to comment.