配置脚本

使用脚本

脚本使用Groovy编程语言并在Git存储库的版本控制下进行管理。这允许您直接在Git提供程序的编辑器中编辑脚本，或者使用您喜欢使用的任何其他编辑器。一旦你的脚本被提交到你的Git存储库，任务控制使用你在下面指定的配置来访问它们Git集成并自动与您从Git存储库中所做的任何添加或删除同步。

artifactory('Art1'){localRepository("maven-local-dev") {packageType "maven" description "这是我的maven开发库"}}

脚本库

脚本在脚本库中进行管理，脚本库可以从管理模块下脚本|脚本库。将鼠标悬停在库中的项上，会显示一些图标，这些图标可以让您删除,编辑或运行脚本。脚本保存在MongoDB数据库中，只能由任务控制访问。如果您已经配置了Git集成，所有脚本将与指定的Git存储库同步。

运行脚本

运行脚本包括以下步骤:

• 选择-从列表中选择要运行的脚本
• 编辑-对脚本进行任何必要的编辑
• 提供输入-提供脚本所需的任何输入
• 排练-做一个演练脚本，以确保没有错误
• 执行-执行脚本

这些主要步骤将在下面的部分中更详细地描述。

选择要运行的脚本

有两种方法选择要运行的脚本:

1. 选择运行脚本从任务控制中心顶部丝带。这将显示脚本库中可用的脚本列表
   
   
   
   选择要运行的脚本并单击“下一步”。
2. 将鼠标悬停在脚本库中的脚本上，然后单击运行图标。

这两个操作都将引导您进入编辑脚本的下一步。

编辑脚本

的编辑脚本TAB允许您对脚本进行任何必要的更改，以满足当前运行的特定需求。

注意，您不能修改现有脚本的名称或描述。

点击“保存”保存您的更改。

单击“Next”转到添加用户输入的下一步。

输入用户输入

在这个步骤中，您可以提供正在运行的脚本所需的任何用户输入。

输入所需的用户输入，然后单击“Next”继续下一步，在演练中测试脚本。

预演

预演不执行脚本，但是让您知道在执行脚本时将对选定的服务和存储库实现哪些更改。要查看更改，请单击摘要行。

要做一个演练，接受脚本所做的更改，然后单击“运行”。

执行脚本

如果演练成功，可以单击运行新脚本实际执行脚本中的代码。注意，这一次，编程到脚本中的任何更改都将实际在相应的服务和存储库上执行。

成功执行后，任务控制将再次显示可供您运行的脚本列表。

在此过程中的任何步骤，您都可以通过单击“取消”或在执行步骤中单击“结束并关闭”来停止运行脚本的过程。

创建和编辑脚本

如上所述，脚本是用Groovy编写的。

有两种方法来创建和编辑脚本:

• 使用外部编辑器
• 使用脚本编辑器
  
  

使用脚本编辑器

要从任务控制中创建脚本，请选择添加新脚本在脚本库中。中，将鼠标悬停在脚本条目上时，选择“编辑”图标来编辑脚本脚本库．

在脚本编辑器中，您可以根据需要创建和/或编辑脚本。完成后，单击“Save”保存脚本。如果配置了Git存储库，任务控制将提交您的更改。

块模板

为了方便，Mission Control提供了配置块作为内置模板，您可以在创建或编辑脚本时使用。输入前几个字母，然后显示可用的模板CTRL +空格或Shift +空格显示自动完成选项。当您从列表中选择模板时，任务控制中心将把它与所选配置块的所有参数一起插入到您的脚本中。

示例1

下面的例子展示了如何插入一个Artifactory服务和本地存储库模板:

示例2

添加Xray服务模板示例如下:

使用外部编辑器

您可以使用任何外部编辑器创建或编辑脚本。中配置的Git存储库中提交了任何更改版本控制页面。

脚本元素

脚本由服务闭包、配置块和属性构造。脚本非常灵活，可以包含任意数量的服务闭包，每个服务闭包可以包含任意数量的配置块和属性。

有关可用的服务闭包、配置块和属性的完整列表和完整规范，请参阅配置DSL．

关闭服务

服务闭包定义脚本所作用的服务(Artifactory或Xray)。人工或x射线服务只能通过必须包含在服务闭包中的配置块来创建或修改。

配置块

配置块定义应在其封闭服务闭包中指定的服务上实现的参数或更改。

属性

属性用于配置配置块的相关参数。

例子

下面的简单示例脚本显示:

• 一个Artifactory闭包，它包含一个配置块，该配置块在名为“Art1”的Artifactory服务上创建一个名为“generic-local”的通用本地存储库。配置块包含一个属性，用于指定存储库的包类型
• 一个x射线闭包连接x射线服务调用“X1”到Artifactory服务“Art1”进行索引。

artifactory('Art1') {localRepository('generic-local') {packageType "generic"}} x射线('X1') {binaryManager('Art1')}

用户输入

静态配置脚本在某些情况下很有用。例如，当您想要创建具有预定义属性的属性集时。在其他情况下，您需要脚本更加动态。例如，在创建一个新的存储库时，您可能只希望在应用脚本时提供存储库名称。

为了创建更动态的配置脚本，任务控制配置DSL允许您在应用脚本时请求用户输入。

有两种方式来声明你想要获得用户输入:

1. 请求用户输入特定属性

   localRepository("my-repository") {description userInput(类型:"STRING"，值:"这是一个通用描述"，description: "请提供一个描述")}

   在本例中，我们要求用户为描述存储库的属性。
   

2. 将用户输入赋值给变量并使用该变量

   name = userInput (type: "STRING"， value: "This is a generic description"， description: "请提供一个存储库名称")localRepository(name){…｝

   的值在本例中名字变量在Groovy字符串中用于创建存储库名称。
   
   

   不要使用"def"

   注意不要在声明脚本的用户输入时使用“def”。defname = userInput…)．当使用def时，脚本将不能正常工作，因为它将引用用户输入对象，而不是用户输入的动态值

当应用带有用户输入的配置脚本时，任务控制将生成一个表单，提示您输入已定义的所有用户输入字段。应用脚本的用户需要提供输入字段，以便继续预演和执行脚本。

targetArtifactory = userInput(名称:“目标Artifactory”，类型:“Artifactory”，描述:“请提供您想要复制到的Artifactory实例”)Artifactory ('Local') {localRepository("maven-local"){复制{url "${targetArtifactory。url}/ home -local" username targetArtifactory.credentials.userName password targetArtifactory.credentials.password cronExp "0 0/9 14 * * ?" socketTimeoutMillis 15000}}}

def serviceArtifactory = services['Art1'] def serviceXray - services['X1']

localRepository("docker-local") {packageType "docker" description "我的本地docker注册表"}

artifactory('Art1'){localRepository("docker-local") {packageType "docker" description "我的本地docker注册表"}}

Which hartifactory = userInput (type: "ARTIFACTORY"， name: "哪个ARTIFACTORY"， description: "请指定要在哪个ARTIFACTORY服务上创建存储库")ARTIFACTORY (Which hartifactory .name){localRepository("docker-local") {packageType "docker" description "My local docker registry"}}