[연재] 배포 스크립트 6개를 1개로

연재 · 2026-08-19

사이트가 열 장이 된 아침

8월 7일 아침, 제 사이트가 파일 열 장짜리가 됐습니다.

평소엔 만 사천 장 넘게 올라가요. 글이 245편이고 도구가 열세 개니까 그 정도 됩니다. 그날 아침 9시 30분 배포 기록엔 이렇게 찍혀 있었어요.

✨ Success! Uploaded 2 files (8 already uploaded) (1.73 sec)

여덟 장에 두 장을 더해서 열 장. 남아 있던 건 시장 지표 화면 파일뿐이었고, 글 245편은 통째로 사라진 상태였습니다.

지금은 이렇게 보이는 목록이에요. 그날 아침엔 이 주소가 그냥 없는 페이지였습니다.

더 나쁜 건 그다음이에요. 10시, 10시 30분에도 크론이 똑같이 돌면서 그 열 장짜리 사이트를 다시 올렸습니다. 매번 초록색 체크 표시와 함께요.

✨ Success! Uploaded 1 files (9 already uploaded) (1.71 sec)

Success! 라고 적혀 있죠. 배포는 정말 성공했어요. 올릴 게 열 장뿐이었을 뿐입니다. 두 시간 동안 사이트가 비어 있었는데, 그 사이 어느 화면에도 빨간 글씨는 안 떴어요.

사실 그날이 처음이 아니었습니다

기록을 뒤로 넘겨 보니까 더 서늘한 게 나왔어요.

8월 3일, 4일, 5일, 6일, 7일. 닷새 연속으로, 매일 아침 9시 정각에 파일 0장짜리 배포가 나가고 있었습니다.

Uploading... (0/0)
✨ Success! Uploaded 0 files (0.53 sec)

0장이면 빈 사이트예요. 앞의 나흘은 몇 분 뒤에 정상 배포가 뒤따라 들어와서 원래대로 돌아왔습니다. 그래서 아무도 모르고 지나갔어요. 저도 몰랐고요. 7일만 뒤따라오는 게 없었던 겁니다.

이 집이 하루에 몇 분씩 나흘 동안 텅 비어 있었다는 뜻이에요. 방문자가 거의 없던 시절이라 아무 일도 안 일어났지만, 운이 좋았던 거지 잘하고 있던 게 아니었습니다.

왜 이렇게 됐는지 말씀드리려면 한참 앞으로 돌아가야 해요. 올리는 일을 여섯 번에서 한 번으로 줄인 이야기부터요.

올리는 일이 여섯 번이었어요

지난 편에서 흩어져 있던 여섯 개 사이트를 한 도메인 아래로 모았다고 했잖아요. 화면은 그때 다 합쳐졌습니다. 그런데 올리는 일은 안 합쳐져 있었어요.

도구마다 자기 배포 절차가 따로 있었거든요. 카드 혜택을 고치면 카드 것을 돌리고, 스위치 데이터를 새로 받으면 스위치 것을 돌리고. 각자 잘 돌아갔습니다. 문제는 이거였어요.

뭘 고쳤는지 기억이 안 나면 뭘 올려야 하는지도 모릅니다.

예를 들어 스위치 목록을 손봤다고 쳐요. 스위치 화면만 올리면 될까요? 그런데 그 화면 아래에 붙은 쿠팡 배너는 광고 폴더에서 오고, 검색엔진에게 주는 안내 파일은 뿌리에 한 벌로 있고, 사이트맵은 또 다른 데서 합쳐집니다. 하나만 올리면 나머지가 어제 것으로 남아요.

그러면 화면은 멀쩡한데 어딘가 한 겹이 낡은 상태가 됩니다. 깨진 게 아니라 낡은 거라서 눈에 안 보여요. 그게 제일 무섭더라고요.

무슨 순서로 뭘 돌려야 하는지를 매번 머리로 재구성하는 일이, 뭘 고치는 일보다 더 피곤해졌습니다. 그래서 손을 댔어요.

한 번으로 만들었습니다

지금은 명령이 하나예요.

bash publish-all.sh

이게 하는 일을 간단히 말하면, 배포용 폴더를 통째로 지우고 처음부터 다시 짓습니다. 본진 글을 굽고, 방마다 도구를 넣고, 광고와 신고 버튼을 붙이고, 주소를 갈아 끼우고, 검색엔진 안내 파일을 뿌리에 한 벌로 모아서, 마지막에 올려요.

"지우고 다시 짓는다"가 핵심이에요. 있던 것 위에 덧칠하면 어제 잘못 들어간 게 오늘도 살아남습니다. 매번 백지에서 시작하면 지금 코드가 만드는 결과만 올라가요. 느리지만 확실합니다.

방은 번호가 붙어 있어요. 뿌리가 1번, 육아휴직 계산기가 2번, 카드가 3번… 이런 식으로요. 방을 하나 더 트는 게 번호 하나 더 붙이는 일이 됐습니다. 실제로 그 뒤로 방이 계속 늘었어요.

롤토체스 갈래 보기.

리센느 영상 모아보기. 이건 그룹 폴더가 하나 늘면 스크립트를 안 고쳐도 알아서 집어 가게 만들어 뒀어요.

여기까지는 예상대로였습니다. 문제는 합친 다음에 생겼어요.

하나가 넘어지면 아홉이 못 올라갑니다

8월 3일 오후에 남긴 기록이 있어요. 제목이 이겁니다.

fix: 마블 하나 때문에 아홉 개 배포가 다 멈추지 않게

무슨 일이 있었냐면요.

마블 인물 매트릭스라는 방이 있어요. 배우와 작품을 격자로 놓고 점 크기로 배역 비중을 그린 화면인데요.

이렇게 인물망으로도 볼 수 있고요.

이 화면은 위키데이터에서 미리 받아 둔 3.7MB짜리 자료 뭉치로 그립니다. 그런데 그 파일이 없거나, 받다가 반쯤 끊긴 상태면 그리는 과정이 그냥 죽어요.

문제는 배포 스크립트에 걸어둔 안전장치였습니다. 중간에 하나라도 실패하면 즉시 전체를 멈추게 해뒀거든요. 원래 그게 맞아요. 반쯤 만들다 만 걸 올리는 것보다 안 올리는 게 낫죠.

그런데 그 규칙 아래에서는 이렇게 됩니다.

마블 자료 하나가 시원찮으면 → 스크립트가 거기서 멈춤 → 글도, 계산기도, 카드도, 지도도 오늘 것으로 못 올라감.

아홉 개가 멀쩡한데 하나 때문에 전부 어제 상태로 서 있게 되는 거예요. 따로 놀 때는 아예 생길 수 없는 사고입니다. 각자 자기 명령으로 올라가니까 옆칸이 넘어지든 말든 상관이 없었거든요.

합치는 게 답인 줄 알았는데, 합치고 나니 "하나가 넘어졌을 때 어떻게 할 거냐"가 새로 문제가 됐습니다.

다행히 이건 한 번 당하고 나서 안 게 아니에요. 기록을 다시 보니 마블 칸은 처음부터 예외를 달고 들어왔습니다. 그날 남긴 변경이 스물한 줄인데 지운 줄이 하나도 없어요 — 있던 걸 고친 게 아니라 통째로 새로 넣은 겁니다. 코드 옆에 이렇게 적혀 있더라고요.

이 도구 하나 때문에 나머지 여덟 개가 못 올라가면 안 된다.

여섯 개를 한 번 합쳐본 다음이라 이번엔 넣기 전에 보인 거예요. 그래서 그 칸만 예외로 뒀습니다. 마블 자료 굽기가 실패하면 그 방은 건너뛰고 계속 갑니다. 배포에는 어제 올라간 마블 화면이 그대로 남고, 나머지는 오늘 것으로 올라가요.

대신 한 줄을 꼭 넣었습니다.

▶ /marvel/ 건너뜀 — 자료가 없습니다

건너뛰었다는 걸 화면에 찍게요. 이게 없으면 조용히 사라집니다. 조용히 실패하는 건 실패한 줄도 모르게 만들어서, 시끄럽게 실패하는 것보다 훨씬 나빠요. 아까 그 초록색 Success! 가 그랬듯이요.

그런데 전부 그렇게 하진 않았습니다

여기서 "그럼 전부 건너뛰게 만들면 되겠네"로 가면 안 됩니다. 저는 정반대로 해둔 방도 있어요.

핸드폰 보험 계산기입니다. 그리고 육아휴직 급여 계산기도 같은 규칙이에요. 이 둘은 검사가 하나라도 틀리면 배포 전체가 그 자리에서 멈춥니다. 건너뛰지 않아요.

기준은 이거였습니다. 낡은 게 나은 곳인가, 틀린 게 최악인 곳인가.

마블 화면은 어제 것이 올라가 있어도 아무 손해가 없어요. 영화 목록이 하루 사이에 바뀌지 않으니까요. 그런데 계산기는 다릅니다. 이 도구들이 존재하는 이유가 숫자의 정확성 하나뿐이에요. 숫자가 틀린 계산기는 없는 것보다 나쁩니다. 누가 그 숫자를 보고 회사에 육아휴직을 신청할지도 모르니까요.

그래서 이렇게 갈랐어요.

볼거리인 방 — 자료가 없으면 건너뛴다. 어제 것이 남는다.
답을 주는 방 — 검사가 깨지면 전체를 멈춘다. 틀린 답보다 어제 화면이 낫다.

집값 지도도 건너뛰는 쪽이에요. 실거래가와 역·학교를 모으는 일은 남의 서버를 몇 시간씩 두드려야 해서 배포 때 돌리지 않고, 미리 구워둔 9MB짜리 자료를 옮기기만 합니다. 그 자료가 아직 없으면 그냥 건너뛰어요.

이 선을 어디에 긋느냐는 코드가 못 정해줍니다. 어느 방이 틀리면 안 되는 방인지는 그 방을 왜 만들었는지 아는 사람만 알거든요. AI는 "실패 처리를 어떻게 할까요"까지는 아주 잘 물어봐요. 그런데 "이 도구는 틀리느니 안 나오는 게 낫다"는 판단은 대신 해줄 수가 없더라고요.

작은 것도 하나 배웠어요. 검사를 돌리는 명령에 폴더 이름을 붙였더니 계속 실패하더라고요. 그 명령은 폴더 이름을 "여기 검사가 있다"가 아니라 "이런 이름의 부품을 불러와라"로 읽습니다. 아무것도 안 붙이는 게 정답이었어요. 이런 건 몰라서 못 하는 게 아니라 몰랐다는 것도 모르는 종류라, 한참 헤맵니다.

다 합치지도 않았어요

"6개를 1개로"라고 써놨지만, 사실 지금도 스크립트는 하나가 아닙니다. 일부러 안 합친 게 있어요.

시장 지표 화면입니다. 코스피·코스닥·달러원, 그리고 반도체 두 종목을 각자 자기 축을 가진 그래프로 나눠 그려요.

이 화면 오른쪽 위를 보시면 2026-08-14 13:14 기준 이라고 붙어 있죠. 저 시각이 이 편의 핵심입니다.

시세는 크론이 1분마다 받아둡니다. 그런데 사이트는 아침 9시 전체 배포 때 하루 한 번 갱신됐어요. 그래서 어떻게 됐냐면, 장이 열리고 3분치 그래프가 그려진 채로 하루 종일 그 상태로 멈춰 있었습니다. 오후 3시에 들어와도 9시 3분까지만 보이는 거예요.

그럼 전체 배포를 자주 돌리면 되지 않냐고요? 그게 안 됩니다. 전체 배포는 글도 다시 굽고 카드 1,180장, 스위치 931장, 회사 1,877장 같은 낱개 페이지를 전부 다시 만들어요. 몇 분씩 걸립니다. 30분마다 돌릴 수가 없어요.

10년 흐름까지 같이 보는 화면이라 자료가 적지도 않고요.

그래서 시장 부분만 떼어냈습니다. 시장 자료만 다시 굽고, 광고바·신고 버튼·홈 버튼만 다시 붙이고, 그대로 올리는 짧은 스크립트예요. 올릴 때 이렇게 찍힙니다.

Uploading... (11219/11219)
✨ Success! Uploaded 1 files (11218 already uploaded) (1.47 sec)

만 천 장 중에 바뀐 한 장만 올라가요. 1.5초면 끝납니다. 이건 평일 낮 시간에 30분마다 돌고, 장 마감 뒤에 한 번, 환율은 밤에도 도니까 밤 10시에 한 번 더 돌아요.

여기서 제가 바꾼 게 하나 있어요. 묶는 기준을 바꿨습니다.

원래 배포가 나뉜 기준은 '도구별' 이었어요. 카드는 카드, 스위치는 스위치. 그걸 하나로 합치면서, 다시 떼어낼 때는 도구를 기준으로 떼지 않았습니다. '얼마나 자주 도는가'로 갈랐어요.

하루에 한 번이면 되는 것 → 전체 배포에 같이 실려 간다
30분마다 새로워야 하는 것 → 따로 떼어 자주 돈다

같은 코드를 두고 자르는 선만 옮긴 겁니다. "하나로 합치자"가 목표가 아니었어요. 목표는 "올릴 때 뭘 빠뜨렸을까 불안해하지 않는 것"이었고, 그러려면 어떤 건 오히려 떼어놔야 했습니다.

그래서 그 아침으로 돌아옵니다

이제 8월 7일 사고의 원인을 말씀드릴 수 있어요. 두 스크립트가 같은 폴더를 봅니다.

전체 배포는 그 폴더를 맨 먼저 통째로 지우고 다시 짓기 시작해요. 시장 배포는 그 폴더를 그대로 올립니다.

크론표를 보시면 답이 나와요. 아침 발행이 9시 정각, 시장 갱신도 그때는 정각마다였습니다. 둘이 같은 분에 동시에 출발했어요.

1. 9시 00분 — 전체 배포 시작. 폴더를 지운다. 2. 같은 9시 00분 — 시장 배포 시작. 폴더를 본다. "있네." 그대로 올린다. 3. 그 순간 폴더는 방금 비워진 상태. 0장이 올라간다.

앞의 나흘은 3~4분 뒤 전체 배포가 끝나면서 원래대로 덮였습니다. 그래서 안 보였어요.

7일엔 덮이질 않았어요. 본진 글을 굽는 도중에 이렇게 죽었거든요.

FileNotFoundError: [Errno 2] No such file or directory:
  '.../homebase/site/img/223452817418/05.jpg'

사진 한 장을 옮기다가 넘어진 겁니다. 지우고 다시 짓는 도중이었으니 폴더에는 껍데기만 남았어요. 그 뒤로 30분마다 시장 크론이 그 껍데기를 성실하게 올렸고요.

사진 한 장이 사이트 전체를 내린 셈입니다. 안전장치가 잘못 걸린 것도 아니에요. "중간에 실패하면 멈춘다"는 규칙은 제대로 작동했습니다. 그 규칙은 아무도 그 폴더를 훔쳐보지 않는다는 전제 위에 있었을 뿐이에요.

"폴더가 있으면 됐다"가 아니었습니다

고친 건 두 군데예요.

첫째, 검사 조건을 바꿨습니다. 원래 시장 배포는 올리기 전에 이것만 봤어요.

배포용 폴더가 있는가?

폴더는 있었죠. 비어 있었을 뿐입니다. 지금은 이렇게 봐요.

첫 화면 파일이 있는가? 그리고 글 폴더가 있는가?

둘 다 있어야 '다 지어진 것'으로 봅니다. 하나라도 없으면 안 올리고 이렇게 말하고 멈춰요.

site-all 이 덜 지어졌습니다(index.html·posts 확인). 배포하지 않습니다.
  publish-all.sh 가 도중에 죽었을 수 있습니다. 그걸 먼저 돌리세요.

한 줄 차이인데요, 이 한 줄이 어디서 나오냐면 "폴더가 있다고 다 지어진 게 아니다"를 아는 데서 나옵니다. 그걸 알려면 지우고 다시 짓는 중간 상태가 어떻게 생겼는지를 봤어야 해요. 처음 만들 때는 그런 순간이 있다는 걸 아무도 몰랐습니다.

둘째, 시간을 비켰어요. 시장 크론을 정각에서 치웠습니다. 지금은 15분과 45분에 돌고, 아침 배포가 끝난 뒤인 10시부터 시작해요.

검사 조건이 있으니 겹쳐도 안전하긴 합니다. 그래도 굳이 같은 시각에 둘 이유가 없잖아요. 막을 수 있게 만드는 것과 애초에 안 부딪히게 두는 것은 둘 다 하는 게 맞더라고요. 하나만 믿기엔 그날 아침이 너무 조용했습니다.

그 뒤로 0장 배포는 한 번도 안 나왔어요.

덮어쓰기는 반대편에서도 났습니다

떼어놓으니까 반대 방향 사고도 하나 나왔어요.

시장 배포는 시장 자료 폴더를 통째로 복사합니다. 그런데 전체 배포는 그 화면 아래에 사람이 읽을 설명을 한 덩어리 붙여둬요. 검색엔진이나 광고 심사원이 이 화면을 열면 자바스크립트로 그리는 그래프는 안 보이고 거의 빈 페이지로 읽히거든요.

무슨 일이 벌어졌냐면요. 아침에 붙여둔 설명이, 몇 분 뒤 시장 크론이 한 번 돌면 통째로 날아갔습니다. 하루 수십 번 도는 크론이라 사실상 하루 종일 설명 없는 상태였어요.

이것도 화면상으론 멀쩡합니다. 사람 눈에는 그래프가 잘 보이니까요. 없어진 건 사람이 아니라 기계가 읽는 부분이었어요.

지금은 시장 배포도 마지막에 설명을 다시 붙입니다. 대신 같은 절차가 두 군데에 생겼어요. 한쪽만 고치면 어느 날 사이트가 시각마다 다른 그림을 그리게 됩니다. 그래서 떼어낸 쪽에 메모를 박아뒀어요.

publish-all.sh 의 8-1 과 같은 차례. 두 곳이 어긋나면 사이트가 다른 그림을

그리는 날이 오므로, 고칠 때는 양쪽을 같이 고칠 것.

그런데 이 글을 쓰면서 두 파일을 나란히 열어보고 알았습니다. 메모가 한쪽에만 있어요. 떼어낸 쪽은 본체를 가리키는데, 본체에는 떼어낸 쪽을 가리키는 줄이 한 줄도 없습니다. 그러니까 본체만 열어서 고치는 사람은 저쪽에 같은 절차가 있다는 걸 알 길이 없는 거예요. 하필 그게 더 자주 열어보는 쪽이고요.

메모가 규칙보다 약하다는 건 알고 넣었습니다. 그런데 약한 정도가 아니라 반쪽이었다는 건 몰랐어요. 이런 건 코드를 읽어서는 안 보입니다. 두 파일을 같이 열어 "저쪽을 가리키는 줄이 정말 있나"를 찾아봐야 보여요. "자주 도는 것을 떼어낸다"를 택한 순간 이 중복은 값으로 치른 것이라 없앨 수는 없고, 그렇다면 최소한 양쪽에서 다 보이게 해둬야 했습니다.

올리는 곳이 다르면 못 합쳐요

마지막으로, 절대 못 합치는 게 하나 있습니다.

이건 옛 주소로 들어왔을 때 도착하는 화면이에요. 예전 육아휴직 계산기 주소를 열면 새 주소로 넘어옵니다.

지난 편에서 말씀드렸듯이 옛 주소 여섯 곳에는 표지판만 올라가 있어요. 그 표지판들은 통합 사이트가 아니라 옛 프로젝트 여섯 곳에 각각 올라갑니다. 목적지가 완전히 달라요.

그래서 이건 합칠 수가 없습니다. 같은 폴더를 만드는 일이 아니라 다른 집에 올리는 일이거든요. 게다가 자주 돌 일도 없어요. 표지판은 한 번 세우면 그걸로 끝이니까, 필요할 때만 손으로 돌리는 게 맞습니다.

정리하면 지금 기준이 이래요.

같은 곳에 올리고 같은 주기로 도는 것 → 합친다
같은 곳에 올리지만 훨씬 자주 도는 것 → 떼어낸다
다른 곳에 올리는 것 → 애초에 다른 일이다

"몇 개냐"가 아니라 "왜 나뉘어 있냐"에 답할 수 있으면 된다는 쪽으로 생각이 바뀌었습니다. 여섯 개가 문제였던 건 여섯이라는 숫자가 아니라, 왜 여섯인지를 아무도 설명할 수 없었기 때문이에요.

그래서 사람은 어디에 있었나

AI가 잘한 것. 열몇 개 도구를 한 폴더에 모으는 순서를 짜고, 방마다 광고·버튼·주소를 빠짐없이 붙이고, 실패를 삼키는 예외 처리를 정확한 자리에 넣은 것. 이런 건 정말 빠르고 정확해요. 제가 순서를 외우고 있을 필요가 없어졌습니다.

사람이 붙잡은 것. 네 군데였어요.

첫째, 어디서 멈추고 어디서 건너뛸지 정한 것. 마블은 건너뛰고 계산기는 멈춥니다. 코드로만 보면 둘 다 "실패했을 때 어떻게 할까"라는 똑같은 질문이에요. 답이 갈리는 이유는 한쪽은 틀려도 되고 한쪽은 틀리면 안 되기 때문인데, 그건 코드 안에 안 적혀 있습니다.

둘째, 묶는 기준을 바꾼 것. '도구별'에서 '얼마나 자주 도는가'로요. 도구별로 나누는 건 자연스럽습니다. 폴더가 그렇게 생겼으니까요. 그런데 실제로 아픈 곳은 폴더 모양이 아니라 시간이었어요. 자르는 선을 옮기려면 지금 선이 왜 거기 있는지를 한 번 의심해야 하는데, 그건 잘 돌아가는 걸 굳이 들여다보는 일이라 아무도 시키지 않으면 안 하게 됩니다.

셋째, "성공"을 안 믿은 것. 사이트가 비어 있던 두 시간 동안 배포는 네 번 돌았고 네 번 다 성공으로 찍혔어요. 로그만 봐서는 완벽한 아침이었습니다. 화면을 실제로 열어본 사람만 사이트가 비었다는 걸 압니다. 기계가 보고하는 건 "시킨 일을 했다"지 "결과가 맞다"가 아니더라고요.

넷째, 검사 조건을 한 겹 깊게 만든 것. "폴더가 있는가"에서 "제대로 지어졌는가"로요. 처음 것도 틀린 검사가 아니에요. 그냥 중간 상태를 본 적이 없는 사람이 쓸 법한 검사였을 뿐입니다. 사고를 한 번 겪어야 나오는 줄이 있어요.

그리고 오늘의 교훈 하나. 합치는 건 문제를 없애는 게 아니라 옮기는 일입니다.

여섯 개일 때 문제는 "뭘 빠뜨렸는지 모르겠다"였어요. 한 개로 만드니까 그건 사라졌습니다. 대신 "하나가 넘어지면 전부 못 나간다", "두 개가 같은 폴더를 두고 부딪힌다"가 새로 생겼어요. 그래도 저는 이쪽이 낫다고 생각합니다. 새로 생긴 문제들은 한 군데를 보면 보이는 문제거든요. 전에 것은 여섯 군데를 다 기억해야 보이는 문제였고요.

정답이 있어서 합친 게 아니라, 틀렸을 때 어디를 봐야 하는지 아는 쪽을 고른 겁니다.

다음 편에

배포가 한 번으로 줄고 나니, 그 한 번이 얼마나 무거운지가 보이기 시작했어요.

글 278편에 딸려온 사진이 3천 장이 넘습니다. 그런데 이게 네이버가 쓰던 원본 크기 그대로였어요. 화면에서는 폭을 줄여 보여주면서, 내려받는 건 원본을 통째로 시키고 있었던 거죠.

제 맥에서는 순식간이라 전혀 몰랐습니다. 밖에서 아이패드로 열어보고서야 알았어요. 다음 편은 1GB짜리 사진 더미를 줄인 이야기, 그리고 한글 폴더 이름 하나 때문에 사진이 통째로 안 보이던 얘기입니다.

#배포자동화 #CICD #쉘스크립트 #크론 #cron #클라우드플레어 #CloudflarePages #wrangler #정적사이트 #개인홈페이지 #홈페이지제작 #웹사이트만들기 #무료호스팅 #사이트배포 #에러처리 #장애대응 #롤백 #서비스운영 #1인개발 #사이드프로젝트 #AI코딩 #클로드 #ClaudeCode #바이브코딩 #휴먼인더루프 #AI활용법 #개발일지 #시장지표 #육아휴직계산기 #빅터하우스