做Coverity时，很多人前面的问题不是不会跑分析，而是项目还没建顺，后面的流、配置文件和上传目标就已经先乱了。Black Duck官方文档把这件事分成了两层，一层是Coverity Connect里的项目和流配置，另一层是分析侧的初始化配置文件，也就是coverity.yaml。更稳的做法，不是先随手跑一遍命令，而是先把项目和流建清，再把初始化参数按上传目标补齐。

　　一、Coverity怎么创建项目

　　先不要把项目和流混着建。官方资料说明，项目和流都在Projects&Streams这条入口里管理，但流不是孤立随便挂的，它需要和项目、Triage Store这些对象一起放到同一套结构里，所以先建项目，再建流，后面会更顺。

　　1、先进入Projects&Streams

　　官方文档写得很直接，创建项目时先到Projects&Streams菜单，再点击加号新建项目。也就是说，项目创建不是从分析命令行开始，而是先在Coverity Connect这一层落地。

　　2、项目名先按代码线或产品线来定

　　Black Duck官方关于项目和流规划的说明强调，项目和流的组织方式要围绕代码库结构来设计。实际操作里，更稳的办法通常是让项目对应产品线、系统线或仓库大类，不要一上来就按临时分支或一次性任务去建项目。这个判断属于基于官方“先规划项目和流结构”原则得出的实际做法。

　　3、项目建好以后再建流

　　官方文档说明，创建流时需要填写名称和描述，而且必须把流关联到一个Triage Store。也就是说，真正接分析结果的通常是流，不是只有项目名就够了，所以项目建完以后，下一步就该把流补上。

　　4、角色和权限要在项目层先收住

　　项目建好以后，官方文档提到可以在Roles标签页里给组分配角色。这个动作不要拖到后面再补，因为项目和流一旦已经开始接结果，权限边界没先收好，后续查看、分派和处置缺陷时就容易混乱。

　　二、Coverity项目初始化参数怎么填写

　　初始化参数这件事，不要理解成“随便填几个值就能跑”。官方资料把coverity setup生成coverity.yaml说得很明确，这份配置文件至少要指定上传使用的stream，以及Coverity Connect的服务器地址；另外在交互式setup里，还会提示输入用户名和密码。也就是说，初始化不是只填本地分析参数，而是把“分析结果最后发到哪里”先定下来。

　　1、先运行coverity setup

　　官方说明里提到，coverity setup会生成配置文件coverity.yaml。如果你不手工写配置，最省事的正式入口就是先跑这个命令。

　　2、先填上传目标stream

　　官方文档在交互式说明里明确写到，运行coverity setup时会提示填写upload stream；同时另一份CLI文档又说明，最少必须指定要使用的stream。也就是说，这里不要只写项目名，真正该填的是分析结果最终要进入的流。

　　3、再填Coverity Connect服务器地址

　　官方CLI文档说明，coverity.yaml至少还要指定Connect server的位置。这个参数本质上就是分析端要把结果发往哪台Coverity Connect服务器，所以地址一定要和你前面实际建项目、建流的那套环境对应起来。

　　4、用户名和密码按交互提示填写

　　官方创建配置文件的说明里写到，coverity setup还会提示输入Coverity Connect的用户名和密码。也就是说，初始化参数里不只是“项目信息”，还包括真正能让客户端连上平台的认证信息。

　　5、源码目录不是当前目录时再补source directory

　　官方对coverity setup的说明还提到，这个命令会生成配置文件，并指定源码目录，前提是源码目录和当前工作目录不同。也就是说，如果你的仓库目录不是现在执行命令的位置，这一步就不要跳过。

　　三、Coverity项目初始化先填哪些信息

　　真正容易做反的，不是不会输命令，而是顺序反了。明明项目和流都还没在Connect里建好，却先开始写coverity.yaml；或者流已经有了，结果初始化时只记得项目名，不记得具体stream。更稳的顺序，应该是先平台、后配置、再分析。这个顺序和官方把Projects&Streams配置与coverity setup分开说明的逻辑是一致的。

　　1、第一步先定项目名

　　因为项目是外层组织结构，后面流、角色和权限都会挂在这层下面。项目名没先定，后面的流也很容易建散。

　　2、第二步再定stream名

　　因为初始化配置真正要落的是stream，不是抽象的项目层。流名一旦没先定，coverity setup那一步就容易填错上传目标。

　　3、第三步再核服务器地址和认证信息

　　当项目和流都已经在Connect里站稳以后，再去填服务器地址、用户名和密码，这样coverity.yaml会更不容易写偏环境。

　　4、第四步最后再开始跑初始化和分析

　　当前面几项都已经定好，再执行coverity setup，后面的扫描、上传和项目归档关系才会顺。如果一开始就直接跑命令，后面通常还得回来补改stream和服务器地址。这个判断是基于官方最小配置要求和项目流管理入口整理出来的实际顺序。

　　总结

　　Coverity怎么创建项目，关键不是只在平台里点一个项目名，而是先把项目、流和Triage Store这套结构搭清楚。Coverity项目初始化参数怎么填写，重点也不是把coverity.yaml随手写完，而是先把stream、服务器地址、认证信息和源码目录这些真正影响上传目标的参数补完整。按“先项目、后流、再初始化配置”的顺序往下做，后面的分析和结果入库通常会顺很多。