在快速入门中,管道的成功运行是这样的:
教程视频
开始之前
在尝试这种快速开始之前,确保你已经:
- 一个GitHub账户。这是分叉示例存储库所必需的。
- 一个JFrog平台帐户,或自托管JFrog管道.
- Artifactory中的用户帐户,拥有对至少一个二进制存储库的部署权限。
- 创建一个本地Docker存储库将Artifactory设立为码头工人注册表.
- 至少有一个节点池。这是所有管道步骤将在其中执行的节点集。有关更多信息,请参见管理管道节点池.
运行此示例
执行以下步骤来构建和推送Docker映像:
分叉存储库
此示例的pipes DSL可在jfrog-pipelines-docker-sample存储库中的JFrogGitHub帐户。
DSL文件是一个包含管道定义的yaml文件。这个例子使用了一个YAML文件,
pipelines.yml
.该文件包含所有资源和工作流步骤的声明。2022世界杯阿根廷预选赛赛程有关yml文件中使用的所有资源、管道和步骤的完整分解,请参见2022世界杯阿根廷预选赛赛程pipelines.yml下面的部分。分叉这个存储库到你的账户或组织。这一点很重要,因为您需要管理访问被用作Pipeline Sources或GitRepo资源的存储库,以便向这些存储库添加web钩子并侦听更改事件。2022世界杯阿根廷预选赛赛程
登录到Artifactory
用Artifactory证书登录JFrog平台。添加集成
a.访问政府|管道|集成来添加两个集成:
- GitHub集成:此集成用于添加Pipeline源,以及定义在pipelines.yml.
- Artifactory集成:此集成用于与Artifactory进行身份验证,以将Docker映像推送到
docker-local
仓库在Artifactory。
b.写下GitHub和Artifactory集成的名称,因为它们是用于下一个步骤.确保名字是唯一的,容易记住。
更新管道。yml文件
管道配置可在pipelines.yml文件。编辑此文件在你的Git回购的分叉中,并替换以下内容:
标签 描述 例子 gitProvider
提供您在上一步中添加的Github集成的名称。 gitProvider: my_github
路径
提供到此存储库分支的路径。 路径:myuser / repo-name
注册表
提供您在上一步中添加的Artifactory集成的名称。 注册中心:艺术
imageName
提供Docker映像路径和名称。 docker.artprod.mycompany.com
/ docker_local /菲律宾
在那里,docker.artprod.mycompany.com/ docker_local
图像路径和菲律宾
是图像名称。sourceArtifactory
提供你的Artifactory集成。 sourceArtifactory:艺术
所有管道定义都是全局的JFrog管道在一个项目中。管道和资源的名称必须是唯一的2022世界杯阿根廷预选赛赛程项目在JFrog管道。
添加管道源
的管道来源代表Git repo,其中存储了我们的pipeline定义文件。管道源通过连接到存储库集成,这是我们在上一步中添加的。
按照说明添加一个管道源把它指向
pipelines.yml
在你回购的分支里。这将自动将您的配置添加到平台,并基于您的YAML创建一个管道。的管道
.yml
解析文件,并按照配置添加资源、步骤和管2022世界杯阿根廷预选赛赛程道。管道源成功同步后,导航到管道|我的管道在左侧导航栏中查看新添加的管道。在这个例子中,
pipeline_dbp
是我们管道的名字。单击管道的名称。这呈现管道及其最新运行结果的实时、交互式图表。
执行管道
您可以通过向Git存储库提交更改来触发管道,或者通过UI手动触发管道。管道中的步骤按顺序执行。如果节点池有多个可用的构建节点,则可以并行执行多个步骤。
一旦管道完成,就会列出一个新的运行。
pipelines.yml
的pipelines.yml
文件由资源、管道和步骤组成,如下图所示2022世界杯阿根廷预选赛赛程:
2022世界杯阿根廷预选赛赛程
的类型2022世界杯阿根廷预选赛赛程:
GitRepo
一个GitRepo资源用于将JFrog pipeline连接到源代码控制存储库。添加它将创建一个webhook到repo中,以便将来的提交将自动创建一个带有webhook有效负载的新版本。
- name: dbp_repo type: GitRepo configuration: gitProvider: my_github # <——replace with your integration path: jfrog/jfrog- pipelservers -docker-sample # <——replace with your repository name: branch: include: master
标签 |
描述 |
必需的/可选 |
---|---|---|
的名字 |
这个名称用于引用步骤中的资源,并且必须在JFrog pipeline环境中的所有存储库中唯一。 |
要求 |
|
的名称GitHub集成. | 要求 |
路径 |
从集成根目录到存储库的路径。 | 要求 |
分支机构 |
的 |
可选 |
图像
一个图像resource用于将Docker映像的引用添加到管道中。Image资源可以同时用作输入和输出。像DockerBuild这样的步骤将生成它作为输出,而像DockerPublish这样的步骤将使用它作为输入发布到Docker注册中心。在我们的例子中,它被用作DockerPush的outputResource的一步。
- name: dbp_image type: Image configuration: registry: art# <——replace with your artifactory integration sourceRepository: docker_local # <——如果registry是artifactory imageName: docker.artprod.mycompany.com/docker_local/dbp # <——replace with your Image path and name imageTag: latest autoPull: true
标签 |
描述 |
必需的/可选 |
---|---|---|
的名字 |
dbp_image 是名字吗?它标识资源。 |
要求 |
注册表 |
艺术 名字是什么Docker注册表集成. |
要求 |
sourceRepository |
docker_local 是Artifactory中图像将发布到的存储库的名称。 |
如果注册表在JFrog Artifactory中,则需要 |
imageName |
Docker映像的文件路径,格式为imageRepo/imageName。 | 要求 |
imageTag |
Docker映像的初始版本的版本标记。 | 要求 |
autoPull |
当真正的,图像会自动拉到运行该步骤的机器上。 默认为假. |
可选 |
BuildInfo
BuildInfo时自动创建DockerBuild步骤用于生成包。然后将BuildInfo发布到已配置的Artifactory repo (sourceArtifactory:艺术
)透过PublishBuildInfo步骤中提供该资源DockerPush的一步。
—name: dbp_build_info type: BuildInfo configuration: sourceArtifactory: art buildName: dbp_build buildNumber: 1—name: dbp_promoted_build_info type: BuildInfo configuration: sourceArtifactory: art buildName: dbp_build buildNumber: 1
标签 |
描述 |
必需的/可选 |
---|---|---|
的名字 |
这个名称用于引用步骤中的资源,并且必须在JFrog pipeline环境中的所有存储库中唯一。 |
要求 |
|
|
要求 |
buildName |
|
可选 |
buildNumber | 要与BuildInfo关联的构建的编号。 | 可选 |
管道
pipeline_dbp
即构建和推送Docker映像的管道定义。
步骤
的pipeline_dbp
管道包含以下内容本机的步骤:
DockerBuild
的DockerBuild原生步骤执行构建,从Git源存储库中的Dockerfile生成Docker映像。
该步骤从文件构建Docker映像GitRepo源存储库资源。的名称和目录必须在步骤配置中提供Dockerfile控件要处理的命令码头工人建造
命令,以及结果图像的名称和标记。映像在构建节点上构建,关于该映像的信息存储在运行状态中。
—name: docker_build type: DockerBuild configuration: affinityGroup: dbp_group dockerFileLocation:。dockerFileName: Dockerfile dockerImageName: docker.artprod.mycompany.com/docker_local/dbp #替换为您的映像路径和名称dockerImageTag: ${run_number} inputResources: - name: dbp_repo2022世界杯阿根廷预选赛赛程 integrations: - name: art # <——替换为您的artifactory集成
标签 |
用途说明 |
必需的/可选 |
---|---|---|
的名字 |
这是当步骤被分配为下一步的输入时使用的名称, |
要求 |
affinityGroup |
必须指定与后面指定的相同的亲和性组字符串DockerPush的一步。 这两个DockerBuild而且DockerPush步骤被分配给dbp_groupaffinityGroup所以它们有相同的状态.如果不是,DockerBuild步骤的输出将不能用于DockerPush步骤。 |
可选 |
dockerFileLocation |
包含Dockerfile的目录或具有Docker构建配置的文件 | 要求 |
dockerFileName |
Dockerfile的名称 | 要求 |
dockerImageName |
要创建的Docker映像的名称。这可以使用环境变量设置,也可以使用参数触发运行。 |
要求 |
dockerImageTag |
要创建的Docker映像的标记。这可以使用环境变量设置,也可以使用参数触发运行。 在我们的例子中,图像的标记被设置为管道的运行号,这是当前正在执行的运行的编号。 |
要求 |
input2022世界杯阿根廷预选赛赛程Resources |
必须指定:
该步骤接受' dbp_repo '作为inputResource基于提供的Dockerfile构建映像。 可选地,也可以指定: |
必需的/可选 |
集成 |
必须指定Artifactory集成. | 要求 |
DockerPush
的DockerPushnative step将指定的Docker Image推送到Artifactory。
- name: docker_push type: DockerPush configuration: affinityGroup: dbp_group targetRepository: docker-local integrations: - name: art # <——replace with your artifactory integration inputSteps: - name: docker_build outputR2022世界杯阿根廷预选赛赛程esources: - name: dbp_image
标签 |
用途说明 |
必需的/可选 |
---|---|---|
的名字 | docker_push 是标识步骤的名称。 |
要求 |
affinityGroup |
必须指定与前一个DockerBuild的一步。 | 可选 |
targetRepository |
Artifactory中Docker存储库的名称。 | 要求 |
集成 |
必须指定Artifactory集成. | 要求 |
inputSteps |
必须指定命名DockerBuild进入同一个亲和组。 的输出(结果) |
要求 |
output2022世界杯阿根廷预选赛赛程Resources |
可指定图像资源。如果指定了一个 此步骤将' dbp_image '输出为outputResource,如果需要,可用于触发下游依赖的步骤或管道。 |
可选 可能需要 |
PublishBuildInfo
的PublishBuildInfo一步发布BuildInfo附上图片给Artifactory。BuildInfo为构建提供了一个清单,包括关于模块、依赖项和其他环境变量的元数据。
BuildInfo也可以通过任何特定于语言的发布步骤发布,当它autoPublishBuildInfo
Tag设置为true。
—name: publish_dbp_build type: PublishBuildInfo configuration: inputSteps:—name: docker_push outputRes2022世界杯阿根廷预选赛赛程ources:—name: dbp_build_info
标签 |
用途说明 |
必需的/可选 |
---|---|---|
的名字 | publish_dbp_build 是名字吗?它确定了步骤。 |
要求 |
inputSteps |
必须指定DockerPush的一步。上一步的输出(结果)被用作这一步的inputStep。 这一步必须不已经建立 |
要求 |
output2022世界杯阿根廷预选赛赛程Resources |
必须指定BuildInfo要发布的资源。 |
要求 |
PromoteBuild
的PromoteBuild原生步骤促进thedbp_build_infoBuildInfo,并将相关构件从一个Artifactory存储库移动或复制到另一个Artifactory存储库。
此步骤需要一个PublishBuildInfo步骤与上一个步骤或BuildInfo资源作为成功执行的输入。
—name: promote_dbp_build type: PromoteBuild configuration: targetRepository: demo-pipeline integration:—name: art inputResou2022世界杯阿根廷预选赛赛程rces:—name: dbp_build_info outputResources:—name: dbp_promoted_build_info
标签 |
用途说明 |
必需的/可选 |
---|---|---|
的名字 | promote_dbp_build 是标识步骤的名称。 |
要求 |
targetRepository | demo-pipelines 是t在Artifactory中推广构建到的存储库的名称。 |
要求 |
集成 |
必须指定Artifactory集成. | 要求 |
input2022世界杯阿根廷预选赛赛程Resources |
必须指定命名的BuildInfo资源的buildName 而且buildNumber 属性标识要推广的构建. |
要求 |
output2022世界杯阿根廷预选赛赛程Resources |
必须指定命名的BuildInfo要映射到升级构建的资源。的BuildInfo将被更新buildName 而且buildNumber 的输入BuildInfo资源,及其targetRepo 的价值targetRepository . |
要求 |