Nuget

最近更新时间:2023-09-11 16:05:26

我的收藏
该文档介绍如何将 NuGet 类型制品存储在 CODING 制品库中,方便团队在项目进行统一的制品管理与版本控制。下文包含制品仓库创建、NuGet 包制作、制品推拉与使用代理等。
说明:
阅读该篇文档需要准备好以下内容:
安装 NuGet。
《基础操作》——创建项目。
制品仓库选择 NuGet 类型。

初始化 NuGet 制品(可选阅读)

访问官网下载并安装 NuGet。

本地生成

若您已熟悉 NuGet 制品的操作,则可以跳过此章节。
1. 新建 Demo 目录。
mkdir nuget-demo && cd nuget-demo
2. 创建 .nuspec 包。
nuget spec [制品名称]
3. 打包制品。
nuget pack <制品名称>.nuspec
4. 打包完成后即可在本地目录中看到生成的包文件。




在线拉取

单击访问 官网,搜索任意 NuGet 制品并通过在线链接或命令行下载。



通过命令行拉取:
nuget install [制品名称] -OutputDirectory packages

配置制品仓库认证

您需要在本地配置认证信息,用以访问 CODING 中的 NuGet 类型制品仓库。此处我们使用自动生成配置完成认证过程。
输入密码后,单击操作指引上的生成个人令牌作为凭据,输入密码后得到配置命令,复制后在需要推送的 NuGet 制品的所在目录执行配置命令即可。此过程的权限机制使用到了个人访问令牌功能,若希望对其进行控制,更多详细内容请参见 访问令牌




推送制品

输入命令行,将相应的名称替换为本地内容即可完成推送。
nuget push -ApiKey api -Source "nuget-go" [制品名称].nupkg

拉取制品

输入命令行,将相应的名称替换为本地内容即可完成拉取。
nuget install -Source "nuget-go" -Version [制品版本] [制品名称]

设置为代理

当 CODING 私有制品仓库不存在想要拉取的制品时,将尝试从配置的代理地址拉取。您可以添加第三方制品源,用以获取特定仓库中的制品。无需额外设置,CODING 将会按照顺序从上到下依次检索相应的制品包。



使用命令拉取制品:
nuget install -Source "nuget-go" -Version [制品版本] [制品名称]
拉取的制品及依赖会成功拉取到本地,并且还会同步至 CODING 制品仓库中,详情页会显示包的来源。



若 CODING 制品仓库中没有自动储存由代理拉取的 NuGet 制品,可能由于以下两点问题导致:
1. 您没有该仓库的推送权限。
2. 您的本地缓存中已有该制品。
代理设置的详细说明,请参见 制品库代理