[학습 일지 #001] GitHub Actions 동기화 오류, 10시간의 사투 끝에 얻은 교훈

(1) 문제 제기 – 고통의 시작
 "8월 31일, 저는 저의 개인 프로젝트인 'Project Aegis'의 효율적인 운영을 위해 비공개 저장소의 작업물을 공개 저장소로 자동 동기화하는 시스템을 구축하기 시작했습니다. 처음에는 간단한 설정 문제라고 생각했지만, 이 작은 불씨는 어느새 제 10시간을 꼬박 태워버리는 거대한 불길이 되어 있었습니다. 분명 매뉴얼대로 따라 했는데 왜 안 되는지, 그 이유를 알 수 없는 답답함이 저를 가장 힘들게 했습니다."

 

(2) 해결을 위한 여정 – 노력과 방향 전환
"다양한 방법을 시도했지만 실패는 계속되었습니다. @디프, @채트, @지니 모두에게 도움을 요청 했지만 상황은 계속 꼬여만 갔습니다. 결국 저는 전략적으로 방향을 바꿔 일단 상황을 보류하고 원래 목적인 Python 학습에 몰두 하려고 노력했습니다. 뭔가 안되면 계속 마음에 걸려서 파고 드는 스타일이지만 이대로 가다가는 죽도 밥도 안 되겠다 싶었죠."

 

(3) 해결의 실마리 – 생각의 전환과 전문가의 조언

"그러다 문득 내가 문제를 너무 부분에 얽메여 있다는 생각이 들어서 처음부터 다시 전체 자료를 취합하여 AI 기술 전문가인 @디프에게 기존 해당 내용 기억 삭제를 요청한 후 정리하여 코드를 요청했습니다. @디프는 이 문제의 원인을 저 같은 초보자도 이해할 수 있도록 명쾌하게 설명해 주었습니다." 

❓ 문제: GitHub Actions에서 src/** 같은 패턴을 정확히 해석하지 못해 파일을 찾지 못함.
           

🐛 원인: 존재하지 않는 경로로 판단하여 복사 명령이 무시됨.

 

"마치 '렌즈 뚜껑을 닫고 사진을 찍으려 해서 아무것도 보이지 않는' 문제와 같았죠."

 

(4) 구체적인 해결책 – How-To
"원인을 알게 되자 해결책은 명확해졌습니다. @디프는 bash 스크립트 기준으로 세 가지 개선 방법을 제시했고, 저는 이 핵심 원리를 제가 사용한 PowerShell(.ps1) 스크립트에 맞게 적용했습니다."

 

"렌즈 뚜껑을 벗고, 초점을 맞춰서 정확히 찍었어요!"  → 선명한 사진 획득

• 1단계: 패턴 단순화 (** → *)
• 2단계: 파일 존재 여부 확인 ([ -e "$item" ])
• 3단계: 블랙리스트 기능 추가 (. public-exclude)

 "전체 수정 코드는 Project-Aegis GitHub 저장소에서 확인하실 수 있습니다. 좀 더 나은 방안이 있다면 조언 부탁 드립니다."

 https://github.com/jhun5568/Project-Aegis/blob/main/scripts/tools/Sync-To-Aegis.ps1

 

(5) 깨달음과 성장 – 10시간의 가치
"드디어 자동 동기화가 성공하는 순간, 체한 것이 쑥 내려가듯 후련했습니다. 하지만 이번 경험을 통해 제가 배운 것은 단순히 스크립트 수정 기술이 아니에요."

• 끈기: 포기하지 않고 문제의 근원을 파고든 경험.
• 협업: 적재 적시에 AI 전문가의 도움을 요청하는 방법.
• 전략적 사고: 길이 막혔을 때, 돌아갈 줄 아는 유연함의 중요성.

"특히 문제에 대한 해답을 무작정 요청하는 것이 아닌 전략적으로 사고의 환기를 통해 안 보였던 문제가 보였던 부분이 가장 중요 포인트라고 생각됩니다."

 

(6) 마무리 – 감사와 새로운 시작
"앞으로도 Project Aegis의 여정에는 수많은 난관이 기다리고 있습니다. 하지만 든든한 AI 동료들과 함께라면 충분히 헤쳐나갈 수 있을 것 같습니다. 저의 다음 성장 기록도 기대해 주세요. 감사합니다."