管道示例:释放到边缘节点

开始之前

在尝试这个快速入门之前，请确保您具备:

• 一个GitHub账户。这是派生示例存储库所必需的。
• 一个JFrog平台帐户。
• 将Artifactory设置为Docker注册表。有关更多信息，请参见开始使用Artifactory作为Docker注册表而且码头工人注册表．
• 安装和配置JFrog发行版。
• 生成、上传和部署GPG密钥用于JFrog Distribution。
• 至少有一个“Pipelines”节点池。这是所有管道步骤将在其中执行的节点集。有关更多信息，请参见管理管路节点池．
• 成功运行Docker构建和推送管道。

运行这个例子

执行以下步骤来运行这个管道:

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

2. 添加集成

   1. 去应用|管道|集成来添加这些集成：

      • GitHub集成:此集成用于添加Pipeline源。
        myGithub是本例中使用的GitHub集成的名称。
      • 分布的集成：这个集成将您的JFrog Pipeline Automation平台连接到一个分发实例。
        myDist是本示例中使用的分发集成的名称。
      • Artifactory集成:此集成用于与Artifactory进行身份验证，以获得包括Docker映像在内的工件，并维护构建信息。
        myArtifactory是本例中使用的Artifactory集成的名称。
   2. 写下Artifactory和Distribution集成的名称，因为它们是下一个步骤．确保名字是唯一的，容易记住。
      
      

3. Fork GitHub仓库
   

   本例的管线DSL可在jfrog-pipelines-cd-sample存储库中的JFrogGitHub帐户。

   DSL文件是一个包含管道定义的yaml文件。这个例子使用了两个YAML文件，pipelines.yml而且values.yml．管道。Yml文件包含所有资源和工作流步骤的声明。2022世界杯阿根廷预选赛赛程的values.yml文件属性所需的值pipelines.yml文件。有关yml文件中使用的所有资源、管道和步骤的完整分解，请参见2022世界杯阿根廷预选赛赛程pipelines.yml下面的部分。

   Fork这个存储库到您的帐户或组织。这很重要，因为您需要对作为Pipeline Sources或GitRepo资源使用的存储库进行管理访问，这是向这些存储库添加webhook并侦听更改事件所必需的。2022世界杯阿根廷预选赛赛程
   
   

4. 更新values.yml
   

   管道配置可在values.yml文件。如有需要，eDit这个文件在本次回购的fork中，替换以下内容:
   
   

   标签	描述	例子
   gitProvider	提供在上一步中添加的Github集成的名称。	gitProvider: myGithub
   sourceArtifactory	提供你的Artifactory集成。	sourceArtifactory: myArtifactory
   sourceDistribution	提供您的发行版集成。	sourceDistribution:myDist

   JFrog管道中的所有管道名称都是全局的．你的管道和资源的名称在JFrog管道中必须是唯一的。2022世界杯阿根廷预选赛赛程

5. 添加管道源

   的管道来源代表存储管道定义文件的Git repo。管道源通过控件连接到存储库集成，这是在上一步中添加的。
   
   

   1. 在左侧导航栏中，转到管理|管道|管道源．点击添加管道源然后选择从YAML．遵照指示添加管道源．
      

   2. 管道源同步成功后，导航到管道|我的管道在左侧导航栏可以看到新添加的管道。在这个例子中，cd_demo_release_mgmt是我们管道的名称。

   3. 单击管道的名称。这将呈现管道及其最新运行结果的实时交互式图表。

      
      
      

6. 执行管道

   您现在可以承诺回购到触发管道，或手动触发管道通过UI。管道中的步骤按顺序执行。如果节点池有多个可用的构建节点，则可以并行执行多个步骤。
   
   

pipelines.yml

的pipelines.yml文件由资源、管道和步骤组成，如下图所示2022世界杯阿根廷预选赛赛程:

2022世界杯阿根廷预选赛赛程

本例使用以下类型的2022世界杯阿根廷预选赛赛程：

• BuildInfo
• ReleaseBundle
• DistributionRule

BuildInfo

一个BuildInforesource是与Artifactory中的构建相关联的元数据。

JFrog管道自动创建BuildInfo时，任何构建步骤，如MvnBuild，NpmBuild，GradleBuild,或DockerBuild用于生成包。BuildInfo通过PublishBuildInfo步骤，通过在构建步骤中设置标志或在步骤中提供该资源，如NpmPublish，GoPublishModule，GoPublishBinary,DockerPush．

#构建到bundle的构建信息-名称:gosvc_promoted_build_info类型:BuildInfo配置:sourceArtifactory: {{. values。artfactoryintegration}} buildName: dbp_build buildNumber: 1

ReleaseBundle

一个ReleaseBundle资源指定Artifactory中的一组工件，这些工件作为a分布到Artifactory Edge节点JFrog分发发布包．

此资源可用于CreateReleaseBundle或DistributeReleaseBundle．此资源可用于表示两者签署和未签署的发布包．

—name: release_bundle type: ReleaseBundle configuration: sourceDistribution: {{. values。distributionIntegration}}名称:demo_rb版本:v1.0.0- name: signed_bundle type: ReleaseBundle configuration: sourceDistribution: {{ .Values.distributionIntegration }} name: demo_rb version: v1.0.0

DistributionRule

一个DistributionRuleresource是可以应用到的目标规则的集合分发发布包使用JFrog分发。

—name: distribution_rules type: DistributionRule配置:sourceDistribution: {{. values。distributionIntegration}} serviceName: "*" siteName: "*" cityName: "*" countryCodes: - "*"

管道

cd_demo_release_mgmt，用于签署发布包并将其发布到Artifactory边缘节点的管道定义。

步骤

的cd_demo_release_mgmt管道由以下本机组成步骤：

• CreateReleaseBundle
• SignReleaseBundle
• DistributeReleaseBundle

CreateReleaseBundle

的CreateReleaseBundle本机步骤生成发布包用于分发给Artifactory边缘节点．该步骤可用于创建已签名或未签名发布包。

- name: bundle type: CreateReleaseBundle configuration: releaseBundleName: demo_rb releaseBundleVersion: v1.0。${run_number} dryRun: false sign: false description: "some random test description" input2022世界杯阿根廷预选赛赛程Resources: - name: gosvc_promoted_build_info trigger: false outputResources: - name: release_bundle releaseNotes: syntax: markdown content: | ##标题*项目*要点

SignReleaseBundle

的SignReleaseBundle本机步骤签署一个发布包，准备将其分发到边缘节点。

—name: sign type: SignReleaseBundle configuration: inputR2022世界杯阿根廷预选赛赛程esources:—name: release_bundle outputResources:—name: signed_bundle

DistributeReleaseBundle

的DistributeReleaseBundle本机步骤触发的分布发布包到一个Artifactory边缘节点．此步骤需要一个已签名的发布包和一个或多个分发规则才能成功执行．

—name:分发类型:DistributeReleaseBundle配置:dryRun: false inputResources:—name: signed_bun2022世界杯阿根廷预选赛赛程dle—name: distribution_rules