모바일 워크스페이스를 백엔드 없이 GitHub에 직접 동기화하는 방법

Source: Dev.to

Overview

모바일 기기에서 본격적인 개발 작업을 해본 적이 있다면—웹 앱을 만들든 Termux에서 파이썬 스크립트를 실행하든—이동 중에 버전 관리를 하는 것이 얼마나 악몽 같은 일인지 알게 될 것입니다.

휴대폰에서 코드를 작성하는 것은 쉬운 일입니다. 하지만 수백 개의 파일, 중첩된 폴더, 그리고 자산을 모바일 웹 브라우저를 통해 GitHub 저장소에 푸시하려고 하면? 보통 충돌, 페이로드 제한, 그리고 엄청난 좌절감만 남습니다.

모바일 브라우저와 싸우는 데 지쳐서, 마찰 없이 비용도 들지 않는 솔루션을 만들었습니다.

바로 DemonZ Deployer 입니다.

⚡ 개념: 서버리스 워크스페이스 동기화

DemonZ Deployer는 표준 브라우저 업로드 제한을 완전히 우회하는 하이브리드 배포 엔진입니다.

파일을 하나씩 업로드하는 대신, 모바일 워크스페이스를 단일 workspace.zip 파일로 압축합니다. 이 바이너리를 보안 웹 인터페이스를 통해 업로드하면 GitHub Action이 자동으로 압축을 풀고, 검증하고, 구조적 변화를 백그라운드에서 직접 저장소에 커밋합니다.

• 맞춤형 백엔드 없음.
• 데이터베이스 없음.
• 호스팅 비용 없음.
• 오직 GitHub REST API와 GitHub Actions만 사용.

🏗️ 아키텍처 작동 방식

인터페이스 (100% 클라이언트 측)

프런트엔드는 GitHub Pages에 호스팅된 정적 웹 앱이며, 터치 스크린에 최적화된 세련된 글래스모피즘 UI를 사용합니다.

인증

GitHub Personal Access Token(PAT)을 입력하도록 요청합니다. 이 토큰은 브라우저의 localStorage에만 저장됩니다. 앱은 api.github.com에 직접 API 호출을 하므로, 자격 증명이 제3자 서버에 전송되지 않습니다.

페이로드

workspace.zip을 UI에 드롭하면 바이너리를 Base64로 인코딩하고 대상 저장소에 PUT 요청을 실행합니다.

엔진

대상 저장소 내부에 가벼운 GitHub Actions 워크플로(deployer-pipeline.yml)가 해당 zip 파일의 변화를 감시합니다. 페이로드를 감지하면 러너가 깨어나 압축을 풀고, 기존 파일을 덮어쓰며, 아카이브를 삭제하고, 변경 사항을 깔끔하게 커밋합니다.

🚀 직접 사용해 보기

사용하기 위해 별도로 설치할 것이 전혀 없습니다. 인터페이스는 중앙에서 무료 SaaS 도구로 호스팅됩니다.

단계 1: 레포 준비

이 공식 GitHub Actions 워크플로 파일을 동기화하려는 저장소의 .github/workflows/ 폴더에 넣으세요.

단계 2: 배포

DemonZ Deployer Web App 으로 이동합니다.
레포 이름을 입력하고 PAT를 붙여넣은 뒤 zip 파일을 업로드하세요. 터미널 UI가 실시간으로 배포 과정을 스트리밍하는 것을 확인할 수 있습니다.

🤝 함께 협업해요

저는 DemonZ Development 아래에서 Android 및 제한된 디바이스에서 개발하는 개발자들의 큰 불편을 해소하기 위해 이 도구를 만들었습니다.

전체 소스 코드와 문서는 여기에서 확인하세요:

🔗 DemonZ Deployer GitHub Repository

이 아키텍처가 유용하다고 생각하시면 피드백을 알려주시고, 풀 리퀘스트를 보내주시거나, 저장소에 ⭐ 하나만 눌러 주세요! 아래 댓글에 의견을 남겨 주세요.