开发向 · 实战篇

第二个人进来那天:一次真实接入的全程实录

理论篇讲了该怎么搭。这一篇,是我们自己照着走了一遍之后,把教科书没写的那部分记下来。

START

为什么有这篇

上一篇《别共用一个账号》把架构讲清楚了:每人一张自己的通行证,图纸归机构,改动走送审。道理都对——可真到「第二个人今天就要进来」那天,你面对的不是架构图,是一台来历复杂的旧电脑、一位第一次用代码平台的同事,和一串教程里没出现过的界面。

该看的都看了。真到要把人加进来那天,我还是不知道会撞上什么。

这一篇不再讲道理,只讲实况。我们自己——一个两个人的小团队——照理论篇的架构真走了一遍:建机构、迁图纸、发通行证、走完第一次送审,全程一个下午。下面是完整的过程清单,和三个事先没料到的坑。

那天的清单

  1. 迁移前先把手头的活收尾——当前改动推送归档,再开迁移窗口
  2. 新同事的账号就位,开双重验证(2FA),恢复码自己保管
  3. 给接入设备做一次「体检」:查这台机器上残留着谁的身份、谁的钥匙(详见下文)
  4. 配新同事自己的身份和钥匙——其中「把公钥挂到平台上」是浏览器操作,单独成步(详见下文)
  5. 建机构(Organization),权限基线逐项过一遍,途中只动单上有的项
  6. 图纸迁进机构——迁移前先做完整备份,迁完确认新地址可达
  7. 邀请新同事进机构,开启全员强制双重验证(开启前先核对每个人用的验证方式,别把人锁在门外)
  8. 各台设备、服务器的拉取通道逐个换到新地址
  9. 演练一次完整送审:开分支 → 改动 → 送审(PR)→ 批准 → 合并 → 删分支

单看清单平平无奇——价值在下面三段:真跑起来,哪几步和教科书不一样。

三个没料到

一、旧电脑的体检,翻出了三个人的痕迹

新同事用的不是新电脑,是一台从别的岗位退下来的旧机器。接入前我们多加了一步「设备体检」:查一遍这台机器上残留着谁的身份、谁的钥匙。结果三处全中——git 全局身份还是团队主的;一对不知道什么时候配的旧钥匙还躺在原位;最意外的是,系统钥匙串里存着第三个人的平台登录凭据,既不是团队主,也不是这位新同事。

处置:旧钥匙不删,移进「退役」文件夹留档;钥匙串里的第三方凭据清掉、对应令牌另行吊销;新身份直接覆盖旧配置。顺手还发现这台机器的系统时区是错的——复用旧设备,时区、账户这些底层设置值得一并核一遍。

教训一句话:「他没用过你的凭据」和「这台机器上没有你的凭据」,是两回事。有协同史的设备,问是问不出来的,只有查。

二、「免费 30 天」的大字,和一个根本找不到的开关

建机构时,界面两次差点把我们带偏。第一次:页面大字写着「Start free for 30 days」,让人以为免费档只有 30 天——其实那是付费版功能的广告位,免费档本身是永久的。第二次:我们的权限基线清单里有一项「禁止邀请外部协作者」,在当时的界面上翻遍了也没有这个开关。最后的解法不是继续找按钮,而是回头读权限结构:成员默认无任何仓库权限、没有人拿到仓库管理权、能邀请外人的只剩机构所有者——这一项要防的事已经防住了,只是界面上不叫这个名字。

教训一句话:界面会变、广告会混进来。清单要锚在「要达成什么」,不是「要点哪个按钮」。

还有小半个坑:配置途中,两次差点顺手把清单之外的开关也改了——它们看起来实在太像清单上那一项。拦住我们的是一条土规矩:不在单上的,一律不动。

三、夹在命令中间的浏览器步骤,必定被跳过

配钥匙那一段返了一次工:三条终端命令连着跑,中间有一步要切到浏览器、把公钥挂到平台上——这一步被顺手跳过了,于是验证命令报 Permission denied (publickey)。补挂之后,立刻就通。

教训一句话:终端命令和浏览器操作交错时,浏览器那一步必须单独列成一步。写在注释里的「记得去网页上……」,等于没写。

问答实录

当天真实问出口的问题,按原样收在这里:

问题当场的答案
免费档是不是只有 30 天?不是,免费档永久。那行大字是付费版功能的广告。
验证命令报 Permission denied (publickey),是坏了吗?不是坏——钥匙生成了,但公钥还没挂到平台。挂上即通。
确认框里的红色波浪线要紧吗?不要紧——浏览器拼写检查划的线,纯视觉。
机构的联络邮箱能先填个人邮箱吗?能。纯联络字段,随时可改,公共邮箱备好再换。
「A business or institution」那一格填什么?营业执照上的全称。登记用途,之后可改。
团队主先建机构,还是新人先弄自己那边?没有整体先后。除了几个必须的先后卡扣,其余全部并行。

你能带走的

  • 接入前给设备做体检——查身份、查钥匙、查钥匙串残留。尤其是有协同史的旧设备。
  • 理论篇的架构走下来,没有一步是多余的:每人一张自己的通行证,图纸归机构,改动走送审。
  • 免费档没有「强制送审」的开关,先用约定顶上:新人一律走送审,所有者保留直推,跑顺了再谈平台强制。
  • 给送审单配一张固定的四格模板:改动说明 / 影响范围 / 自检清单 / 验证方式。配好之后,第一次真实送审时它会自动出现,审的人照格看就行。
  • 人会变多,怎么办?我们把「谁管哪片」写成一张边界表、「谁能动什么」写成一张权限矩阵。往三人、四人、五人扩展时:边界表加一行、权限矩阵加一列、每人一个账号——结构不变,规模线性。