将项目与Git存储库集成
将项目连接到Git存储库以便在那里保存配置。 通过这样做,您可以使用您的存储库和您选择的 CI 和 CD 工具来自动化项目中的配置管道。
这是一个实验性功能,仅用于评估和测试目的,可能会发生变化,恕不另行通知。
管道和工具链是可定制的,因此您可以使用项目 API 方法或 CLI 命令自动执行Git存储库和项目之间的许多操作。 例如,当配置更改合并到存储库中的主分支时,您可以创建一个管道来触发项目更新。 有关更多信息,请参阅 在Git存储库中自动执行项目操作。
在项目中,草稿配置可以保存到存储库中的任何分支。 但是,只有将草稿配置合并到管理 CD 管道的存储库中的分支后,您才能验证和部署草稿配置。 您还必须通过更新配置将存储库中的更新同步到项目中,然后才能验证和部署这些配置。 您可以使用 project.config.update
API 方法或 ibmcloud project config-update
CLI 命令自动执行此更新。
准备工作
-
确保您在IBM Cloud项目服务上具有编辑者角色,以管理Git存储库集成。
-
将访问令牌保存为秘密以连接到您的Git存储库。 访问令牌需要对您想要使用的分支具有写访问权限并在您的存储库中创建提交。 访问令牌还需要列出分支并读取它们的能力。
-
在您的IBM Cloud帐户中 创建一个Secrets Manager服务实例。 要创建一个秘密,您必须Secrets Manager拥有写作者或更高权限。
-
创建机密实例后,请确保选择其他机密类型来添加任意机密。 有关创建任意密钥的信息,请参阅 在 UI 中创建任意密钥。 您的任意秘密必须包含您的Git存储库的访问令牌。
-
将项目连接到 Git 资源库
将您的Git存储库连接到您的项目。 这样,配置更改就会保存到您的存储库,而不是项目 JSON 文件。 由于您的项目需要将配置保存到您的存储库,因此您必须提供访问令牌来从您的项目向存储库进行身份验证。
- 在IBM Cloud控制台中,单击导航菜单图标
>**项目**并选择一个项目。
- 从“管理”选项卡中,选择 “集成”。
- 在Git存储库集成部分中,单击 “连接”。
- 从存储库类型菜单中,选择您想要用于管理配置的存储库类型。 通常,此存储库是您用来管理管道和工具链的存储库。 您可以选择 GitHub、GitLab 或 GitHub Enterprise。
- 输入 URL 到版本库。
- (可选)指定存储库内的文件夹。 如果您想将您的存储库与多个项目集成,请考虑指定一个文件夹。 每个项目可以有自己的文件夹。
- 将鼠标悬停在访问令牌字段上或单击该字段,然后单击 Secrets 图标
以选择包含您的访问令牌的 Secret。
- 如果您的项目已经包含配置,请选择 “将现有配置文件复制到此资源库”,将现有配置保存到您的资源库中。
- 单击保存。
后续步骤
现在您的Git存储库已与您的项目连接,您可以自定义管道和工具链了。 要了解如何创建在将更改合并到主分支时自动更新项目中的配置的管道,请参阅 在Git存储库中自动执行项目操作。