fix: repair deploy image build (#32)

Author: peterabcd

.github/workflows/deploy.yml

@@ -82,34 +82,44 @@ jobs:
           cache-to: type=gha,mode=max
 
   # ---------------------------------------------------------------------------
-  # 2) SSH 로 N100 접속 → docker compose pull && up -d
+  # 2) N100 SSH secrets 준비 여부 확인. 미등록이면 이미지 build/push 까지만 하고 deploy 는 skip.
+  # ---------------------------------------------------------------------------
+  deploy-preflight:
+    name: Check deploy secrets
+    runs-on: ubuntu-latest
+    timeout-minutes: 3
+    outputs:
+      deploy_ready: ${{ steps.secrets.outputs.deploy_ready }}
+    steps:
+      - name: Check N100 secrets
+        id: secrets
+        run: |
+          if [ -n "$N100_HOST" ] && [ -n "$N100_USER" ] && [ -n "$N100_SSH_KEY" ]; then
+            echo "deploy_ready=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "deploy_ready=false" >> "$GITHUB_OUTPUT"
+            echo "::notice::N100 deploy secrets are not configured yet. Image build/push completed; SSH deploy is skipped."
+          fi
+        env:
+          N100_HOST: ${{ secrets.N100_HOST }}
+          N100_USER: ${{ secrets.N100_USER }}
+          N100_SSH_KEY: ${{ secrets.N100_SSH_KEY }}
+
+
+  # ---------------------------------------------------------------------------
+  # 3) SSH 로 N100 접속 → docker compose pull && up -d
   # ---------------------------------------------------------------------------
   deploy:
     name: Deploy to ${{ needs.build.outputs.target }}
-    needs: build
+    needs: [build, deploy-preflight]
+    if: needs.deploy-preflight.outputs.deploy_ready == 'true'
     runs-on: ubuntu-latest
     timeout-minutes: 10
     # prod 는 환경(environment) 보호로 수동 승인 가능
     environment:
       name: ${{ needs.build.outputs.target }}
 
     steps:
-      - name: Sanity check secrets
-        run: |
-          missing=""
-          for v in N100_HOST N100_USER N100_SSH_KEY; do
-            eval val="\$$v"
-            if [ -z "$val" ]; then missing="$missing $v"; fi
-          done
-          if [ -n "$missing" ]; then
-            echo "::error::Missing required secrets:$missing"
-            echo "GitHub repo Settings → Secrets and variables → Actions 에서 등록하세요."
-            exit 1
-          fi
-        env:
-          N100_HOST: ${{ secrets.N100_HOST }}
-          N100_USER: ${{ secrets.N100_USER }}
-          N100_SSH_KEY: ${{ secrets.N100_SSH_KEY }}
 
       - name: Pull & restart on N100
         uses: appleboy/ssh-action@v1.0.3
@@ -118,11 +128,12 @@ jobs:
           username: ${{ secrets.N100_USER }}
           key: ${{ secrets.N100_SSH_KEY }}
           # 호스트의 deploy/ 디렉터리에서 pull → up.
-          # IMAGE_TAG 가 .env 의 placeholder 를 덮어쓰며 docker compose 가 사용.
+          # IMAGE_TAG selects the pushed GHCR image; MURUN_ENV_FILE selects .env.staging/.env.prod.
           script: |
             set -e
             cd ${MURUN_DEPLOY_DIR:-~/murun-peterabcd/deploy}
             export IMAGE_TAG="${{ needs.build.outputs.image_tag }}"
-            docker compose -p murun-${{ needs.build.outputs.target }} pull
-            docker compose -p murun-${{ needs.build.outputs.target }} up -d --remove-orphans
+            export MURUN_ENV_FILE=".env.${{ needs.build.outputs.target }}"
+            docker compose -p murun-${{ needs.build.outputs.target }} --env-file "$MURUN_ENV_FILE" pull
+            docker compose -p murun-${{ needs.build.outputs.target }} --env-file "$MURUN_ENV_FILE" up -d --remove-orphans
             docker image prune -f

deploy/Dockerfile

@@ -20,6 +20,7 @@ RUN apk add --no-cache openssl libc6-compat
 RUN corepack enable
 COPY --from=deps /app/node_modules ./node_modules
 COPY . .
+RUN mkdir -p public
 ENV NEXT_TELEMETRY_DISABLED=1
 ENV NEXT_OUTPUT_STANDALONE=true
 

deploy/README.md

@@ -23,6 +23,9 @@ cp .env.example .env.prod
 echo "<PAT_with_read:packages>" | docker login ghcr.io -u <github_user> --password-stdin
 
 # 4) 첫 가동 (이미지 빌드는 GH Actions 가 대신, 여기선 pull 만)
+export MURUN_ENV_FILE=.env.staging
+export IMAGE_TAG=staging
+
 docker compose -p murun-staging --env-file .env.staging pull
 docker compose -p murun-staging --env-file .env.staging up -d
 ```
@@ -45,6 +48,8 @@ gh secret set N100_HOST --body "<ip-or-domain>"
 gh secret set N100_USER --body "<user>"
 ```
 
+Secrets 가 아직 없으면 GitHub Actions 는 GHCR 이미지 build/push 까지만 성공 처리하고, SSH deploy job 은 skip 된다. N100 준비 후 위 3개 secret 을 넣으면 다음 dev push 부터 staging deploy 까지 진행된다.
+
 ### (옵션) prod environment 보호
 
 main 으로의 자동 배포 전에 수동 승인이 필요하면 Settings → Environments → "prod" 생성 후 "Required reviewers" 본인 추가.
@@ -60,9 +65,9 @@ cd murun-peterabcd/deploy
 cp .env.example .env
 # (도메인 붙기 전엔 DOMAIN=:80 그대로 두기)
 
-# app 환경변수 (지금은 비어 있어도 OK, 후속 PR에서 채워짐)
-touch .env       # app 서비스 env_file 이 ./.env 라서 같은 파일이 두 용도 겸함
-                 # — 추후 app.env 로 분리 예정
+# compose 변수와 app 환경변수를 같은 파일에서 읽음
+# 기본 수동 실행은 .env, staging/prod 분리는 MURUN_ENV_FILE 로 지정
+
 
 # 빌드 + 기동
 docker compose up -d --build
@@ -77,7 +82,7 @@ curl -fsS http://localhost/ && echo OK
 cd murun-peterabcd
 git pull
 cd deploy
-docker compose up -d --build
+MURUN_ENV_FILE=.env docker compose --env-file .env up -d --build
 docker image prune -f
 ```
 
@@ -86,11 +91,11 @@ docker image prune -f
 같은 디렉터리에 `.env.staging`, `.env.prod` 를 별도로 두고 project name 으로 분리.
 
 ```bash
-# staging (포트 8080)
-CADDY_HTTP_PORT=8080 docker compose -p murun-staging --env-file .env.staging up -d --build
+# staging (포트 8080; .env.staging 안에 CADDY_HTTP_PORT=8080 권장)
+MURUN_ENV_FILE=.env.staging docker compose -p murun-staging --env-file .env.staging up -d --build
 
 # prod (포트 80)
-docker compose -p murun-prod --env-file .env.prod up -d --build
+MURUN_ENV_FILE=.env.prod docker compose -p murun-prod --env-file .env.prod up -d --build
 ```
 
 볼륨은 project name prefix 가 자동으로 붙어 분리됨 (`murun-staging_data` vs `murun-prod_data`).
@@ -109,10 +114,10 @@ docker compose -p murun-prod --env-file .env.prod up -d --build
 
 ```bash
 # 직전 이미지 태그 확인
-docker images ghcr.io/boostcampwm-snu-2026-1/murun --format '{{.Tag}}\t{{.CreatedAt}}'
+docker images ghcr.io/boostcampwm-snu-2026-1/murun-peterabcd --format '{{.Tag}}\t{{.CreatedAt}}'
 
 # 특정 태그로 되돌리기
-IMAGE_TAG=<sha> docker compose up -d
+IMAGE_TAG=<tag> MURUN_ENV_FILE=.env.staging docker compose --env-file .env.staging up -d
 ```
 
 ## 6. 트러블슈팅

deploy/docker-compose.yml

@@ -17,10 +17,10 @@ services:
     build:
       context: ..
       dockerfile: deploy/Dockerfile
-    image: ghcr.io/boostcampwm-snu-2026-1/murun:${IMAGE_TAG:-local}
+    image: ghcr.io/boostcampwm-snu-2026-1/murun-peterabcd:${IMAGE_TAG:-local}
     restart: unless-stopped
     env_file:
-      - ./.env
+      - ${MURUN_ENV_FILE:-.env}
     volumes:
       - data:/app/data
       - uploads:/app/uploads

docs/wiki/02-Tech-Stack.md

@@ -154,7 +154,7 @@ murun-peterabcd/
 ```
 
 - staging/prod 분리: 같은 이미지를 `-p murun-staging` / `-p murun-prod` 다른 project name으로 동시에. 볼륨·포트·서브도메인 전부 분리.
-- 빌드는 GitHub Actions에서 → `ghcr.io/boostcampwm-snu-2026-1/murun:<sha>` 로 push. N100은 pull만.
+- 빌드는 GitHub Actions에서 → `ghcr.io/boostcampwm-snu-2026-1/murun-peterabcd:<target-sha>` 로 push. N100은 pull만.
 
 ## 6. 채택하지 않은 것
 

docs/wiki/Retrospective-Week2.md

@@ -74,7 +74,7 @@ AI 가 실제 브라우저를 못 클릭하는 건 사실이다. 그렇다고 
 
 - 이번 PR 의 CI 워크플로우 — PR 마다 typecheck/lint/build 자동. 솔로 프로젝트지만, "내가 매번 로컬에서 돌리는 단계" 를 GH 가 대신 해주는 게 안전망.
 - 이번 PR 의 Deploy 워크플로우 — dev push → ghcr.io build → SSH → N100 staging 자동. main 은 environment 보호 후 수동 승인.
-- SSH key + N100_HOST 등 secrets 등록은 호스트(나) 의 책임. README 에 절차가 있고, 등록 안 된 채 workflow 실행 시 sanity check 가 명확히 막아준다.
+- SSH key + N100_HOST 등 secrets 등록은 호스트(나) 의 책임. README 에 절차가 있고, 등록 전에는 이미지 build/push 까지만 성공시키고 SSH deploy 는 skip 하도록 했다.
 
 남은 호스트 작업:
 - N100 에서 첫 `docker compose up -d` 직접 — 코드의 진짜 검증