使用 NuGet.Server 创建和部署 ASP.NET Web 应用程序搭建私有Nuget服务器

使用 NuGet.Server 创建和部署 ASP.NET Web 应用程序搭建私有Nuget服务器

  1. 在Visual Studio中,选择**"新建>文件>"Project** ,搜索"ASP.NET Web 应用程序 (.NET Framework) ",选择 C# 的匹配模板。

  2. 将"框架"设置为".NET Framework 4.6" 。

  3. 为应用程序提供除 NuGet.Server 之外的合适名称,选择"确定",在接下来出现的对话框中选择"空"模板,然后选择"确定" 。

  4. 右键单击项目,选择"管理 NuGet 包" 。

  5. 如果面向 .NET Framework 4.6,请在"包管理器 UI"中,选择"浏览器"选项卡,然后搜索并安装 NuGet.Server 包的最新版本 。 (也可以使用 Install-Package NuGet.Server 从包管理器控制台安装。)如果出现提示,请接受此许可条款。

  6. 安装 NuGet.Server 会将空 Web 应用程序转换成包源。 此操作会安装各种其他包,在应用程序中创建 Packages 文件夹,并修改 web.config 以包括其他设置(请参阅该文件中的注释部分以获取详细信息)。

    重要

    在 NuGet.Server 包完成对该文件的修改后,仔细检查 web.config。 NuGet.Server 可能不会覆盖现有元素,而会创建重复元素。 稍后尝试运行该项目时,这些重复项会导致"内部服务器错误"。 例如,如果 web.config 在安装 NuGet.Server 之前包含 <compilation debug="true" targetFramework="4.5.2" />,则该包不会覆盖它,而是会插入另一个 <compilation debug="true" targetFramework="4.6" />。 在这种情况下,请删除具有较旧框架版本的元素。

  7. 在不使用调试或 Ctrl+F5) 的情况下,使用调试>"开始"菜单在本地运行 站点Visual Studio (。 主页提供包源 URL,如下所示。 如果发现错误,请仔细检查 web.config 是否有重复元素(如前文所述)。

  8. 首次运行应用程序时,NuGet.Server 会重新构建 Packages 文件夹,以包含每个包的文件夹。 这符合 NuGet 3.3 中引入的用于提高性能的本地存储布局。 添加更多包时,请继续遵照此结构。

  9. 测试本地部署后,请根据需要将应用程序部署到任何其他内部或外部网站。

  10. 部署到 http://<domain> 后,用于包源的 URL 将为 http://<domain>/nuget

以外部方式向源添加包

NuGet.Server 站点运行后,就可以使用 nuget push 添加包,前提是在 web.config 中设置了 API 密钥值。

安装 NuGet.Server 包后,web.config 包含一个空 appSetting/apiKey 值:

XML

xml 复制代码
<appSettings>
    <add key="apiKey" value="" />
</appSettings>

省略 apiKey 或将其留空时,会禁用向源推送包的功能。

要启用此功能,请设置 apiKey 的值(理想情况下为强密码),并添加值为 true 名为 appSettings/requireApiKey 的密钥:

XML

xml 复制代码
<appSettings>
    <!-- Sets whether an API Key is required to push/delete packages -->
    <add key="requireApiKey" value="true" />

    <!-- Set a shared password (for all users) to push/delete packages -->
    <add key="apiKey" value="" />
</appSettings>

如果服务器已受保护或不需要其他 API 密钥(例如,在本地团队网络上使用专用服务器时),可将 requireApiKey 设置为 false。 然后,有权访问服务器的所有用户均可推送包。

从 NuGet.Server 3.0.0 开始,推送包的 URL 更改为 http://<domain>/nuget。 在 3.0.0 版本之前,推送 URL 为 http://<domain>/api/v2/package

对于 NuGet 3.2.1 和更高版本,除 /nuget 外,默认还会通过启动配置(默认为 NuGetODataConfig.cs)中的 enableLegacyPushRoute: true 选项启用此旧 URL /api/v2/package。 请注意,在同一项目中托管多个源时,此功能不适用。

从源中删除包

使用 NuGet.Server 时,nuget delete 命令会从存储库中删除一个包,但前提是包含 API 密钥和注释。

如果想要改变行为以从列表中删除包(将其保留为可用于包还原),请将 web.config 中的 enableDelisting 键更改为 true。

配置包文件夹

对于 NuGet.Server 1.5 和更高版本,可使用 web.config 中的 appSettings/packagesPath 值自定义包文件夹:

XML

xml 复制代码
<appSettings>
    <!-- Set the value here to specify your custom packages folder. -->
    <add key="packagesPath" value="C:\MyPackages" />
</appSettings>

packagesPath 可以是绝对或虚拟路径。

省略 packagesPath 或将其留空时,包文件夹是默认的 ~/Packages

发布 Web 应用时使包可用

要在向服务器发布应用程序时在源中提供包,请将每个 .nupkg 文件添加到 Visual Studio 中的 Packages 文件夹,然后将每个文件的"生成操作"设置为"内容",将"复制到输出目录"设置为"始终复制" :

NuGetServer部署到IIs上

Packages文件夹,是发布的nuget程序包所存的地址

在VS2022配置私有NuGet包源

1、项目鼠标右键打开菜单项,选择管理NuGet程序包,打开NuGet包管理器

2、在顶部菜单栏,工具=》选项,弹出对话框

发布NuGet程序包

1、新建一个.Net 8类库项目,随便写入一些代码,在项目鼠标右键选择属性,在项目属性页面,包常规里,在构建时生成NuGet包选择框中选中,生成项目

2、推送包,打开项目生成的Nuget包所在文件夹,输入cmd,定位到该文件夹下,输入命令

需要apikey
dotnet nuget push NuGet包名 --api-key APIkey --source NuGet服务器地址
dotnet nuget push Contoso.08.28.22.001.Test.1.0.0.nupkg --api-key qz2jga8pl3dvn2akksyquwcs9ygggg4exypy3bhxy6w6x6 --source https://api.nuget.org/v3/index.json
不需要apikey
dotnet nuget push NuGet包名 --source NuGet服务器地址
dotnet nuget push DeanNuGet.Package.Consul.1.0.0.nupkg --source http://127.0.0.1:8088/nuget

推送包第二种,直接把该包文件直接复制到NuGetServer服务所在的文件夹里的Packages文件夹下

使用私有NuGet程序包源查找发布的程序包

部署私有nuget.server服务参考文档:
https://learn.microsoft.com/zh-cn/nuget/hosting-packages/nuget-server (推荐)

https://www.cnblogs.com/rqcim/p/15923931.html

打包参考文档:
https://learn.microsoft.com/zh-cn/nuget/quickstart/create-and-publish-a-package-using-visual-studio?tabs=netcore-cli(推荐)
https://zhuanlan.zhihu.com/p/649744350
https://www.cnblogs.com/elsons/p/17012023.html

推送包

使用cmd进入包文件所在的目录,从包含 .nupkg 文件的文件夹运行以下命令。 指定 .nupkg 文件名,并将密钥值替换为 API 密钥。

dotnet nuget push Contoso.08.28.22.001.Test.1.0.0.nupkg --api-key qz2jga8pl3dvn2akksyquwcs9ygggg4exypy3bhxy6w6x6 --source https://api.nuget.org/v3/index.json

没有密钥

dotnet nuget push DeanNuGet.Package.Consul.1.0.0.nupkg --source http://127.0.0.1:8088/nuget