1、添加推送秘钥凭证
配置上述配置文档appsettings.json
中的 ApiKey
,此处设置为 ggcyadmin@@
,用于演示操作。
{ "ApiKey":"ggcyadmin@@" }
2、生成nuget
包
创建一个项目 NugetTool
,并切换到项目目录下,通过执行指令dotnet pack
生成库对应的Nuget
包。
>dotnet pack 用于 .NET 的 Microsoft (R) 生成引擎版本 17.0.0+c9eb9dd64 版权所有(C) Microsoft Corporation。保留所有权利。 正在确定要还原的项目… 所有项目均是最新的,无法还原。 已成功创建包“物理路径\NugetTool\bin\Debug\NugetTool.1.0.0.nupkg”。
该路径下生成对应版本的nuget
包。
NugetTool.1.0.0.nupkg
3、发布nuget
包
不带apikey
配置时,执行如下指令
>dotnet nuget push -s http://localhost:5000/v3/index.json NugetTool.1.0.0.nupkg
输出:
>dotnet nuget push -s http://localhost:5000/v3/index.json NugetTool.1.0.0.nupkg warn : 未提供 API 密钥,找不到 'http://localhost:5000/api/v2/package' 的 API 密钥。要保存源的 API 密钥,请使用 "setApiKey" 密钥。 正在将 NugetTool.1.0.0.nupkg 推送到 'http://localhost:5000/api/v2/package'... PUT http://localhost:5000/api/v2/package/ Unauthorized http://localhost:5000/api/v2/package/ 322 毫秒 error: Response status code does not indicate success: 401 (Unauthorized).
带apikey
配置时,需要携带apikey
进行发布
>dotnet nuget push -s http://localhost:5000/v3/index.json NugetTool.1.0.0.nupkg -k "ggcyadmin@@"
输出:
>dotnet nuget push -s http://localhost:5000/v3/index.json NugetTool.1.0.0.nupkg -k "ggcyadmin@@" 正在将 NugetTool.1.0.0.nupkg 推送到 'http://localhost:5000/api/v2/package'... PUT http://localhost:5000/api/v2/package/ Created http://localhost:5000/api/v2/package/ 460 毫秒 已推送包。
5、查看发布结果
发布成功后,刷新页面出现如下结果:
Vs
中配置Nuget
包源,包源地址,为Baget
对应地址http://localhost:5000
和/v3/index.json
http://localhost:5000/v3/index.json
相关配置如下:
配置后,打开任意解决方案,查看Vs中顶部菜单中的【工具】-【Nuget包管理器】-【管理解决方案的Nuget包】,切换数据源,可以看到当前Baget对应的包,代表服务搭建成功
五、删除特定包
卸载默认情况下,不会直接删除对应版本的包,只是在Nuget
列表中不显示,实际的包文件还存在,同样,删除也分为未配置apikey
和配置apikey
两类,此处仅仅演示配置 apikey
之后的操作。
未携带apikey
dotnet nuget delete -s http://localhost:5000/v3/index.json NugetTool 1.0.0
输出:
>dotnet nuget delete -s http://localhost:5000/v3/index.json NugetTool 1.0.0 warn : 未提供 API 密钥,找不到 'http://localhost:5000/api/v2/package' 的 API 密钥。要保存源的 API 密钥,请使用 "setApiKey" 密钥。 NugetTool 将从 'http://localhost:5000/api/v2/package' 删除 1.0.0。是否继续? (y/N) y warn : 正在从 'http://localhost:5000/api/v2/package' 删除 NugetTool 1.0.0。 DELETE http://localhost:5000/api/v2/package/NugetTool/1.0.0 Unauthorized http://localhost:5000/api/v2/package/NugetTool/1.0.0 81 毫秒 error: Response status code does not indicate success: 401 (Unauthorized).
携带apikey
>dotnet nuget delete -s http://localhost:5000/v3/index.json NugetTool 1.0.0 -k "ggcyadmin@@"
输出:
>dotnet nuget delete -s http://localhost:5000/v3/index.json NugetTool 1.0.0 -k "ggcyadmin@@" NugetTool 将从 'http://localhost:5000/api/v2/package' 删除 1.0.0。是否继续? (y/N) y warn : 正在从 'http://localhost:5000/api/v2/package' 删除 NugetTool 1.0.0。 DELETE http://localhost:5000/api/v2/package/NugetTool/1.0.0 NoContent http://localhost:5000/api/v2/package/NugetTool/1.0.0 101 毫秒 NugetTool 已成功删除 1.0.0。
查看服务端,对应已经没有该版本包显示
如果需要彻底清除该版本,删除本地数据库中,对应历史记录以及,默认的nuget包文件服务端存储文件,也可以采用修改配置文件,允许包文件版本覆盖操作,用于更新同版本包,默认服务对应的 Nuget
包存储路径为解压路径的根目录packages
。
六、常见问题
删除 nuget
包后,同版本号 nuget
包无法进行安装。
>dotnet nuget push -s http://localhost:5000/v3/index.json NugetTool.1.0.0.nupkg -k "ggcyadmin@@" 正在将 NugetTool.1.0.0.nupkg 推送到 'http://localhost:5000/api/v2/package'... PUT http://localhost:5000/api/v2/package/ Conflict http://localhost:5000/api/v2/package/ 400 毫秒 要跳过已发布的包,请使用 --skip-duplicate 选项 error: Response status code does not indicate success: 409 (Conflict).
对应 nuget 默认目录中 packages
,文件仍然存在。
Enable package hard deletions
To prevent the “left pad” problem, BaGet’s default configuration doesn’t allow package deletions. Whenever BaGet receives a package deletion request, it will instead “unlist” the package. An unlisted package is undiscoverable but can still be downloaded if you know the package’s id and version. You can override this behavior by setting the
PackageDeletionBehavior
{ "PackageDeletionBehavior": "HardDelete", }
Enable package overwrites
Normally, BaGet will reject a package upload if the id and version are already taken. You can configure BaGet to overwrite the already existing package by setting
AllowPackageOverwrites
{ "AllowPackageOverwrites": true, }
重启服务后,再次进行上传操作,提示成功。
七、参考链接
[1]基础配置:https://loic-sharma.github.io/BaGet/configuration/