Skip to content

Commit

Permalink
Add NuGet.Server migration guide (loic-sharma#326)
Browse files Browse the repository at this point in the history
  • Loading branch information
loic-sharma authored Sep 9, 2019
1 parent 1b9da5b commit 0156d23
Show file tree
Hide file tree
Showing 3 changed files with 42 additions and 2 deletions.
39 changes: 39 additions & 0 deletions docs/tools/migrate.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
# Migrate from NuGet.Server

[NuGet.Server](https://github.com/NuGet/NuGet.Server) is a lightweight standalone NuGet server. It is strongly recommended that you upgrade to BaGet if you use NuGet.Server. Feel free to open a [GitHub issue](https://github.com/loic-sharma/BaGet/issues) if you need help migrating.

!!! info
Please refer to the [BaGet vs NuGet.Server](../vs/nugetserver.md) page for reasons to upgrade to BaGet.

# Steps

Make sure that you've installed [nuget.exe](https://www.nuget.org/downloads). In PowerShell, run:

```ps1
$source = "<NuGet.Server package source>"
$destination = "<BaGet package source>"
```

If you've [configured BaGet to require an API Key](https://loic-sharma.github.io/BaGet/configuration/#requiring-an-api-key), set it using [the `setapikey` command](https://docs.microsoft.com/en-us/nuget/reference/cli-reference/cli-ref-setapikey):

```ps1
& nuget.exe setapikey "NUGET-SERVER-API-KEY" -Source $destination
```

Now run the following PowerShell script:

```ps1
if (!(Test-Path "Web.config")) {
throw "Please run this script in the same directory as NuGet.Server's Web.config file"
}
(& nuget.exe list -AllVersions -Source $source).Split([Environment]::NewLine) | % {
$id = $_.Split(" ")[0].Trim()
$version = $_.Split(" ")[1].Trim()
$path = [IO.Path]::Combine("Packages", $id, $version, "${id}.${version}.nupkg")
Write-Host "nuget.exe push -Source $destination ""$path"""
& nuget.exe push -Source $destination $path
}
```
4 changes: 2 additions & 2 deletions docs/vs/nugetserver.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,6 @@
* Cross-platform
* Supports NuGet v3 APIs

## Upgrade Guide
## Migration Guide

TODO
You can use the [NuGet.Server migration](../tools/migrate.md) guide to import your NuGet.Server packages into BaGet.
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,7 @@ pages:
- Tools:
- Mirroring: tools/mirroring.md
- BaGet SDK: tools/sdk.md
- Migrate from NuGet.Server: tools/migrate.md
- BaGet vs. Other:
- nuget.org: vs/nugetorg.md
- NuGet.Server: vs/nugetserver.md
Expand Down

0 comments on commit 0156d23

Please sign in to comment.