“블록체인은 암호화되어서 안전하다”는 설명을 자주 봅니다. 그런데 Bitcoin 트랜잭션을 블록 탐색기에서 열어보면 송금액, 수신자, 잔액이 전부 평문으로 보입니다. 암호화가 핵심이라면 이 내용은 왜 숨겨져 있지 않을까요? 블록체인이 실제로 암호학으로 해결하는 문제는 기밀성이 아니라 무결성과 인증입니다. 누가 자산을 이동시켰는지(서명), 기록이 이후...
마크다운으로 지식 베이스를 운영하는 사례가 늘면서 그 형식을 규정하려는 시도도 나오고 있습니다. Google Cloud가 공개한 OKF(Open Knowledge Format)가 그중 하나입니다. 마크다운 파일 트리와 YAML frontmatter만으로 지식 묶음을 정의하고, 특정 LLM이나 벡터 DB, SaaS를 요구하지 않습니다. 같은 재료를 쓰기...
위키에 문서를 추가하면 검색도 함께 좋아진다고 가정하기 쉽습니다. 실제로는 반대로 움직이는 구간이 있습니다. 문서가 늘면 비슷한 주제의 후보가 같이 늘어 정답이 상위 결과 밖으로 밀리고, 허브 문서에 연결되지 않은 채 쌓인 문서는 검색 후보 풀에조차 안정적으로 들어가지 못합니다. 문서는 쌓이는데 검색은 나빠집니다. 이 구간을 판별하려면 검색 품질이 ...
LLM Wiki의 개념을 이해했다면 다음 단계는 직접 구축하는 것입니다. 이 글에서는 마크다운 vault 하나를 검색 가능한 LLM Wiki로 만드는 과정을 정리합니다. 도구는 Obsidian과 git, 검색 스크립트면 충분하며 특정 SaaS 구독이나 벡터 DB 클러스터는 필요하지 않습니다. 1. 저장소 설계 시작은 디렉터리 구조를 정하는 것입...
AI 에이전트를 업무에 활용하면 문서와 지식을 어떻게 관리할지가 새로운 문제로 등장합니다. 사람이 읽기만 하면 되던 문서와 달리, LLM이 질의 시점에 검색해서 읽을 수 있어야 하기 때문입니다. LLM Wiki는 이 조건에 맞춰 지식 베이스를 설계하는 방법론입니다. 이 글에서는 LLM Wiki가 무엇인지, 왜 필요한지, 어떤 구조로 구성되는지를 정리합...
Jenkins Operator를 운영하다 보면 이런 상황을 만납니다. JCasC 설정을 변경했는데 Jenkins에 반영되지 않습니다. Operator 로그를 보면 같은 에러가 반복되다가 어느 순간 조용해집니다. CR을 지우고 다시 만들면 동작합니다. 왜 그런지 이해하려면 Operator가 한 패스(pass)에서 무엇을 어떤 순서로 수행하는지 소스 코드...
Jenkins Item을 만들면서 Pipeline script 박스에 Groovy를 붙여넣은 적이 있다면, 그 스크립트가 지금 어디에 있는지 한 번 생각해 보아야 합니다. Jenkins 컨테이너 안의 설정 파일 안에 있습니다. git으로 관리되지 않고, 코드 리뷰를 거치지 않으며, Jenkins를 재구축하면 사라집니다. 파이프라인을 고치려면 Jenki...
팀이 공유하는 사내 라이브러리는 공개 registry에 올릴 수 없습니다. 그런데 같은 빌드가 npm과 PyPI에서 공개 패키지도 함께 가져옵니다. 사내 패키지용 저장소를 따로 세우면 빌드마다 두 곳의 endpoint와 인증 정보를 관리해야 하고, 사용하는 언어가 늘어날수록 그 저장소도 언어별로 늘어납니다. 공개 registry에서 받아온 패키지가 어...
마이크로서비스가 여러 VPC와 AWS 계정에 흩어져 있으면 서비스 간 연결이 복잡해집니다. 팀 A의 서비스는 계정 X에, 팀 B의 서비스는 계정 Y에 배포되고, 두 서비스가 통신하려면 VPC Peering이나 Transit Gateway를 설정하고 보안 그룹을 조정하고 DNS를 구성해야 합니다. 서비스가 늘어날수록 이 연결망은 거미줄처럼 얽히고, 한쪽...
프로젝트가 커질수록 dev server 시작이 느려집니다. webpack 기반 dev server는 애플리케이션 전체를 사전에 번들링한 뒤 브라우저에 서빙하므로, 모듈이 수백 개를 넘어가면 npm run dev 한 번에 수십 초를 기다려야 합니다. 파일 하나를 저장할 때마다 HMR이 전체 번들을 다시 만들지는 않지만, dependency graph를 ...