在单个服务器上本地安装 Azure DevOps

  • 项目

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

设置Azure DevOps Server的最简单方法是将所有内容放在单个服务器上。 若要确认此配置是否适合你的团队，请参阅 硬件建议。 如果没有，请考虑改用 双服务器 或 多服务器 配置。

如果要从早期版本升级，请详细了解 兼容性、 发行说明和 升级入门。

注意

对于所有版本的 Azure DevOps Server，安装新部署的过程都类似。 本文中显示的图像可能引用Azure DevOps Server 2022 或 2019 Azure DevOps Server，但是，除非另有说明，否则配置的信息是相同的。

先决条件

  1. 准备满足 系统要求的单个计算机。

  2. 如果不打算使用 SQL Server Express，请设置受支持的 SQL Server 版本。 在本地为 Azure DevOps 设置SQL Server时，至少安装数据库引擎，并 Full-Text 和语义提取搜索功能。

    建议仅对个人或评估部署使用 SQL Server Express。 本地 Azure DevOps 的付费副本包括SQL Server Standard许可证。 有关详细信息，请参阅Azure DevOps Server定价和 Team Foundation Server 定价。 如果使用包含的许可证，则只能将其用于使用这些产品创建的数据库。

  3. 用于配置安装的帐户必须是 SQL Server 中 sysadmin 服务器角色的成员。

    注意

    在本地安装 Azure DevOps 涉及一组需要高权限的复杂操作。 这些操作包括创建数据库、为服务帐户预配登录名等。 从技术上讲，只需要：

    • serveradmin 角色的成员身份。

    • ALTER ANY LOGIN、CREATE ANY DATABASE 和 VIEW ANY DEFINITION 服务器范围的权限。

    • master 数据库上的 CONTROL 权限。

      sysadmin 服务器角色的成员身份授予所有这些成员身份和权限。 这是确保配置成功的最简单方法。 如有必要，可以在安装后撤消这些成员身份和权限。

  4. 若要支持安装和配置 搜索 扩展，需要提供用户名和密码。 安装和配置搜索支持代码、工作项和 Wiki 搜索功能。 有关详细信息，请参阅 配置搜索。 请注意，用户名不能包含连字符或特殊字符。

    注意

    搜索还需要 Oracle Server JRE 8 (Update 60 或更高版本) 。 可以通过接受适用于服务器 JRE 的 Oracle 二进制代码许可协议并选择 “配置”来下载并安装或更新到最新版本。 请注意，这会将JAVA_HOME环境变量设置为指向 Java 安装目录，并且服务器 JRE 不提供自动更新。

  5. 配置应用程序层时，可以选择网站设置。 查看 网站设置 以了解选项和要求。

下载和安装

  1. 通过以下渠道之一下载Azure DevOps Server：

  2. 开始安装。

    安装程序将文件复制到计算机上，然后启动 Azure DevOps Server Configuration Center 向导。

  3. 可以通过选择 “启动向导”来配置安装，也可以稍后返回并启动服务器配置向导，如下一部分所述。

    配置中心、启动向导、启动向导Azure DevOps Server 2022 的屏幕截图。

    此处我们显示了为 2019 Azure DevOps Server 提供的向导：配置中心、启动向导Azure DevOps Server 2019 的屏幕截图。

为新部署选择“基本”或“高级”

配置服务器的第一步是在两个部署选项之间进行选择。

  • 选择要在单个服务器上安装 的新部署 - 基本 方案。 此方案已针对简单性进行优化，为大多数输入使用默认选项。

    “服务器配置向导”“新建部署”的屏幕截图，选择了“基本”选项，“2022”。

    使用 “新建部署 - 基本 ”方案，你将指定以下设置：

    • 语言：选择要用于配置的语言。
    • SQL Server实例：选择是安装SQL Server Express还是使用现有的SQL Server实例。
    • 应用程序层：选择要使用的网站设置，其中包括是使用 HTTP 绑定还是 HTTPS 绑定。 有关详细信息，请参阅 网站设置。
    • 搜索：选择是安装和配置代码搜索功能，还是使用现有的搜索服务。 有关详细信息，请参阅 配置搜索。

  • 如果需要对所有输入进行完全控制，请选择 “新建部署 - 高级 ”方案。

    “服务器配置向导”“新建部署”的屏幕截图，已选择“高级”选项，“2022”。

    你将指定以下附加设置：

    • 帐户：选择运行进程的服务帐户。 基本方案中使用的默认值在 NT AUTHORITY\NETWORK SERVICE 已加入域的方案和 LOCAL SERVICE 工作组方案中。
    • 应用程序层：
      • 在 “SSH 设置”下，选择是否启用 SSH 以及它应侦听的端口。 基本方案中使用的默认值是在端口 22 上配置 SSH。
      • 在 “文件缓存位置”下，选择用于频繁访问的资源的文件缓存的位置。 基本方案中使用的默认值是本地驱动器上具有最多可用空间的路径 AzureDevOpsServerData\ApplicationTier\_fileCache 。
    • 项目集合：指定要用于存储项目的项目集合的名称。 基本方案默认行为是创建名为 DefaultCollection 的项目集合。
    • 帐户：选择运行进程的服务帐户。 基本方案中使用的默认值在 NT AUTHORITY\NETWORK SERVICE 已加入域的方案和 LOCAL SERVICE 工作组方案中。
    • 应用程序层：
      • 在 “SSH 设置”下，选择是否启用 SSH 以及它应侦听的端口。 基本方案中使用的默认值是在端口 22 上配置 SSH。
      • 在 “文件缓存位置”下，选择用于频繁访问的资源的文件缓存的位置。 基本方案中使用的默认值是本地驱动器上具有最多可用空间的路径 AzureDevOpsServerData\ApplicationTier\_fileCache 。
    • 报告： (可选) 选择是否要使用SQL Server Reporting Services创建报表。 需要指定以下信息才能支持此选择：
      • Reporting Services 实例
      • 报表服务器 URL
      • 报表管理器 URL
      • SQL Server Analysis Services 实例
      • 报表读取者帐户名称
    • 项目集合：指定要用于存储项目的项目集合的名称。 基本方案默认行为是创建名为 DefaultCollection 的项目集合。

  • 查看选择并选择“ 验证”后，向导将运行就绪情况检查来验证环境和设置选择。 如果成功，可以配置部署。 否则，请修复任何错误并重新运行就绪情况检查。

使用“基本”选项进行配置

本部分将引导你使用从“服务器配置向导”“新建部署”页中选择的“基本”选项配置Azure DevOps Server。

  1. 在 “欢迎 ”页中，选择选项，然后选择“ 下一步”。

    服务器配置向导的屏幕截图，欢迎页，2022。

  2. 从“ 新建部署 ”页中选择部署类型，然后选择“ 下一步”。

    “服务器配置向导”的屏幕截图，“新建部署”页，2022。

  3. 在下一页上，选择 “新建部署 - 基本”，然后选择“ 下一步”。

    “服务器配置向导”的屏幕截图，“新建部署 - 基本”页，2022。

  4. 在 “语言 ”页面中，选择首选 “语言 ”选项，然后选择“ 下一步”。

    “语言”页的屏幕截图。

  5. 从“SQL Server实例”页中，选择要使用的SQL Server实例。 出于评估目的，请选择“安装SQL Server Express”。 出于生产目的，请选择“使用现有SQL Server实例”。 然后，选择“下一步”。

    “SQL Server实例”页的屏幕截图。

    如果选择了“使用现有SQL Server实例”，请在下一页中输入数据库信息，然后选择“测试”进行验证。 然后选择“下一步” 。

    “数据库”页的屏幕截图。

  6. 从 “应用程序层 ”页中，选择要使用的网站设置（包括是使用 HTTP 绑定还是 HTTPS 绑定），然后选择“ 下一步”。 有关详细信息，请参阅 网站设置。

    “服务器配置向导”的屏幕截图，“应用程序层”页，2022。

  7. 在“搜索”页中，选择是安装和配置搜索功能，还是使用现有的搜索服务。 安装和配置搜索支持代码、工作项和 Wiki 搜索功能。 有关详细信息，请参阅 配置搜索。 选择“下一步”。

    服务器配置向导的屏幕截图，搜索页，2022。

    Azure DevOps Server 2019 搜索页的屏幕截图。

  8. 在“ 审阅 ”页中，查看所选内容，然后选择“ 验证”，向导将运行就绪情况检查来验证环境和设置选择。 如果成功，可以配置部署。 否则，请修复任何错误并重新运行就绪情况检查。

    “服务器配置向导”的屏幕截图，“审阅”页，2022。

  9. 就绪情况检查。 通过所有检查后，即可完成配置。 选择 “配置”。

    提示

    可以通过在左窗格中选择“ 上一页 ”或“页面名称”返回到上一页。 如果更改配置设置，则需要通过选择 “单击此处重新运行就绪情况检查”来验证设置。

    “服务器配置向导”“就绪情况检查”页的屏幕截图，Azure DevOps Server 2022。

    “配置开始”页的屏幕截图，Azure DevOps Server 2019 年。

  10. 向导会转到 “配置” 页，并开始配置每项功能并显示进度。 此步骤可能需要几分钟。 如果所有配置都成功，则会收到以下成功消息。 选择“下一页”。

    服务器配置向导的屏幕截图，配置页，配置进度，2022。

    配置进度的屏幕截图，2019 年。

  11. 在 “完成 ”页中，查看配置结果。 查看配置结果，然后选择 “复制完整路径” ，将链接复制到配置日志文件。 选择Azure DevOps Server URL 链接以连接到已配置服务器的 Web 门户。

    服务器配置向导的屏幕截图，已完成页，进度已完成，2022。

    在此示例中，链接为 /http:aaronha001/。

    “服务器配置向导”的屏幕截图，“已完成”页，“已完成进度”，2019 年。

使用“高级”选项进行配置

本部分将引导你完成使用“高级”选项配置Azure DevOps Server。

注意

对于所有版本的 Azure DevOps Server 和 Team Foundation Server 2018，使用“高级”选项安装新部署的过程都类似，但 Azure DevOps Server 2022 及更高版本不支持 Reporting。 本节中显示的图像参考Azure DevOps Server 2019，但是，除非另有说明，否则配置的信息相同。

  1. 在 “欢迎 ”页中，选择选项，然后选择“ 下一步”。

  2. 在 “新建部署 ”页中，选择部署类型，然后选择“ 下一步”。

  3. 在下一页上，选择“ 新建部署 - 高级”，然后选择“ 下一步”。

    “服务器配置向导”的屏幕截图，“新建部署 - 高级”页，2022。

    “新建部署”和“高级”选择的屏幕截图。

  4. 在 “语言 ”页面中，选择首选 “语言 ”选项，然后选择“ 下一步”。

    “高级”的屏幕截图，选择“语言，任何版本”。

  5. 在“数据库”页中，指定已设置用于 Azure DevOps Server 的 SQL Server 实例。 然后，选择“下一步”。

    “高级”的屏幕截图，选择“数据库”。

  6. 在“ 帐户 ”页中，指定要使用的服务帐户。

    “高级”的屏幕截图，选择“帐户”。

  7. 从 “应用程序层 ”页中，选择要使用的网站设置（包括是使用 HTTP 绑定还是 HTTPS 绑定），然后选择“ 下一步”。 有关详细信息，请参阅 网站设置。

    “高级选择”“应用程序层”页的屏幕截图。

  8. 在“搜索”页中，选择是安装和配置搜索功能，还是使用现有的搜索服务。 安装和配置搜索支持代码、工作项和 Wiki 搜索功能。 有关详细信息，请参阅 配置搜索。 选择“下一步”。

    “高级、搜索”页的屏幕截图。

  1. 如果不打算使用 SQL Server Reporting Services或尚未安装SQL Server Analysis Services和SQL Server Reporting Services，请在“报告”页上取消选中“配置报告”复选框。 否则，请选中该框，然后选择“ 下一步”。

    “高级”的屏幕截图，选择“报告”。

  2. Reporting Services。 输入安装SQL Server Reporting Services的服务器的名称。 然后，选择“ 填充 URL”。 选择“下一步”。

    高级、Reporting Services的屏幕截图

  3. Analysis Services。 输入安装SQL Server Reporting Services的服务器的名称，然后选择“测试”。 选择“下一步”。

    高级 Analysis Services 的屏幕截图

  4. 报表读取者帐户。 输入为报告设置的服务帐户的凭据，然后选择“ 测试”。 选择“下一步”。

    高级报表读取者帐户的屏幕截图

  1. 在 “项目集合 ”页中，将 “创建新团队项目集合 ”复选框保留选中状态。 必须至少有一个项目集合才能在其中定义项目。 将项目名称保留为 “DefaultCollection”，或为其指定新名称和说明（可选）。

    “高级项目集合”页的屏幕截图。

    注意

    创建项目集合以使用“继承的进程模型”，该模型支持通过 Web 门户进行自定义。 可以根据需要创建其他项目集合，以便稍后支持本地 XML 进程模型。 请参阅 管理项目集合。 若要详细了解继承进程模型，请参阅 关于进程自定义和继承的进程。

    注意

    定义报告服务后，创建的项目集合将支持用于自定义工作跟踪的本地 XML 过程模型。 若要创建使用继承过程模型的集合，需要添加未配置 Reporting Services 的项目集合。 请参阅 管理项目集合。 若要详细了解继承进程模型，请参阅 关于进程自定义和继承的进程。

  2. 在“ 审阅 ”页中，查看所选内容，然后选择“ 验证”，向导将运行就绪情况检查来验证环境和设置选择。 如果成功，可以配置部署。 否则，请修复任何错误并重新运行就绪情况检查。

    “高级”、“审阅”的屏幕截图。

  3. 在 “就绪情况检查 ”页中，系统会执行最终阶段以确保配置设置有效。 通过所有检查后，即可完成配置。 选择 “配置”。

    提示

    可以通过在左窗格中选择“ 上一页 ”或“页面名称”返回到上一页。 如果更改配置设置，则需要通过选择 “单击此处重新运行就绪情况检查”来验证设置。

    高级就绪情况检查的屏幕截图。

  4. 向导会转到 “配置” 页，并开始配置每项功能并显示进度。 此步骤可能需要几分钟。 如果所有配置都成功，则会收到以下成功消息。 选择“下一页”。

    “高级”“配置”页的屏幕截图。

  5. 在 “完成 ”页中，查看配置结果。 查看配置结果，然后选择 “复制完整路径” ，将链接复制到配置日志文件。 选择Azure DevOps Server URL 链接以连接到已配置服务器的 Web 门户。

    在此示例中，链接为 /http:aaronha001/。

    “高级配置”“完成”页的屏幕截图。

创建一个项目

Web 门户将打开“ 创建项目 ”页。

  1. 提供项目名称和可选说明。 项目名称不能包含空格或特殊字符 (，如 / ： \ ~ & % ;@ ' “？ <> |# $ * } { ， + = [ ]) ，不能以下划线开头，不能以句点开头或结尾，并且必须为 64 个字符或更少。

    默认设置为版本控制配置 Git 存储库，并为工作跟踪配置敏捷过程。 若要选择不同的选项，请展开“ 高级”。

    Web 门户“创建项目”对话框的屏幕截图。

    有关版本控制选项的比较，请参阅 为项目选择正确的版本控件。 有关工作跟踪过程的评审，请参阅 选择流程。

  2. 创建项目后，将显示项目摘要页。 若要了解详细信息，请参阅 共享项目任务，查看项目活动。

后续步骤

对于管理员：

以管理员身份开始使用

对于开发人员：

开始使用 Git跟踪工作或代码