管道示例:Maven构建

在本快速入门中，管道的成功运行是这样的:

---

开始之前

在尝试这个例子之前，请确保您具备:

• 一个GitHub账户。这是派生示例存储库所必需的。
• 一个JFrog平台账户，或自托管JFrog管道．

• 至少一个节点池。这是所有管道步骤将在其中执行的节点集。有关更多信息，请参见管理管路节点池．

  如果您有云帐户，则节点池将作为订阅的一部分可用。

---

运行这个例子

执行以下步骤构建Maven工件:

1. Fork存储库

   该管道示例可在jfrog-pipelines-maven-sample存储库中的JFrogGitHub帐户。配置包含在存储库根目录下的YAML文件中:
   • pipelines.yml，其中包含运行管道所需的所有资源和步骤的声明。2022世界杯阿根廷预选赛赛程该配置是以模板格式编写的，因此不需要更改该文件中的任何内容。
   • 值。Yml，其中包含将被填充到模板中以创建管道的自定义值
   有关yml文件中使用的所有资源、管道和步骤的完整分解，请参见2022世界杯阿根廷预选赛赛程管道的定义下面的部分。Fork这个存储库到您的帐户或组织。这很重要，因为您需要管理访问存储库，使用在您的管道，使我们能够添加webhook到这些存储库和监听更改事件。
   
   

2. 登录到Artifactory

   用您的Artifactory证书登录JFrog平台。
   
   

3. 创建本地Maven存储库

   创建一个本地Maven存储库和w记下存储库名称，因为您将需要在管道配置中使用它。
   
   

4. 添加集成

   a.转至政府|管道|集成来添加两个积分：
   • GitHub集成:此集成用于添加Pipeline源，以及GitRepo资源。
   • Artifactory集成：此集成用于与Artifactory进行身份验证，从Artifactory下载Maven依赖项，并将构建的包打包并上载到Artifactory。
   b.写下GitHub和Artifactory集成的名称，因为这些是下一个步骤．确保名字是唯一的，容易记住。
   
   

5. 更新pipeline定义

   因为你的管道。Yml配置文件模板化，如下表所示，更新值。Yml在你的分叉库:
   

   标签	描述	例子
   gitProvider	提供您添加的Github集成的名称步骤4．	gitProvider: my_github
   repoPath	提供这个存储库的分支的路径。	repoPath: myuser / jfrog-pipelines-maven-sample
   artifactory	提供您在前面添加的Artifactory集成的名称步骤4．	artifactory: demoArt
   deployerRepo	提供您在其中创建的Artifactory中的本地Maven存储库的名称步骤3．	deployerRepo: maven-local

   就是这样。您的配置已经准备好了!

   所有管道定义都是全局的JFrog管道在一个项目中。管道和资源的名称在内部必须是唯一的2022世界杯阿根廷预选赛赛程项目位于JFrog管道。

6. 添加管道源

   管道源表示存储管道定义文件的git存储库。管道源通过控件连接到存储库集成，这是我们添加进去的步骤4．
   1. 在左侧导航栏中，转到管理|管道|管道源．点击添加管道源然后选择从YAML．遵照指示添加管道源．这将自动将您的配置添加到平台，并根据您的YAML创建管道。
      
   2. 管道源同步成功后，导航到管道，我的管道在左侧导航栏查看新添加的管道。在这个例子中，demo_maven是管道的名称。
      
      
      
   3. 单击管道的名称。这呈现管道及其最新运行结果的实时交互式图表。
      
      

7. 执行管道

   您可以通过向存储库提交更改来触发管道，也可以通过UI手动触发管道。如果节点池有多个可用的构建节点，则可以并行执行多个步骤。
   
   

   
   一旦管道，一个新的运行被列出:
   

---

管道定义如何工作

现在让我们看一下管道定义文件以及每个部分的含义。

的pipelines.yml文件包含管道的模板化定义。这包括以下内容:

• 2022世界杯阿根廷预选赛赛程资源是包含由管道步骤消耗或生成的信息的实体。在我们的例子中，我们使用了以下资源:2022世界杯阿根廷预选赛赛程
  • 一个GitRepo资源指向当前应用程序代码所在的源代码控制存储库。您可以配置此资源来触发特定事件的相关步骤。有关更多信息，请参见GitRepo．
  • 一个BuildInfo资源是一个指向Build on Artifactory的指针。这是由PublishBuildInfo步骤自动创建的。有关更多信息，请参见BuildInfo．
• 步骤是构成管道的可执行单元。在我们的例子中，管道由以下步骤组成:
  • 一个MvnBuild构建Maven项目并可选地将其部署到Artifactory的本地步骤。此步骤是预先打包的步骤(即本机步骤)，可以通过简单的配置使用，而不需要自定义脚本。有关更多信息，请参见MvnBuild．
  • 一个PublishBuildInfostep是一个本地步骤，它收集构建元数据并将其推送到Artifactory。Artifactory build提供了一个清单，包括包含的模块、依赖项和其他环境变量的元数据。有关更多信息，请参见PublishBuildInfo．