引言
Copado 是一款可扩展的 Salesforce 原生应用程序,它通过利用敏捷方法论、质量合规性功能和无缝 Git 集成,在 Salesforce DevOps 过程的每个阶段提供价值。Copado 通过协调所有发布管理工具形成单一、流畅的安排,从而推动业务转型。
正文
1. 使用 Copado 前的注意事项
在开始使用 Copado 之前,有一些要点需要考虑:
- 定义发布流程:从用户故事创建到发布的整个过程,你需要决定管理员和开发人员是否应提交他们的用户故事以供审批,并确定要实施的质量门(如运行 Apex 测试、静态代码分析、拉取请求审查、合规扫描或 Selenium 测试)。
- 自定义质量门:如果你的流程包括质量门(如业务测试、同行评审、文档审查),可以考虑创建自定义字段、验证规则和流程构建器流来强制执行这些质量门。
- 权限集配置:为开发者提供更多限制访问 Copado 的权限,可以创建一个权限集,授予用户与 Copado 工作所需的访问权限。例如,Copado 包提供了 Copado 用户权限集,你可以根据需要进行定制。
- 培训和支持:组织培训课程,让团队成员了解如何在 Copado 中操作。
2. 检查你的 Salesforce 组织版本
确保你拥有正确的 Salesforce 组织版本来安装 Copado。由于 Copado 使用了某些 Salesforce 特性(如 API 访问),你只能在 Enterprise、Unlimited、Performance 和 Developer 版本中安装 Copado。
3. 如何安装 Copado
可以从 Copado 的 Success 社区下载最新版本并获取额外信息,如升级说明、发布说明和发布日历。
3.1 安装 Copado Deployer
在安装过程中,你会被要求输入你的 Salesforce 登录详细信息作为治理 Org。选择“仅限管理员安装”选项,稍后会开放给其他用户。
安装完成后,可以通过“设置”下的“已安装包”菜单验证 Copado 是否成功安装。
3.2 注册 Copado 应用程序
安装完成后,需要在 Copado 服务器上注册 Copado 应用程序。导航到Account Summary Page页面并点击“Register Application”按钮,然后点击“Register”完成注册过程。
3.3 注册 Copado 应用程序
当Salesforce组织(Org)启用了IP地址访问限制功能时,仅允许预设的IP地址范围登录或访问系统。若需允许Copado等第三方工具的后端服务与Salesforce通信,必须将Copado的静态IP地址添加至白名单中。 如果在 Salesforce org 中有 IP 限制,需要将以下 IP 地址列入白名单:
-
美国:
- 18.233.58.23
- 35.174.57.133
- 54.206.216.216
- 54.84.188.199
- 54.173.229.200
- 54.175.230.252
-
欧洲:
- 34.246.18.129
- 34.246.45.11
- 52.16.121.13
- 54.154.218.66
- 99.80.183.117
- 99.81.115.32
⚠️ 注意事项:若未明确要求支持团队位于欧洲区域,默认使用美国区域的IP地址列表
配置用户登录IP范围
- 登录Salesforce,进入 Setup(设置) 。
- 在左侧导航栏搜索并进入 Profiles(用户档案) 。
- 选择需要配置的用户角色对应的 Profile(例如:System Administrator)。
- 在 Login IP Ranges(登录IP范围) 部分,点击 Add IP Ranges。
- 将所需的Copado静态IP地址逐行输入,格式为
IP地址/32(例如:18.233.58.2/32)。 - 点击 Save(保存) 。
📌 提示:若组织中有多个用户角色,需为每个角色重复上述操作,确保覆盖所有相关用户。
调整会话设置(Session Settings)
-
在 Setup(设置) 中搜索并进入 Session Settings(会话设置) 。
-
检查以下两个选项是否未启用:
- Force Login IP Range Restriction(强制登录IP范围限制)
- Lock Sessions to the Originating IP Address(将会话锁定到其起源的IP地址)
-
如果上述选项被启用,取消勾选并保存更改。
⚠️ 重要说明:若启用“将会话锁定到IP地址”,即使IP已加入白名单,用户也可能因IP变化导致会话中断。
示例场景
假设你是一个项目经理,正在领导一个大型 Salesforce 开发项目。为了确保项目的顺利进行,你决定引入 Copado 来优化 DevOps 流程。
- 定义发布流程:你首先定义了详细的发布流程,包括用户故事的创建、审批和发布步骤。你决定实施严格的代码审查和自动化测试,以确保代码质量。
- 配置权限集:为了保护敏感数据和功能,你创建了一个权限集,只允许特定的开发人员和管理员访问 Copado 的关键功能。
- 安装和注册 Copado:按照官方文档的指引,你在 Salesforce 组织中成功安装了 Copado,并完成了应用程序的注册。
- IP 白名单:由于公司网络的安全策略,你将 Copado 的 IP 地址列入白名单,确保团队成员可以顺利访问 Copado 后端。
通过以上步骤,你成功地将 Copado 引入了项目中,提升了团队的协作效率和代码质量。
使用 Copado 开启你的发布之旅
恭喜你,已经安装了 Copado 并准备好开始你的发布旅程。为了使用户能够顺利使用我们的工具,你需要完成一些前置条件:
- 分配一个包许可证。
- 分配 Copado 用户权限集。
- 在任何 Git 提供商中创建一个 Git 仓库。
- 创建相关的沙盒(开发、集成、测试)。
- 在所有将参与发布过程的沙盒中创建一个 SysAdmin 用户。
包许可证
Copado 是一个安装在生产 Org 中的托管包,因此所有与 Copado 工作的用户都必须拥有授予他们访问托管包对象的 Salesforce 许可证。分配包许可证的过程是通过 Salesforce 执行的标准流程。
Copado 用户权限集
如果你没有足够的权限来操作 Copado,可以为自己分配 Copado User Permission Set,该权限集提供了对所有 Copado 功能的访问。你可以克隆这个权限集并根据需要进行自定义。
Git 仓库
Git 仓库是一个存储文件版本的位置,可以是托管位置或你自己的 Git 服务器。在 Copado 中设置 Git 仓库之前,你需要有一个 Git 服务提供商账户,如 Github、Bitbucket、Gitlab 或 Azure DevOps。Copado 支持任何类型的 Git 提供商。
相关沙盒
你应该已经定义了发布流程,并且现在应该有一个所需沙盒的图形概览。决定你在过程中需要多少个沙盒,并创建它们。
SysAdmin 用户
由于你将在不同的环境中部署更改,因此需要授予 Copado 在所有这些环境中执行操作的权限。为此,在所有将用于发布过程的sandbox中创建一个 SysAdmin 用户。
现在你已经完成了所有前置条件,可以继续进行设置,开启你的发布之旅了。