C.W.K.
Stream
Lesson 14 of 14 · published

명명 & 아키텍처

~12 min · naming, documentation, architecture-doc

Level 0Pinger
0 XP0/101 lessons0/12 achievements
0/150 XP to next level150 XP to go0% complete

Fleet 문서화

Fleet 가 한 줌 머신 넘어 자라면서 문서화가 옵션 아니게 됨. 개인 셋업이라도 미래의 너 (그리고 어떤 미래 Pippa) 가 뭐가 어디, 뭐가 뭐 하는지, 어느 IP 가 어느 머신 거인지 알아야. 단순 텍스트 파일이나 Notion 페이지 충분.

살아남는 명명 규약

  • SSH alias 와 hostname 일치. ssh office 동작하면 머신 hostname 도 office. 영리함보다 sanity 이김.
  • 짧고 소문자. 한두 음절. 수천 번 칠 거.
  • 하드웨어 연도보다 기능. office 가 뒤의 specific Mac Studio 보다 오래 살아. mac-studio-2024 안 그래.
  • Portable 구분 가능 유지. macbook, pro2024, pro2023, air — 한눈에 구별 쉬움.

Code

아키텍처 문서 — markdown·markdown
# Home Network Architecture

```
┌─────────────────────────────────────────────────────┐
│        Home Network (192.168.1.0/24)                 │
│                                                       │
│  ┌─────────── 10GbE Switch ────────────────┐        │
│  │                                           │        │
│  │  office(.10)  server(.11)              │        │
│  │  music(.12)   worker(.13)              │        │
│  │  mini(.30)    NAS(.40)                 │        │
│  │                                           │        │
│  └────────────────┬──────────────────────────┘        │
│                   │ 1GbE                              │
│              ┌────┴────┐                              │
│              │ Router  │── Internet                  │
│              └────┬────┘                              │
│                   │ Wi-Fi                             │
│       macbook(.20)  pro2024(.21) pro2023(.22)     │
│                                                       │
│  ── Tailscale (100.64.x.y) overlay ──                │
│     Reach any machine from anywhere                   │
└───────────────────────────────────────────────────────┘
```

## IP table

| Machine  | LAN IP    | Tailscale  | Role                |
|----------|-----------|------------|---------------------|
| office   | .10       | 100.64.0.1 | Primary workstation |
| server   | .11       | 100.64.0.2 | Build server / CI   |
| music    | .12       | 100.64.0.3 | Music production    |
| worker   | .13       | 100.64.0.4 | Background work     |
| nas      | .40       | 100.64.0.10| Storage / backups   |
| macbook  | .20       | 100.64.0.20| Daily portable      |
| ...      | ...       | ...        | ...                 |

Exercise

Fleet 의 아키텍처 적어 — 모든 머신, LAN IP, Tailscale IP, 주된 역할 나열. 어떻게 연결되는지 (스위치, 라우터, Wi-Fi) 단순 ASCII 다이어그램 포함. Dotfiles repo 의 architecture.md 또는 Notion 페이지로 저장. 다음에 뭐 변경되면 업데이트.

Progress

Progress is local-only — sign in to sync across devices.
이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

댓글 0

🔔 답글 알림 (로그인 필요)
로그인댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.