第二个人进来那天:一次真实接入的全程实录
理论篇讲了该怎么搭。这一篇,是我们自己照着走了一遍之后,把教科书没写的那部分记下来。
START
为什么有这篇
上一篇《别共用一个账号》把架构讲清楚了:每人一张自己的通行证,图纸归机构,改动走送审。道理都对——可真到「第二个人今天就要进来」那天,你面对的不是架构图,是一台来历复杂的旧电脑、一位第一次用代码平台的同事,和一串教程里没出现过的界面。
该看的都看了。真到要把人加进来那天,我还是不知道会撞上什么。
这一篇不再讲道理,只讲实况。我们自己——一个两个人的小团队——照理论篇的架构真走了一遍:建机构、迁图纸、发通行证、走完第一次送审,全程一个下午。下面是完整的过程清单,和三个事先没料到的坑。
那天的清单
- 迁移前先把手头的活收尾——当前改动推送归档,再开迁移窗口
- 新同事的账号就位,开双重验证(2FA),恢复码自己保管
- 给接入设备做一次「体检」:查这台机器上残留着谁的身份、谁的钥匙(详见下文)
- 配新同事自己的身份和钥匙——其中「把公钥挂到平台上」是浏览器操作,单独成步(详见下文)
- 建机构(Organization),权限基线逐项过一遍,途中只动单上有的项
- 图纸迁进机构——迁移前先做完整备份,迁完确认新地址可达
- 邀请新同事进机构,开启全员强制双重验证(开启前先核对每个人用的验证方式,别把人锁在门外)
- 各台设备、服务器的拉取通道逐个换到新地址
- 演练一次完整送审:开分支 → 改动 → 送审(PR)→ 批准 → 合并 → 删分支
单看清单平平无奇——价值在下面三段:真跑起来,哪几步和教科书不一样。
三个没料到
一、旧电脑的体检,翻出了三个人的痕迹
新同事用的不是新电脑,是一台从别的岗位退下来的旧机器。接入前我们多加了一步「设备体检」:查一遍这台机器上残留着谁的身份、谁的钥匙。结果三处全中——git 全局身份还是团队主的;一对不知道什么时候配的旧钥匙还躺在原位;最意外的是,系统钥匙串里存着第三个人的平台登录凭据,既不是团队主,也不是这位新同事。
处置:旧钥匙不删,移进「退役」文件夹留档;钥匙串里的第三方凭据清掉、对应令牌另行吊销;新身份直接覆盖旧配置。顺手还发现这台机器的系统时区是错的——复用旧设备,时区、账户这些底层设置值得一并核一遍。
教训一句话:「他没用过你的凭据」和「这台机器上没有你的凭据」,是两回事。有协同史的设备,问是问不出来的,只有查。
二、「免费 30 天」的大字,和一个根本找不到的开关
建机构时,界面两次差点把我们带偏。第一次:页面大字写着「Start free for 30 days」,让人以为免费档只有 30 天——其实那是付费版功能的广告位,免费档本身是永久的。第二次:我们的权限基线清单里有一项「禁止邀请外部协作者」,在当时的界面上翻遍了也没有这个开关。最后的解法不是继续找按钮,而是回头读权限结构:成员默认无任何仓库权限、没有人拿到仓库管理权、能邀请外人的只剩机构所有者——这一项要防的事已经防住了,只是界面上不叫这个名字。
教训一句话:界面会变、广告会混进来。清单要锚在「要达成什么」,不是「要点哪个按钮」。
还有小半个坑:配置途中,两次差点顺手把清单之外的开关也改了——它们看起来实在太像清单上那一项。拦住我们的是一条土规矩:不在单上的,一律不动。
三、夹在命令中间的浏览器步骤,必定被跳过
配钥匙那一段返了一次工:三条终端命令连着跑,中间有一步要切到浏览器、把公钥挂到平台上——这一步被顺手跳过了,于是验证命令报 Permission denied (publickey)。补挂之后,立刻就通。
教训一句话:终端命令和浏览器操作交错时,浏览器那一步必须单独列成一步。写在注释里的「记得去网页上……」,等于没写。
问答实录
当天真实问出口的问题,按原样收在这里:
| 问题 | 当场的答案 |
|---|---|
| 免费档是不是只有 30 天? | 不是,免费档永久。那行大字是付费版功能的广告。 |
| 验证命令报 Permission denied (publickey),是坏了吗? | 不是坏——钥匙生成了,但公钥还没挂到平台。挂上即通。 |
| 确认框里的红色波浪线要紧吗? | 不要紧——浏览器拼写检查划的线,纯视觉。 |
| 机构的联络邮箱能先填个人邮箱吗? | 能。纯联络字段,随时可改,公共邮箱备好再换。 |
| 「A business or institution」那一格填什么? | 营业执照上的全称。登记用途,之后可改。 |
| 团队主先建机构,还是新人先弄自己那边? | 没有整体先后。除了几个必须的先后卡扣,其余全部并行。 |
你能带走的
- 接入前给设备做体检——查身份、查钥匙、查钥匙串残留。尤其是有协同史的旧设备。
- 理论篇的架构走下来,没有一步是多余的:每人一张自己的通行证,图纸归机构,改动走送审。
- 免费档没有「强制送审」的开关,先用约定顶上:新人一律走送审,所有者保留直推,跑顺了再谈平台强制。
- 给送审单配一张固定的四格模板:改动说明 / 影响范围 / 自检清单 / 验证方式。配好之后,第一次真实送审时它会自动出现,审的人照格看就行。
- 人会变多,怎么办?我们把「谁管哪片」写成一张边界表、「谁能动什么」写成一张权限矩阵。往三人、四人、五人扩展时:边界表加一行、权限矩阵加一列、每人一个账号——结构不变,规模线性。