← Diary

♡ Public Diary

Aurora Log 운영 콘솔을 만든 날

Aurora Log를 무료 정적 사이트에서 로컬 작성 앱과 자동 배포 흐름을 갖춘 개인 아카이브 운영 시스템으로 정리한 기록.

aurora-logaurora-writerdeployworkflow

오늘의 기록

오늘은 Aurora Log의 운영 구조를 거의 끝까지 정리했다.

처음에는 단순히 개인 활동을 기록하는 블로그를 만들고 싶었다.

하지만 작업을 진행하다 보니, 단순 블로그보다 더 중요한 것은 “계속 쓸 수 있는 구조”라는 점이 분명해졌다.

그래서 오늘은 글을 쓰고, 저장하고, 공개하고, 수정하고, 다시 내리는 흐름을 하나씩 정리했다.

처음에는 GitHub와 Cloudflare Pages를 연결해서 무료로 사이트를 배포했다.

그 과정에서 Cloudflare Workers와 Pages의 차이, build 설정, package-lock 문제, npm ci 문제, Astro build 오류 등을 하나씩 해결했다.

그 뒤에는 글 작성 방식이 불편하다는 점을 고쳤다.

Markdown 파일을 직접 만들고, PowerShell에서 명령어를 치고, git commit과 push를 직접 하는 방식은 장기적으로 유지하기 힘들다고 판단했다.

그래서 Aurora Writer라는 로컬 작성 앱을 만들었다.

이 앱은 내 컴퓨터에서만 열리는 작성 도구다.

브라우저에서 글을 쓰고, 버튼을 누르면 Markdown 생성, build, commit, push까지 이어진다.

이제 새 글은 Publish Now로 올리고, 기존 글은 Edit Existing에서 불러와 수정할 수 있다.

또한 slug 자동 생성, 태그 자동 추천, Market 글 전용 점수표 템플릿, 번역 초안 생성, 공개 글 내리기, 휴지통 이동 기능도 추가했다.

중간에 오류도 많았다.

Windows 경로와 OneDrive, 한글 폴더명, 공백이 섞이면서 spawn EINVAL, Git safe.directory 문제, commit 메시지 따옴표 문제, YAML date와 tags 형식 오류가 계속 나왔다.

하지만 그 오류들을 하나씩 고치면서 시스템이 훨씬 단단해졌다.

결국 Aurora Writer는 시작할 때 자동으로 환경을 점검하고, 변경분이 있으면 자동으로 build와 push까지 수행하는 구조가 되었다.

이제 평소에는 open-aurora-writer.bat를 누르고 글을 쓰면 된다.

Aurora Log는 단순한 블로그가 아니라, 내 활동과 생각을 장기적으로 남기는 개인 기록 관제판에 가까워졌다.

느낀 점

오늘 작업에서 가장 크게 느낀 것은, “기록을 계속 남기려면 기록 도구 자체가 편해야 한다”는 점이다.

아무리 좋은 블로그라도 글 하나 올릴 때마다 명령어를 여러 번 입력해야 한다면 오래 쓰기 어렵다.

그래서 글쓰기 자체보다 먼저, 글을 계속 넣을 수 있는 통로를 만드는 일이 중요했다.

버그가 많이 나왔지만, 오히려 그 덕분에 운영 구조가 현실적인 방향으로 정리됐다.

특히 Windows 환경에서 자동화 도구를 만들 때는 경로, 공백, 한글, 따옴표, Git 명령 실행 방식이 생각보다 큰 적이라는 것을 배웠다.

기록 시스템은 화려한 기능보다도, 실패했을 때 어디서 막혔는지 알 수 있어야 한다.

오늘 만든 Aurora Writer는 그 점에서 꽤 실전적인 형태가 됐다.

배운 점

  • 정적 사이트는 무료로 운영하기 좋지만, 글쓰기 흐름을 따로 설계하지 않으면 운영 피로가 크다.
  • GitHub와 Cloudflare Pages를 연결하면 push만으로 자동 배포가 가능하다.
  • 로컬 작성 앱을 만들면 외부 CMS 없이도 개인용 관리자 화면처럼 쓸 수 있다.
  • 공개 글과 비공개 원본, 휴지통, 번역 초안은 처음부터 분리해두는 편이 안전하다.
  • Astro content collection에서는 frontmatter 형식이 엄격하다.
  • YAML date는 문자열이 아니라 날짜 형식이어야 하고, tags는 문자열이 아니라 배열이어야 한다.
  • Windows 자동화에서는 cmd.exe, Git, 공백 경로, 한글 경로 처리를 조심해야 한다.
  • 자동화는 기능을 늘리는 것보다, 클릭 수를 줄이는 방향으로 설계해야 실제로 오래 쓴다.

다음에 할 일

  • 테스트 글을 정리하고 실제 운영용 첫 일기를 남긴다.
  • Market 글을 위한 투자 점수표 템플릿을 실제 분석 스타일에 맞게 다듬는다.
  • 기존 샘플 글을 실제 내용으로 교체한다.
  • 번역 초안 기능을 사용해 영어, 일본어 페이지 운영 흐름을 확인한다.
  • 공개할 정보와 비공개로 남길 정보를 더 명확히 구분한다.
  • Aurora Log를 단순 포트폴리오가 아니라, 장기적인 사고 기록 창고로 키워간다.