宝珠介绍
快速开始
CircleCI球体是开源的,参数化的可共享套餐可重复使用的配置元件,其中包括职位,命令和遗嘱执行人。使用球体,以减少配置的复杂性,并帮助您与您的软件集成与服务在许多项目快速,轻松地叠加。
发布时间球体可以在我们的发现宝珠注册或者你可以创作你自己的ORB。
使用宝珠的好处
宝珠提供了可以大大简化你的配置参数化配置元素。为了说明这一点,下面的示例示出了用于测试的Node.js应用的典型配置 - 限定了与所需要的步骤的作业用于测试应用 - 与使用测试
工作由提供circleci /节点
宝珠。随着球体,可以一次性编写一个参数化配置,并利用其在多个类似的项目。
版:2.1球体:节点:circleci/node@x.y#orb版本工作流程:test_my_app:职位:-节点/测试:版:<节点版本>
版:2.1职位:测试:搬运工人:-图片:CIMG /节点:<节点版本>AUTH:用户名:mydockerhub用户密码:$ DOCKERHUB_PASSWORD#背景/项目UI ENV-VAR参考脚步:-查看-restore_cache:按键:-节点DEPS-V1 - {{.Branch}} - {{校验 “包lock.json”}}-跑:名称:安装软件包命令:NPM词-save_cache:键:节点DEPS-V1 - {{.Branch}} - {{校验 “包lock.json”}}路径:-〜/ .npm-跑:名称:运行测试命令:NPM运行试验工作流程:test_my_app:职位:-测试
宝珠注册
该宝珠注册是所有已发布的球体的开放资料库。查找您的堆栈的天体或考虑制定和发布自己的ORB。
在注册表中的宝珠会出现三种不同的命名空间名称之一:
认证 | 书面和CircleCI团队测试 |
伙伴 | 撰稿我们的技术合作伙伴 |
社区 | 撰稿社区 |
注意:为了使用未经认证的球体,贵机构的管理员必须进行选择,以便在第三方未经ORB使用组织设置>安全为您的组织页。
每个ORB包含自己的描述和文档中的ORB注册表中列出。通常情况下,球体将有一组使用的例子让你开始。
如果你想贡献给现有的天体或文件ORB的存储库的问题,许多天体作者将包括git仓库链接。
识别宝珠
在ORB都由其金属块其中包含了命名空间和ORB名。命名空间是一个唯一的标识符指的是组织创作了一组的球体。ORB的名称之后,将BE的@
符号和语义版本串中,识别正在被使用的ORB的版本。
例如ORB蛞蝓:<命名空间> /
使用宝珠
在注册表中的每个ORB提供导入特定天体,其最新版本的样本代码片段。
下面的例子显示了如何导入一个球体到您的版本:2.1
配置文件。创建球体
键,然后由ORB名称密钥来参考您要导入哪些天体。那么对于ORB名称密钥值应该是奥布蛞蝓和版本。
版:2.1球体:ORB名:<命名空间> / @ 1.2.3
奥布已经导入到配置文件后,由ORB提供的元件可作为
。ORB元件可以在方法一样被使用可重复使用的配置元素。节点例如下面显示了如何使用一个ORB命令。
节点示例
节点ORB提供了一个命令,安装的程序包
,安装您的节点程序包,自动启用缓存,并通过使用参数提供额外的选项。要使用安装的程序包
命令,引用它在工作的脚步。
版:2.1球体:节点:circleci/node@x.y#orb版本职位:测试:搬运工人:-图片:CIMG /节点:<节点版本>AUTH:用户名:mydockerhub用户密码:$ DOCKERHUB_PASSWORD#背景/项目UI ENV-VAR参考脚步:-查看-节点/安装的程序包#利用在步骤命令
也可以看看
- 请参阅宝珠概念约CircleCI球体的高级别信息。
- 请参阅宝珠常见问题解答对于已经对已知问题和问题的信息使用CircleCI球体时解决。
- 请参阅可重复使用的配置参考可重复使用的球体,命令,参数和执行器的例子。
- 请参阅宝珠测试方法有关如何测试的天体已创建的信息。
- 请参阅配置食谱关于您如何使用CircleCI ORB食谱你的配置信息。