今天在 Jenkins 中 Kickstart PowerShell：是件好事吗？

如果您管理 Windows 服务器已有一段时间，那么您无疑拥有大量 PowerShell 脚本来执行您定期执行的那些平凡但必要的任务，例如重置密码、收集日志数据或归档备份文件。您知道 Jenkins 中的 PowerShell 很重要吗？

您可能有定期运行的脚本，甚至可能设置任务计划程序事件以尝试自动执行 PowerShell 脚本。

有一个更好的办法。

在本文中，您将学习如何在 Windows 上安装 Jenkins 并运行简单的 PowerShell 脚本。您将学习如何安装 Jenkins、设置基本安全性、启用 PowerShell 插件以及运行作业来创建一个带有我们将输入的参数的简单文本文件。

本文旨在对 Jenkins 进行基本介绍。您将学习的配置不一定适用于生产环境。

先决条件

本文的大部分内容将是演练。如果您打算继续，请确保您具备一些先决条件。

运行 Jenkins 的要求非常低，任何现代计算机都可以做到。本文中的示例将全部基于 Jenkins 运行于：

• Windows 10 企业版 v.1903
• PowerShell 核心 v6

尽管 Jenkins 几乎可以在任何平台上运行，但为了简单起见，我将重点关注 Windows 10 企业版。

安装詹金斯

满足先决条件后，让我们安装 Jenkins。

安装 Jenkins 非常简单且直接。导航到 https://www.jenkins.io/download/ 并下载长期支持 (LTS) 版本。有两个版本可用：LTS 版本和“Weekly”版本。 “每周”版本会定期更新，并且可能不稳定。在本文中，我们使用 LTS 版本。这是最稳定的版本。

正如您从下面的屏幕截图中看到的，有多个选项可供选择。选择 Windows 版本开始下载。

下载安装程序后，解压 zip 存档并运行安装程序并接受所有默认设置。安装很简单。

安装完成后，Jenkins 将打开浏览器并显示“入门”页面。此页面有初始管理员密码，用于解锁 Jenkins 以继续配置。您可以在下面看到 Jenkins 告诉我读取位于 C:\Program Files (x86)\Jenkins\secrets\initialAdminPassword 的文本文件。

导航到显示的文件，将其打开，复制显示的密码并将其用作入门页面上的管理员密码。

安装插件

第一次登录后，Jenkins将完成最终设置，然后询问要安装哪些插件。正如您在下面的屏幕截图中看到的，有几个选择。

选择安装建议的插件将根据最常见的使用场景安装推荐的插件集。其中包括身份验证提供程序插件、GitHub 交互和 Java 扩展。 选择要安装的插件允许您从所有可用插件列表中仅安装所需的插件。

突出显示安装建议的插件并单击确定。这个过程将需要几分钟来安装初始插件，所以现在是给自己喝杯咖啡的好时机。

创建管理员用户

安装插件后，下一步就是创建我们的第一个用户。第一个用户是 Jenkins 的管理员，将拥有全局权限，就像 Windows Server 的企业管理员一样。您可以在下面看到“创建第一个管理员用户”页面的外观。

从现在起，Jenkins 界面只能通过输入有效的用户名和密码来访问。

设置 Jenkins 管理 URL

最后一步是设置 Jenkins 服务运行的 URL。此 URL 是用于管理 Jenkins 程序的界面，理想情况下应设置为完全限定域名 (FQDN)。将其设置为 FQDN 将允许远程访问，就像访问网站一样。对于本文并为了简单起见，请接受默认 URL。

设置安全性

安装完成后，让我们配置身份验证。如果主仪表板尚未打开，请导航至主仪表板。在主仪表板中，单击“管理 Jenkins”，然后单击“配置全局安全性”以打开安全设置，如下所示。

在“配置全局安全性”页面中，您将看到一些可供选择的选项。在本文中，我们将使用 Jenkins 自己的用户数据库来使事情变得简单。取消选中“允许用户注册”也是一个好主意，如下所示。选中它后，任何用户都可以创建帐户并授予自己对 Jenkins 的访问权限。 .

查看下面的屏幕截图，还有其他身份验证选项。

• 委托给 servlet 容器 - 如果您已经使用 Jenkins 设置了 Docker 容器并允许通过容器进行身份验证，则可以使用此选项。
• LDAP - 当您已经拥有要用于身份验证的 Active Directory 时使用此选项

接下来，选择登录用户可以执行任何操作选项。在这种模式下，每个登录用户都可以完全控制 Jenkins。这对于生产来说可能不是一个好主意，因为这允许任何用户更改设置。

在 Jenkins 插件中启用 PowerShell

完成基本的安全设置后，就可以在 Jenkins 插件中配置 PowerShell 了。要安装 PowerShell 插件，请导航到主仪表板，单击“管理 Jenkins”，然后单击“管理插件”，如下所示。

有数百个插件，因此找到 PowerShell 插件的最佳方法是搜索它。在过滤栏中，输入“PowerShell”并从列表中选择它。检查 bo，如下所示，以启用它。这将允许 Jenkins 直接将 PowerShell 命令和脚本直接写入 Jenkins 内的文本框中，并允许 Jenkins 调用 PowerShell，而无需启动单独的 PowerShell 控制台。

您可以在下面看到这可能是什么样子。

启用插件后，Jenkins 就可以运行 PowerShell 作业了。

在 Jenkins 作业中创建 PowerShell

Jenkins插件中PowerShell的安装完成。有趣的事情来了。让我们创造一份工作。

在 Jenkins 中，工作被定义为一系列要完成的任务。一个常见的场景是当开发人员签入代码时开始编译程序的作业。与 Windows 服务器中的任务管理器非常相似。

我们要设置的工作是检查 c:\temp 目录，并在该目录中插入一个带有自定义消息的文本文件。

Jenkins 有不同的项目类型，有时称为管道，专注于特定目标。不同类型的项目将有不同的设置、选项和参数，具体取决于您选择的项目类型。您可以在 Jenkins 站点上找到有关项目类型以及何时使用它们的更多信息。

在主仪表板中，单击新建项目。对于作业名称，请输入创建文本文件。这是任意的，但最好给它贴上有意义的标签。

在本文中，我们将使用Freestyle 项目。这为我们创造就业机会提供了最大的灵活性。突出显示Freestyle 项目并滚动到底部，然后单击确定。

这项工作将是一个参数化项目。这意味着我们可以提示用户输入，并且输入将传递给作业。例如，假设我们在 Jenkins 作业中有一个 PowerShell 作业，它将日志文件复制到特定目录。我们可以向作业添加一个提示，当我们运行作业时，它将要求提供要包含在构建中的文件名。

从下拉列表中检查此项目是参数化项。单击添加参数下拉列表并选择字符串参数。字符串参数是您输入要包含在文本文件中的消息的位置。

然后添加第二个选择参数。它应该类似于下面的屏幕截图。此选项将为用户提供从下拉列表中选择项目的选项。

作业设置现在应该类似于下面的屏幕截图。

向下滚动到“构建”部分。单击小箭头并选择 Windows PowerShell。这让 Jenkins 知道我们正在运行 PowerShell 脚本。这也是我们输入 PowerShell 脚本的地方。这项工作现已准备就绪。单击“保存”。

对于 Jenkins 作业中的 PowerShell 示例脚本，我们在临时目录中创建一个文件并添加一条简单的消息。

这是一个简单的脚本，它将在根目录下创建临时目录（如果尚不存在），并在该目录中创建一个文本文件。

# Create Temp Directory
if (-not(Test-Path -Path 'C:\temp'))
{
    New-Item -Path 'C:\temp' -ItemType directory
}

# Using the environment variables exposed by the Jenkins job 
Set-Content -Path "C:\temp$($env:Filename).txt" -Value $env:Message

提示：先在 VSCode 或其他编辑器中编写脚本，然后将其粘贴到框中。

在 Jenkins 作业中运行 PowerShell

最后，您已准备好运行您的第一份工作。让我们回到主仪表板，您将看到主仪表板中列出的创建文本文件作业。见下文。

单击最右侧的时钟图标并调出工作表。

在消息框中，输入要插入到文本文件中的文本。并单击构建。构建完成后，单击控制台输出。控制台输出显示作业的状态以及作业运行是否成功。

现在剩下要做的就是打开文件管理器并查看该文件。导航到临时目录并打开文本文件。它将具有与您在构建消息框中输入的文本相同的文本。

概括

您现在对 Jenkins 中的 PowerShell 有了基本的了解。它是一个功能强大的工具，可用于管理您的 PowerShell 脚本并自动化所有操作！