搭建公司内部的NuGet Server

随着公司业务慢慢的拓展，项目便会越来越来多，很多项目会依赖其他项目DLL，比如一些底层的技术框架DLL引用，还有各业务系统的也有可能会有引用的可能。

项目多，交叉引用多，如果要是有一个DLL更新，那就要更新所有引用该DLL的项目，手动更新的话，有时候找到都很困难，更别说更新了，长此以往，更新DLL会变得很困难，那有什么办法来解决这个问题 ?

对NuGet，话说微软真是为广大用户着想，整出这么个好东西。我估计微软内部DLL也乱得不像样子，然后才有NuGet 这个产物。NuGet 管理程序包工具，Visual Studio 2012&2013 完全集成了这套工具。

但是今天讲的是如何在公司内部搭建NuGet Server，来管理公司内部程序包。使内部程序包引用容易，更新版本容易。废话就不多说了，直接入正题。

搭建NuGet Server 是不是建一个Web站点一样，然后挂在IIS上面? 对的，就是这么回事，建一个网站，管理程序包，能够上传，能够下载，且能够做简单版本管理。

我要说的是，站点确实要建，但是怎么管理程序包，上传，下载也好等，大家不要担心这些都有人已经做好了，只要拿来使用就可以了。接下来搞真的了。

一. NuGetServer 搭建和配置

1. 创建一个 “NuGetServerSolution” 解决方案，然后新增 “NuGetServer” Asp.Net 网站或者应用程序空项目。结构如下图

搭建公司内部的NuGet Server

2. 在 “NuGetServer” 项目上，右键选择 “管理NuGet程序包” ，选择 “联机” ，右上角搜索框中输入“NuGet.Server” Enter，在搜索结果中选择 NuGet.Server 项，进行安装，如图

搭建公司内部的NuGet Server

如果安装最后，提示替换 Web.config ，请选择全是。

3. 编译“NuGetServer”项目，如果没有出异常，这里就创建项目完成，NuGetServer 就这么简单建成，稍后我部署到IIS上面，看看是不是真的可以了，先来讲一下这个网站WebConfig 要配置地方。

<?xml version="1.0" encoding="utf-8"?>

<!--

  For more information on how to configure your ASP.NET application, please visit

  http://go.microsoft.com/fwlink/?LinkId=169433

  -->

<configuration>

  <appSettings>

    <!--

    Determines if an Api Key is required to push\delete packages from the server.

    -->

    <add key="requireApiKey" value="true" />

    <!--

    Set the value here to allow people to push/delete packages from the server.

    NOTE: This is a shared key (password) for all users.

    -->

    <add key="apiKey" value="0226651E-19EE-4F93-A172-5250C84DB16C" />

    <!--

    Change the path to the packages folder. Default is ~/Packages.

    This can be a virtual or physical path.

    -->

    <add key="packagesPath" value="" />

    <!--

    Set allowOverrideExistingPackageOnPush to false to mimic NuGet.org's behaviour (do not allow overwriting packages with same id + version).

    -->

    <add key="allowOverrideExistingPackageOnPush" value="false" />

    <!--

    Set ignoreSymbolsPackages to true to filter out symbols packages. Since NuGet.Server does not come with a symbol server,

    it makes sense to ignore this type of packages. When enabled, files named `.symbols.nupkg` or packages containing a `/src` folder will be ignored.

    If you only push .symbols.nupkg packages, set this to false so that packages can be uploaded.

    -->

    <add key="ignoreSymbolsPackages" value="true" />

    <!--

    Set enableDelisting to true to enable delist instead of delete as a result of a "nuget delete" command.

    - delete: package is deleted from the repository's local filesystem.

    - delist:

      - "nuget delete": the "hidden" file attribute of the corresponding nupkg on the repository local filesystem is turned on instead of deleting the file.

      - "nuget list" skips delisted packages, i.e. those that have the hidden attribute set on their nupkg.

      - "nuget install packageid -version version" command will succeed for both listed and delisted packages.

        e.g. delisted packages can still be downloaded by clients that explicitly specify their version.

    -->

    <add key="enableDelisting" value="false" />

    <!--

    Set enableFrameworkFiltering to true to enable filtering packages by their supported frameworks during search.

    -->

    <add key="enableFrameworkFiltering" value="false" />

    <!--

    When running NuGet.Server in a NAT network, ASP.NET may embed the erver's internal IP address in the V2 feed.

    Uncomment the following configuration entry to enable NAT support.

    -->

    <!-- <add key="aspnet:UseHostHeaderForRequestUrl" value="true" /> -->

  </appSettings>

  <system.web>

    <httpRuntime maxRequestLength="31457280" />

    <compilation debug="true" />

  </system.web>

  <system.serviceModel>

    <serviceHostingEnvironment aspNetCompatibilityEnabled="true" />

  </system.serviceModel>

  <system.webServer>

    <staticContent>

      <mimeMap fileExtension=".nupkg" mimeType="application/zip" />

    </staticContent>

    <modules runAllManagedModulesForAllRequests="true">

    </modules>

  </system.webServer>

</configuration>

第一点：程序包发布，存放的路径，在WebConfig appSettings PackagesPath 这个Key 设置，默认存放在部署的网站根目录Packages文件夹。

第二点：appSettings requireApiKey 这个key 如果设置成 true ， appSettings apiKey 是必须要设置的，这个就像密码一样。可以阻止不知道这个apiKey人访问到程序包

4. 部署到IIS，打开IIS ，右键选择 “网站” ，添加网站，填写网站名称（NuGetServer），选择物理路径，端口号改成 "1000" 确定, 如下图

搭建公司内部的NuGet Server

5. 运行 NuGetServer 网站 "http://localhost:1000/", 出现下图效果，则说NuGet 服务器已经建立完成。

搭建公司内部的NuGet Server

6. 接着配置Visual Studio 连接 NuGetServer。选择“工具”菜单，选择“选项”，弹出“选项”界面，选择 “NuGet Package Manager” ，然后在选择 “程序包源”，

点击 “+”，在界面下方设置名称 “mynuget.org” 随便取，设置源 “http://localhost:1000/nuget” （是不是上图有说），确定关闭界面，回到项目。如下图

搭建公司内部的NuGet Server

在项目右键，选择“管理NuGet程序包”，联机，下面是不是多出了一个 “mynuget.org” 程序源呢，虽然下面还没有发布公司内部的程序包。如下图

搭建公司内部的NuGet Server

到此，NuGetServer 服务器，就搭建并配置完成。接一下来就是如何发布程序包，以及安装程序包了。

二. 发布程序包，以及安装程序包

1. NuGet Package Explorer

将程序包发布到NuGetServer，还要介绍到另外一个工具“NuGet Package Explorer”，这个工具是NuGetServer 程序包一个可视化的工具，它功能很多，可浏览已经发布的程序包信息，可以发布新的程序包（设置程序包版本，已经依赖程序包等），可以删除发布的程序包。

CodePlex：https://npe.codeplex.com/

GitHub：https://github.com/NuGetPackageExplorer

2.在CodePlex 网站上，下载 NuGet Package Explorer , 安装完成后，桌面会多出一个 “NuGet Package Explorer” 图标，如下图

搭建公司内部的NuGet Server

3. 为了方便Demo，再创建一个解决方案 “NuGetServerDemoSolution”，添加“NuGetServerDemo” 控制台项目，再添加 “NuGetServerDemoDLL” 类库项目，结构如下图。

搭建公司内部的NuGet Server

“NuGetServerDemoDLL” 项目主要会做成程序包发布

“NuGetServerDemo” 项目安装“NuGetServerDemoDLL” 程序包

4 . 打开桌面 “NuGet Package Explorer” ，界面如下

搭建公司内部的NuGet Server

图片选项，分别意思是，1. 打开本地的nupkg，nuspec 文件。2. 打开指定 NuGetServer 所有的程序包列表。3.创建一个新程序包。4. 文档

5.把 “NuGetServerDemoDLL” 发布到NuGetServer，点 “Create a new package” 未设置前截图如下

搭建公司内部的NuGet Server

上图分为两个编辑区，一个是 Package Metadata 负责描述程序包信息的，Package Contents 负责程序包文件相关的。

点击 Package Metadata 区 “编辑” 按钮，想编辑 “NuGetServerDemoDLL” 程序包描述信息。

然后将“NuGetServerDemoDLL” 项目产生Dll，拖入 Package Contents 最后效果如下图

搭建公司内部的NuGet Server

点击上图绿色的 √ 关闭编辑Package Metadata ，点击 ”File“ 菜单，选择 Publish 发布程序集，填写 PublishUrl（NuGetServer），PublishKey（apiKey），填写完成点击“Publish” 发布，如果下方提示 “Package published successfully”，则发布成功。如下图。

搭建公司内部的NuGet Server