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

转载 作者:来者不拒 更新时间:2024-01-31 09:26:52 24 4

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

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

    Select the .NET Framework web project template

  2. 将“框架”设置为“.NET Framework 4.6” .

    Setting the target framework for a new project

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

    Select the empty web project

  4. 右键单击项目,选择“管理 NuGet 包” .

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

    Installing the NuGet.Server package

  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 是否有重复元素(如前文所述).

    Default home page for an application with NuGet.Server

  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 。

<appSettings>
    <add key="apiKey" value="" />
</appSettings>

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

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

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 。

<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 文件夹,然后将每个文件的“生成操作”设置为“内容”,将“复制到输出目录”设置为“始终复制” :

Copying packages to the Packages folder in the project

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