如何参与 Istio 社区及注意事项

注意：本文档已失效，请浏览 Istio 官方文档。本书中的 Service Mesh 章节已不再维护，请转到 istio-handbook 中浏览。

本文讲述了如何参与 Istio 社区和进行 Istio 开发时需要注意的事项。

工作组

绝大多数复杂的开源项目都是以工作组的方式组织的，要想为 Istio 社区做贡献可以加入到以下的工作组（Working Group）：

代码规范

Istio 的代码规范沿用 CNCF 社区的代码规范。

开发指南

进行 Istio 开发之前需要做下面几件事情：

配置基础环境，如 Kubernetes
配置代码库、下载依赖和测试
配置 CircleCI 集成环境
编写参考文档
Git workflow 配置

详见 Dev Guide wiki。

设计文档

所有的设计文档都保存在 Google Drive 中，其中包括以下资源：

Technical Oversight Committee：ToC管理的文档
Misc：一些杂项
Working Groups：最重要的部分，各个工作组相关的设计文档
Presentations：Istio 相关的演讲幻灯片，从这些文稿中可以快速了解 Istio
Logo：Istio logo
Eng：社区相关的维护文档

社区角色划分

根据对开发者和要求和贡献程度的不同，Istio 社区中包含以下角色：

Collaborator：非正式贡献者，偶尔贡献，任何人都可以成为该角色
Member：正式贡献者，经常贡献，必须有2个已有的 member 提名
Approver：老手，可以批准 member 的贡献
Lead：管理功能、项目和提议，必须由 ToC 提名
Administrator：管理员，管理和控制权限，必须由 ToC 提名
Vendor：贡献 Istio 项目的扩展

详见 Istio Community Roles。

各种功能的状态

Istio 中的所有 feature 根据是否生产可用、API兼容性、性能、维护策略分为三种状态：

Alpha：仅仅可以作为 demo，无法生产上使用，也没有性能保证，随时都可能不维护
Beta：可以在生产上使用了，也有版本化的 API 但是无法保证性能，保证三个月的维护
Stable：可以上生产而且还能保证性能，API 向后兼容，保证一年的维护

Istio 的 feature 分为四大类：

流量管理：各种协议的支持、路由规则配置、Ingress TLS 等
可观察性：监控、日志、分布式追踪、服务依赖拓扑
安全性：各种 checker 和安全性配置
Core：核心功能

功能划分与各种功能的状态详情请见：https://istio.io/about/feature-stages.html