본문 바로가기
스터디 열기

GitHub과 위니버시티 배포 잇기

GitHub 공개 저장소에 올린 코드는 위니버시티 배포의 [GitHub에서 가져오기]로 바로 배포할 수 있습니다. push한다고 저절로 다시 배포되지는 않으므로, 고친 뒤에는 앱 관리 화면의 [GitHub에서 다시 가져오기]를 누릅니다. 이 절에서는 GitHub에 올린 코드를 위니버시티 배포로 가져와 배포하는 방법을 다룹니다. 처음에는 버튼 한 번으로 가져오고, 고칠 때마다 다시 가져오는 흐름을 익힙니다. 마지막으로 심화 과정으로 GitHub에 올리기만 하면 자동으로 배포되게 만드는 방법을 소개합니다.

예전에는 이 절에서 무엇을 했나요?

이 책의 처음 판에서 이 절의 제목은 'GitHub Pages로 동적 서비스 구현'이었습니다. GitHub Pages는 웹페이지만 올릴 수 있어서, 예약이나 방명록처럼 데이터를 저장해야 하는 서비스는 Google Sheets와 Apps Script를 데이터베이스처럼 붙여 흉내 냈습니다. 지금은 위니버시티 배포에 서버가 있는 앱을 바로 올릴 수 있으므로 그런 우회가 필요 없습니다. "예약 내용을 저장해 줘"라고 말하면 Claude가 서버와 저장 기능까지 만들고, 그대로 배포하면 됩니다.

GitHub을 거쳐 배포하는 흐름은 세 단계로 나뉩니다.

1. GitHub에서 가져오기

05-2에서 GitHub에 올린 저장소를 위니버시티 배포로 가져와 보겠습니다.

  1. 학습 도구 > 배포 > 새로 배포로 갑니다.
  2. 1. 주소에 쓸 이름은 비워 둬도 됩니다. 비어 있으면 저장소 이름이 들어갑니다. 저장소 이름에 대문자나 밑줄(_)이 있어 이름 규칙에 맞지 않으면 직접 적습니다.
  3. 2. 프로젝트 고르기에서 [GitHub에서 가져오기]를 누릅니다.
  4. 저장소 주소 칸에 https://github.com/아이디/저장소를 넣고 [가져오기]를 누릅니다. 공개 저장소만 가져올 수 있습니다.
  5. 칸에 'GitHub 아이디/저장소'와 브랜치, 파일 개수, 크기가 보이면 [배포하기]를 누릅니다.

배포 서버는 가져오기 창에서 확인한 그 시점의 코드를 GitHub에서 직접 받아 배포합니다. 앱 관리 화면의 배포 기록에는 배포 방법이 'GitHub'로 남습니다.

한 저장소에 프론트엔드와 백엔드를 나눠 두었다면

위니버시티 배포는 폴더 하나에 앱 하나를 올립니다. 저장소 맨 위 폴더에 index.html, package.json, requirements.txt가 없으면 "배포할 폴더를 골라 주세요"라는 안내와 함께 폴더 후보가 보입니다. 접혀 있는 '브랜치·폴더 바꾸기'를 펼치면 브랜치와 배포할 폴더를 직접 고를 수도 있습니다.

크기 한도는 폴더 업로드와 같은 100MB입니다. 비공개 저장소는 가져올 수 없으니, 비공개로 두고 싶은 코드는 05-1처럼 폴더나 ZIP으로 올리거나 Claude Code에서 "배포해줘"라고 합니다.

2. 고친 뒤 다시 가져오기

위니버시티 배포는 GitHub에 push했다고 저절로 다시 배포하지 않습니다. 고친 내용을 배포하려면 앱 관리 화면에서 버튼을 한 번 눌러야 합니다.

  1. Claude Code에서 고치고 "GitHub에 올려줘"라고 합니다.
  2. 학습 도구 > 배포 > 내 앱에서 앱을 눌러 앱 관리 화면으로 갑니다.
  3. '가져온 곳' 칸에 지금 버전의 커밋이 보입니다. 머리의 [GitHub에서 다시 가져오기]를 누르면 최신 커밋으로 새 버전을 배포합니다.

실패하면 지금 버전이 그대로 남습니다. 한 가지 주의할 점은, 중간에 폴더·ZIP 업로드나 [파일 보기·고치기]로 새 버전을 올리면 '가져온 곳'과 [GitHub에서 다시 가져오기] 버튼이 사라진다는 것입니다. 그때는 [새 버전 배포]에서 [GitHub에서 가져오기]를 다시 하면 됩니다. GitHub과 이어 쓰기로 했다면 고치는 곳도 GitHub 쪽 하나로 정해 두는 편이 헷갈리지 않습니다.

이 흐름의 좋은 점은 코드의 원본이 GitHub에 한 벌로 모인다는 것입니다. 무엇을 언제 바꿨는지 GitHub에 남고, 배포는 그 기록 중 하나를 가져다 올리는 일이 됩니다. 노트북을 바꾸거나 다른 사람과 함께 고칠 때도 GitHub만 보면 됩니다.

3. 심화: push하면 자동으로 배포하기

버튼 누르는 것도 번거롭다면 GitHub Actions를 쓸 수 있습니다. GitHub Actions는 저장소에 무슨 일이 생길 때(예: push) 정해 둔 작업을 GitHub이 대신 실행해 주는 기능입니다.

먼저 알아 둘 점이 있습니다. 위니버시티 배포에는 'push하면 자동으로 배포'하는 버튼이 따로 없습니다. 여기서 소개하는 방법은 위니버시티의 공식 자동 배포 기능이 아니라, 위니버시티 배포의 명령줄 배포 도구와 연결 키를 GitHub Actions에서 이용하는 방법입니다. 그래서 심화로 둡니다. 처음에는 앞의 [GitHub에서 다시 가져오기]로 충분합니다.

설정 파일을 직접 쓸 필요는 없습니다. Claude Code에게 맡깁니다.

GitHub의 main 브랜치에 push하면 위니버시티 배포에 my-intro 이름으로 자동 배포되게 GitHub Actions를 만들어 줘.
연결 키는 저장소 Secret의 WECLOUD_TOKEN에서 읽게 하고, 키를 파일에 직접 쓰지는 마.

Claude는 .github/workflows/ 폴더에 아래와 비슷한 파일을 만듭니다.

name: 위니버시티에 배포
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: actions/setup-node@v7
        with:
          node-version: 24
      - run: npx -y https://cloud.wenivops.co.kr/cli/wecloud-0.1.0.tgz deploy --name my-intro
        env:
          WECLOUD_TOKEN: ${{ secrets.WECLOUD_TOKEN }}

읽을 줄 몰라도 됩니다. "main에 push되면, 코드를 받고, Node.js를 준비한 뒤, 위니버시티 배포 도구로 my-intro에 배포한다"는 뜻입니다. 2026년 11월 기준 actions/checkout과 actions/setup-node의 최신 주 버전은 v7이고, Node.js는 지원 중인 LTS 버전인 24를 썼습니다. 2026년 10월 28일부터는 Node.js 26도 LTS가 되었으니 node-version: 26으로 바꿔도 됩니다. Claude가 만든 파일의 버전 숫자가 이와 다르면 "GitHub Actions와 Node.js 버전을 지금 기준 최신으로 맞춰 줘"라고 하면 됩니다.

사람이 해야 할 일은 연결 키를 GitHub에 안전하게 넣는 것 하나입니다.

  1. 학습 도구 > 배포 > AI 도구 연결에서 '깃허브 자동 배포'처럼 알아볼 이름으로 연결 설정을 새로 만듭니다. 화면에 나온 내용 중 연결 키 부분을 복사해 둡니다.
  2. GitHub 저장소의 Settings > Secrets and variables > Actions로 가서 New repository secret을 누릅니다.
  3. Name에 WECLOUD_TOKEN, Secret에 연결 키를 넣고 저장합니다.
  4. 워크플로 파일까지 GitHub에 올립니다.
  5. 처음 한 번은 두 곳을 함께 보고 잘 올라갔는지 확인합니다. 저장소의 Actions 탭에서 방금 실행된 기록이 성공으로 끝났는지 보고, 위니버시티 앱 관리 화면의 배포 기록에 배포 방법이 'CLI'인 새 버전이 생겼는지 봅니다. 둘 다 맞으면 그다음부터는 push만 하면 됩니다.

자동 배포를 쓸 때 기억할 것

  • 연결 키는 코드나 워크플로 파일에 쓰지 않고 Secret에만 넣습니다.
  • 연결 키는 180일 동안 쓸 수 있습니다. 180일마다 AI 도구 연결에서 연결 키를 새로 만들어 GitHub Secret의 WECLOUD_TOKEN 값을 바꿔 넣어야 합니다. 바꾸지 않으면 그날부터 자동 배포가 실패합니다.
  • 배포가 실패하면 GitHub Actions 탭의 기록이나 위니버시티 앱 관리 화면의 배포 기록을 Claude에게 보여 주고 고쳐 달라고 합니다.

4. 어떤 길을 고를까

상황추천
처음 배포해 본다, 혼자 짧게 만든다폴더·ZIP 올리기 또는 Claude Code에서 "배포해줘"(05-1)
코드를 오래 보관하며 고쳐 나간다GitHub에 올리고 [GitHub에서 가져오기], 고치면 [GitHub에서 다시 가져오기]
자주 고치고, 올릴 때마다 배포하고 싶다GitHub Actions 자동 배포
내 도메인 주소로 공개하고 싶다위니버시티 배포는 커스텀 도메인을 지원하지 않으므로 05-5의 GitHub Pages

어느 길을 고르든 "배포해줘", "GitHub에 올려줘"처럼 말로 시작하면 됩니다. 명령과 설정은 Claude가 맡고, 우리는 주소에 들어가 원하는 대로 동작하는지 확인합니다.

마지막 수정