NuGet

Требования

Для работы с пакетами NuGet требуется официальная утилита.

Windows

Установка NuGet через Chocolatey

В командной строке с правами администратора выполните команду:
```
choco install nuget.commandline
```
Дождитесь завершения установки.

Проверка установки

В командной строке выполните команду:
```
nuget
```
Если NuGet установлен правильно, вы увидите справочную информацию о командах NuGet.

macOS

Установка NuGet через Homebrew

Выполните команду в терминале:
```
brew install nuget
```
Проверка установки:
```
nuget
```
Если NuGet установлен правильно, вы увидите справочную информацию о командах NuGet.

Linux

Установка NuGet через .NET SDK

Откройте терминал и добавьте ключ Microsoft:

wget https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb

Обновите список пакетов и установите .NET SDK:
```
sudo apt-get update
sudo apt-get install -y dotnet-sdk-6.0
```
Проверка установки:
```
dotnet --version
```
Если .NET SDK установлен правильно, вы увидите номер версии. NuGet должен быть доступен через dotnet команду:
```
dotnet nuget
```

Установка NuGet через Mono

В терминале выполните команду:
```
sudo apt install mono-complete 
```
Загрузите исполняемый файл в директорию с проектом:
```
wget https://dist.nuget.org/win-x86-commandline/latest/nuget.exe 
```
Проверка установки:
```
mono nuget.exe
```

Регистрация реестра GitFlic

Для добавления пакетов NuGet, необходимо получить транспортный токен Gitflic. С инструкцией по получению токена можно ознакомиться на странице.

В документации ниже встречается атрибут <домен_gitflic> На его место необходимо указать домен, в зависимости от версии:

для SaaS версии registry.gitflic.ru
для self-hosted localhost:8080

Домен и порт для self-hosted версии может отличаться.

Значение атрибута url зависит от уровня доступа:

Уровень	URL
Проект	`http(s)://<домен_gitflic>/project/{ownerAlias}/{projectAlias}/package/-/nuget/index.json`
Компания	`http(s)://<домен_gitflic>/company/{companyAlias}/package/-/nuget/index.json`
Инстанс	`http(s)://<домен_gitflic>/registry/package/-/nuget/index.json`

Переменная в URL	Описание
`ownerAlias`	Псевдоним владельца проекта
`projectAlias`	Псевдоним проекта
`companyAlias`	Псевдоним компании

Для регистрации реестра выполните команду:

nuget source Add -Name GitFlic -Source "{url реестра}" -UserName {логин пользователя} -Password {транспортный токен}

Пример:

nuget source Add -Name GitFlic -Source "http://localhost:8080/project/adminuser/test/package/-/nuget/index.json" -UserName adminuser -Password 802b148c-aaaa-bbbb-cccc-036712b0d269

Скачивание и установка пакета

Для установки пакета выполните команду:

nuget install имя_пакета -Source GitFlic

Публикация пакета

Для публикации пакета выполните команду:

nuget push имя_пакета.nupkg -Source GitFlic