内部开发者门户网站的产品化方法

用产品经理的思维创建开发者喜爱的门户网站。

译自 A Portal as a Product Approach for Internal Developer Portals。作者 Zohar Einy 是 Port 的 CEO，这是他与 Yonatan Boguslavski 共同创立的用于内部开发者门户网站的无代码平台。Zohar 的职业生涯始于以色列国防军的 8200 部队，担任平台工程师，在那里他和 Yonatan 开始了合作......

对于许多企业来说，建立一个内部开发者门户网站是实现平台化、减轻开发者负担、达到标准化和提高工作效率的关键所在。但是，创建内部开发者门户网站并不意味着它就能自动成功，开发者必须真正地从中受益，才会积极地使用它。为此，在定义门户网站内容时，企业需要关注产品管理实践，而不仅仅是工程实现。

要创建一个成功的开发者门户网站，企业必须将其视为一个产品，从构思到上线都贯彻产品化思维，包括用户调研、优先级确定和持续的反馈循环。毕竟，没有验证过用户需求就上线产品，后果可能会很惨痛。

本文探讨了如何通过产品化的方法来搭建内部开发者门户网站，更重要的是，如何让门户网站真正帮助开发者提升工作效率。

开发者门户网站作为开发者的促进器

内部开发者门户网站的主要目标是简化开发者的工作并让他们专注于核心开发工作。这包括降低认知负荷、集中和优化工作流程以及最小化花在搜索答案或解决方案上的时间。从本质上说，开发者门户网站应该释放开发者的时间和认知资源，允许他们编写代码而不是在尝试使用DevOps基础设施和工具时迷失方向。

对于开发负责人和高管来说，门户网站充当设置标准、缩短入职培训和提高整体团队效率的一种手段。为了实现对开发者或经理的收益，组织必须仔细考虑在建立内部开发者门户网站时应优先考虑什么。此时，将门户网站视为产品的想法就出现了。我将一步步拆解这一点。

决定如何推出开发者门户网站

关于如何构建开发者门户网站以及开发者应该将其用于什么的决策，要具有战略性。不要仅仅关注门户网站的单个元素(陷入细节中)，而要考虑想要提供的端到端开发者体验。这与是否拥有软件目录或评分卡无关。这与门户网站如何改变开发者的日常工作流程有关。

与开发产品一样，从覆盖一两个用例的最小可行产品(MVP)开始。建立MVP后，随着时间的推移逐步为开发者和管理者增加新的门户网站功能，以丰富门户网站。每个门户网站开发阶段都应涉及培训、交流和软启动，以推动采用。请务必定义成功指标并对其进行衡量，以跟踪门户网站的影响。那么该如何开始呢？

采用“要完成的工作”方法

“要完成的工作”框架是理解开发者需求以及他们希望通过内部开发门户网站完成的任务的关键工具。与其对要添加的功能做出假设，不如鼓励组织确定开发者希望门户网站支持的特定任务，比如快速部署服务或有效管理权限。

以下示例句子可以帮助你深入了解开发者需要门户网站支持的任务:

• 开发者使用门户网站获取_________，而不是_________。
• 当_________时，开发者将转到门户网站查看_________，而不是________。
• 开发者可以查看目录和使用操作，而不是_________。
• 开发者可以_________，而不必花_________来___________。
• 服务在_________检查之前不会进入生产环境。
• 通过_________避免_____________来推动所有开发者执行___________。
• 全面了解_____________。
• 确定人们希望如何使用门户网站

一旦你完成这些句子，你就会得到可以在各种用例中演示的用户故事，这些用例可在开发者的日常工作中为他们提供服务。以下是一些可以促进开发者日常工作流程和任务的高层用例:

• 通过提供指南和最佳实践来遵守内部开发标准。
• 加快将新功能推向生产的过程。
• 促进基础设施即代码(IaC)的采用。
• 优化事故和值班管理。
• 简化与Kubernetes的交互。
• 管理应用程序安全态势。
• 处理功能标志。
• 监控服务运行状况。
• 理解内部API。

开发经理和团队负责人也可以从内部开发者门户网站中受益，例如:

• 掌握成本: 在细粒度级别跟踪和优化成本以改善资源分配
• 新开发者的入职培训: 通过提供精简的导向性体验来缩短入职培训时间
• 推动工程质量: 发起和监督项目以提高生产准备状况、代码质量和开发的其他方面
• 推动安全性和合规性: 在开发和生产过程中内置安全性以管理应用程序安全性(AppSec)和漏洞
• 跟踪生产运行状况: 快速洞察整体生产运行状况、团队表现和服务状态
• 理解DORA指标: 通过理解和跟踪关键的DevOps研究与评估(DORA)指标来提高开发者生产力和速度

确定谁将使用门户网站

内部开发者门户网站将为三个主要用户组提供服务，每个组具有不同的需求和职责:

1. 开发者: 主要是初级和高级开发者，他们主要负责编码和业务逻辑。他们利用门户网站高效完成特定任务。
2. 团队负责人和组经理: 他们负责监督开发者。他们需要全面了解所有项目状态和组织背景。
3. 开发经理: 该组负责更高层次的管理活动，包括产品质量、成本跟踪、安全性、合规性和生产力。他们需要快速访问项目和产品信息。

我已经解释了内部开发者门户网站如何帮助开发者，最有效的推出方法，开发者和管理者的用例示例，以及谁将使用它。现在是时候讨论如何鼓励门户网站的采用了。

让开发者使用门户网站

内部开发者门户网站的成功采用涉及理解组织的团队结构并根据团队目标定制推出策略。最好避免一步到位的方法，而是逐步开始。如何做到这一点？

1. 映射组织的团队结构: 识别工作流程的相互依赖性，相应地调整采用策略。了解哪些团队更有可能成为早期采用者，以及哪些团队能立即从门户网站中受益。
2. 定制推出策略: 首先通过访谈和调查开发者，选择一个重点用例，选择采用指标并监控使用数据以识别障碍。
3. 试点门户网站: 利用成功的初始团队作为冠军来鼓励采用，并根据需求扩展门户网站。

采取产品思维方式

要将内部开发者门户网站转变为对开发者和管理者有力的工具，需要产品管理思维方式。关注渐进式采用和让实施顺利的用例，留出连续反馈循环和迭代的余地。将门户网站视为产品的思维方式可以为你奠定真正为用户服务的工具的基础。