- dev/obsidian-schema.md: type별 frontmatter 규약 문서화
- infra/hosts/{incus-hp2,incus-kr1,zlambda}.md: 구조화된 필드로 파일럿 3개
- infra/hosts.base: Bases 쿼리 (전체/서울/K3s/유료/Critical 뷰)
기존 infra-hosts.md 본문은 그대로 유지. 파일럿 검증 후 나머지 호스트 확장 예정.
3.2 KiB
3.2 KiB
title, updated, tags
| title | updated | tags | ||||
|---|---|---|---|---|---|---|
| Obsidian Frontmatter 스키마 | 2026-04-13 |
|
목적
infra-hosts나 outline 등 정본 문서에 Bases/Dataview로 쿼리 가능한 구조화된 필드를 추가해서 빠른 조회·필터링이 가능하게 한다. 기존 본문(prose)과 공존.
- Obsidian Bases (core plugin, 2026년 정식) 기본 사용
- 필요 시 Dataview 플러그인 추가 (커뮤니티, DQL 쿼리)
공통 필드
모든 문서 공통:
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
title |
string | ✅ | 문서 제목 (파일명과 별개) |
updated |
date (YYYY-MM-DD) | ✅ | 최근 업데이트. 변경 사유는 뒤에 자유 텍스트 |
tags |
array[string] | ✅ | 분류 태그. type 태그(host, service, product) 포함 권장 |
Type별 필드
type: host (서버/컨테이너/라우터/NAS)
---
title: incus-hp2
updated: 2026-04-13
tags: [infra, host]
type: host
host_kind: server # server | container | router | nas | vm
location: seoul # seoul | tokyo | osaka | aws-kr | ...
provider: self-hosted # self-hosted | linode | aws-lightsail | google-cloud | vultr
status: active # active | maintenance | retired
ssh_host: incus-hp2 # ssh 단축 별칭 (tssh 포함)
public_ip: null # 공인 IP (없으면 null)
tailscale_ip: 100.100.52.34
lan_ip: 192.168.9.134
os: Debian 13
cpu_model: Xeon E5-2670
cpu_cores: 32
ram_gb: 188
k3s_role: worker # control-plane | worker | null
critical: true # 다운 시 서비스 영향 큰지
monthly_cost_usd: 0 # 자체 운영 0, 클라우드는 실제 비용
---
type: service (K3s 서비스, 외부 SaaS 등)
---
title: Gitea
updated: 2026-04-13
tags: [service, devtools]
type: service
category: devtools # devtools | observability | edge | storage | ai | messaging | ...
deployment: helm # helm | kubectl | docker-compose | bare-metal | saas
cluster: k3s-seoul # k3s-seoul | k3s-tokyo | null(외부) | saas
namespace: gitea # K8s 네임스페이스
url: https://gitea.inouter.com
criticality: high # high | medium | low
status: active
depends_on: [postgresql-ha, traefik, cert-manager] # 내부 문서 슬러그
---
type: product (사내 제품/서비스 브랜드)
---
title: 아이언클래드
updated: 2026-04-13
tags: [product, anvil]
type: product
brand: ironclad
status: live # live | beta | planning | retired
url: https://ironclad.it.com
owner: kaffa
---
type: reference (외부 서비스/문서 레퍼런스)
---
title: BunnyCDN
updated: 2026-04-13
tags: [services, cdn]
type: reference
category: cdn
vendor: Bunny.net
---
스키마 진화 규칙
- 필드는 추가만 자유롭게. 제거/이름 변경은 기존 파일도 같이 수정
- 모르는 값은
null보다 필드 생략 선호 (Bases에서 자동 무시) - 날짜는 ISO
YYYY-MM-DD고정 - 배열은
[a, b, c]인라인, 5개 초과 시 블록 스타일 - 문자열에 콜론·대괄호 있으면 따옴표 필수
참고
- Bases 쿼리 예시: hosts
- Obsidian Bases 공식: https://help.obsidian.md/bases