🚀 CodePush Standalone 서버 구축 및 사용 가이드 (Azure 기반)

📦 개요

CodePush Standalone 서버를 직접 포크하고 Azure에 배포해서 자체 OTA 배포 시스템 만드는 방법 정리

---

🧰 1. 초기 준비

1. CodePush 서버 포크

   • https://github.com/microsoft/code-push-server

2. 로컬에 클론

   git clone https://github.com/your-username/code-push-server.git

3. Azure CLI 설치

   brew install azure-cli

---

☁️ 2. Azure 리소스 생성

1. 공식 문서 참고해서 Azure 리소스 생성 절차 따라감

2. Azure 구독 설정

   az account set --subscription <subscription-id>

3. 리소스 그룹 생성

   az group create --name <resource-group-name> --location <az-location>

4. Bicep 템플릿으로 리소스 배포

   cd code-push-server/api
   az deployment group create \
     --resource-group <resource-group-name> \
     --template-file ./codepush-infrastructure.bicep \
     --parameters project_suffix=<project-suffix> az_location=<az-location>

   참고로 project-suffix 는 프로젝트 이름을 붙이도록 하자. codepush 는 어짜피 위의 명령어로 리소스 만들 때 prefix 로 붙음.

---

🔐 3. OAuth 설정

1. 배포 도중 GitHub OAuth 관련 입력 나오는데, 아직 서비스 주소가 없으니까 그냥 엔터 치고 넘어감

2. Azure Portal 접속 → 웹앱 → 배포 > 배포 센터 > 설정 들어가서 Git 연결 끊고 처음에 포크한 코드푸시 서버 레포지토리를 연결

3. 조직 선택 안 뜨는 문제 해결

   • 기존에 azure 를 사용하고있었다면 새로운 organization 이 안나올 수 있음.
   • 기존 사용하고있던 깃허브 계정에서 Integrations > Applications > Authorized OAuth Apps 에서 azure 를 해제한 후 azure 콘솔에서 다시 권한 요청
   • 이때 원하는 조직 꼭 체크해야 함

---

🛠️ 4. 배포 후 오류 대응

1. 배포 실패할 수 있음. 원인은 package.json이 api 폴더 안에 있어서 루트 기준으로 npm 실행될 경우 깨짐

2. 윈도우용 명령어 들어있는 스크립트는 일반 리눅스 환경에 맞게 바꿔야 함
   
   
   

---

⚙️ 5. 빌드가 안되는 경우 -> 웹앱 서비스에 원격으로 접속하여 확인

cd code-push-server/api
npm install
npm run build
npm start

8080 포트 충돌하면 Azure에서 앱 재시작하거나 포트 변경하면 됨

---

6. CLI 설치

1. 클론 받은 code-push-server/cli 에서

npm install

npm run build

npm install -g .

code-push-standalone --version

---

🔑 7. GitHub OAuth 클라이언트 등록

code-push-server/api/README.md 참고해서 GitHub OAuth Client ID/Secret 생성함

등록 후 CLI에서 아래처럼 사용함

code-push-standalone register https://your-app.azurewebsites.net/
code-push-standalone login https://your-app.azurewebsites.net/

---

🧪 8. CLI 사용법 예시

릴리즈

code-push-standalone release-react <App name> --dev

배포 상태 확인

code-push-standalone deployment ls <App name>

#or

code-push-standalone release ls <App name>

최근 릴리즈 된 기록 확인

code-push-standalone deployment history <App name> Staging --numReleases 50

deployment key 확인

code-push-standalone deployment ls <App name> -k

disable

# 가장 최신 버전 비활성화
code-push-standalone patch <App name> Staging --disabled true

#or

# 예시: Staging 배포에서 v5 릴리즈 비활성화
code-push-standalone patch <App name> Staging v5 --disabled

# Production 배포에서 비활성화
code-push-standalone patch <App name> Production v5 --disabled