本文介绍了如何使用BaGet搭建和使用NuGet包仓库的过程,包括下载BaGet、配置文件(主要是ApiKey和数据库信息)、运行项目并验证成功,以及如何通过.NET CLI推送NuGet包到仓库、在Visual Studio中引用包。此外,还提及了Docker部署的注意事项和如何配置ApiKey、删除包的命令,并简要说明了BaGet的其他配置信息参考。
前言
应该或许大概每个公司都会有自己的NuGet
包仓库吧。
不会吧!不会吧!不会吧!不会还没有自己的仓NuGet
仓库吧!
开个玩笑,虽然我觉得有没有无所谓,但是为了这篇博客它必须有所谓。
在工具的选择上我了解到的其实也不多,除了本文要说的BaGet
,还了解有Java
开发的Nexus
也支持NuGet
。
为什么选择BaGet
呢?因为他是asp.net core
开发的。
上手
1、下载
下载地址:https://github.com/loic-sharma/BaGet/tags
下载后的项目:
然后我们发布项目,直接在项目的根目录执行:dotnet publish
,发布的文件放在bin
文件夹最深处。
2、配置文件appsettings.json
打开发布后的文件夹,找到appsettings.json
文件。
主要是修改ApiKey
和Database
信息,我们这里ApiKey先默认为空。
3、运行项目
直接双击文件夹的baget.exe
运行程序,dotnet run
也是可以的。
在浏览器访问 http://localhost:5000
如果出现如下界面就表示启动成功了
运行成功后,你配置的数据库会新增一个库,我这边配置的是Mysql
3、推送包
我们进到网页的 Upload
tab
栏可以看到不同工具上传所用的命令
我们就采用第一种.NET CLI
的方式上传。
在本地准备一个Nuget
包,我这边已经准备好了(vs
右键属性就有打包功能)。
然后进到cmd
命令行如下命令,由于我没有配置ApiKey
,所以会提示
dotnet nuget push -s http://localhost:5000/v3/index.json datatekoms.utils.3.4.4.nupkg
推送成功后的页面
数据库会生成如下几张表,Packages
存放的就是包的基本信息。
然后进到项目的根目录会看到我们上传的包文件(我这边项目懒得启动,所以用的是linux
下的截图)
4、引用包
找到我们自己的包管理器地址
进到vs
的NuGet
包管理器配置包源
然后搜索就可以找到我们推送的包了
docker
部署
docker
部署与正常部署asp.net core
项目一样,唯一需要注意的是最好把包的地址挂载到本地,避免docker
重启数据丢失。
docker run -itd --name baget.server -p 3579:80 -v /usr/local/baget/package:/app/packages baget-img
api-key
上面我们演示的是没有设置ApiKey
,如果设置了ApiKey
我们再推送是会出现验证失败
这时候我们需要在命令后面加上我们设置的ApiKey
删除包
删除包的命令也很简单
dotnet nuget delete -s http://localhost:50561/v3/index.json datatekoms.utils 3.4.4
由于我们对删除行为的配置默认是只删除列表,不删除文件,所以执行删除后文件还是存在
如果想连带文件一起删除,我们可以这样配置,启用硬删除:HardDelete
BaGet
其他配置信息可以参考官方文档:https://loic-sharma.github.io/BaGet/
推荐阅读