Nuget using Mono¶

This is an example of how to use the Strongbox artifact repository manager with NuGet.

Pre-requisites¶

Linux OS
Mono cli environment
nuget.exe
Microsoft.Build.dll if running Mono pre version 3
Installed and configured a Strongbox Distribution
Java Development Kit (JDK) version 1.8.x

If using alias nuget="mono /usr/local/bin/nuget.exe" then mono --runtime=v4.0 nuget.exe can be replaced with nuget in commands below.

Example project¶

The "Hello, Strongbox!" example project can be found here.

Prepare project workspace¶

Go to the root project folder and execute the following commands:

$ mkdir -p ./bin
$ mkdir -p ./.nuget
$ echo '<?xml version="1.0" encoding="utf-8"?><configuration></configuration>' > ./.nuget/NuGet.config

There should be no output if success

Note

Note that bin and .nuget folders must be added to ignore list of your VCS

Create NuGet configuration¶

Add default push repository URL¶

$ mono --runtime=v4.0 nuget.exe config -set DefaultPushSource={repositoryUrl} -ConfigFile ./.nuget/NuGet.config

Example below (there should be no output if success):

localhsot:/strongbox-examples/hello-strongbox-nuget-mono$ mono --runtime=v4.0 nuget.exe config -set DefaultPushSource=http://localhost:48080/storages/storage-nuget/nuget-releases -ConfigFile ./.nuget/NuGet.config

Get api key to use with your repository¶

NuGet protocol assumes that users need to be authenticated with API Key to be able to deploy or delete your packages. Strongbox provides the REST API to get an API Key for specified user, you can use curl for this like follows:

$ curl -X GET --user admin:password http://localhost:48080/api/users/admin/generate-security-token
eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJTdHJvbmdib3giLCJqdGkiOiJCdU85OU8xV2VzQ1NkYWcyT3k0eHh3Iiwic3ViIjoiYWRtaW4iLCJzZWN1cml0eS10b2tlbi1rZXkiOiJhZG1pbi1zZWNyZXQifQ.Yzq5zYlDZVCVSxRmSgclRCHW_KojZw-iFGfkWWnTTEw

Set api key to use with your repository¶

$ mono --runtime=v4.0 nuget.exe setApiKey {apiKey} -Source {repositoryUrl} -ConfigFile ./.nuget/NuGet.config

Example output

carlspring@linux-70e2:/home/carlspring/strongbox-examples/hello-strongbox-nuget-mono> mono --runtime=v4.0 nuget.exe setApiKey bXktYXBpLWtleQ== -Source http://localhost:48080/storages/storage-nuget/nuget-releases -ConfigFile ./.nuget/NuGet.config
The API Key 'bXktYXBpLWtleQ==' was saved for 'http://localhost:48080/storages/storage-nuget/nuget-releases'.

Provide storage authentication (if needed)¶

Strongbox is using HTTP Basic Authentication to access storages by default, so you need to configure your credentials in the <packageSourceCredentials> section of your NuGet.config file.

Finally, your NuGet.config file should look like follows:

$ cat .nuget/NuGet.config 
<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <config>
    <add key="DefaultPushSource" value="http://localhost:48080/storages/storage-nuget/nuget-releases" />
  </config>
  <apikeys>
    <add key="http://localhost:48080/storages/nuget-common-storage/nuget-releases" value="YpDSPr0yOqTjEPuaG6+aTOV6QJWI0X4MliV/yARLTZXb4cb55LaZF8jOhWvg+Zqnkn8ykhHtj3byEwKL60GWbsaeZZJdPHeP4OgFftPSmGkJSovyMRh1bbATPi6hx6eRpquP8daWKhfAvca0RjnPA22s3KtcdDlI3dV6IQzTLOfANkdmyhH95A+LHc51BXQKVWQPJ6B94TEBonEqWIt2bNti66Pd4sbDvKZJAA1GRjDprFxukg4EUz8YD++JYWP6X+BNCu2jYNXBS6tbw6Zx1o9HwOd/9eUC+1lP9Sbvj4tGSB/D5MwKhNabKwElhjikDNg5TaI4Il6R3sw9zJXyDdsGIfpKg4ICwBt6suuqEOQZQIWJKum3NuFYOocke6BsHpHC2Iz/hMkCjQz3v8DNaKLU+9pr6qOOaEsfyJCkj313AWxigkHqKcFMlJPfhGcUjZX6wq1vmPMO2erYBiE89IFCdAadBWpB2J6s79YoWwb5Elvf7SiLlU6lDEq9D8mOQLTeWrEkoD3S9h/CiV2qug==" />
  </apikeys>
  <packageSources>
    <add key="strongbox" value="http://localhost:48080/storages/storage-nuget/nuget-releases" />
  </packageSources>
  <packageSourceCredentials>
    <strongbox>
        <add key="Username" value="admin" />
        <add key="ClearTextPassword" value="password" />
    </strongbox>
  </packageSourceCredentials>
</configuration>