❗[버그][CICD] SIMPLE 워크플로우 중복 트리거로 deploy 브랜치 배포 실패

[Cassiiopeia]

🗒️ 설명

• deploy 브랜치에 push 시 두 개의 워크플로우가 동시에 트리거되어 배포가 실패합니다.
  • PROJECT-SPRING-SYNOLOGY-MAPSEE-CICD.yaml (올바른 설정, PROJECT_NAME: "mapsy-back")
  • PROJECT-SPRING-SYNOLOGY-SIMPLE-CICD.yaml (잘못된 설정, PROJECT_NAME: "project")
• SIMPLE 워크플로우가 PROJECT_NAME: "project"로 실행되면서 존재하지 않는 Docker 이미지(project-back-container:deploy)를 pull하려 시도하여 SSH 배포 스텝에서 실패합니다.
• SIMPLE 워크플로우의 볼륨 마운트 경로도 /volume1/projects/project로 되어 있어 실제 서버 경로 /volume1/projects/mapsy/backend와 일치하지 않습니다.

🔄 재현 방법

1. deploy 브랜치에 push (또는 merge)
2. GitHub Actions에서 PROJECT-SPRING-SYNOLOGY-CICD 워크플로우 2개가 동시에 실행됨
3. SIMPLE 워크플로우의 원격 서버 배포 job에서 appleboy/ssh-action 스텝이 실패

📸 참고 자료

• 실패한 Run: Merge remote-tracking branch 'origin/main' into deploy #9
• 실패 로그에서 PROJECT_NAME="project" 확인 (SIMPLE 워크플로우)
• 관련 워크플로우 파일:
  • .github/workflows/PROJECT-SPRING-SYNOLOGY-SIMPLE-CICD.yaml
  • .github/workflows/PROJECT-SPRING-SYNOLOGY-MAPSEE-CICD.yaml

✅ 예상 동작

• deploy 브랜치 push 시 MAPSEE CICD 워크플로우만 실행되어야 합니다.
• Docker 이미지 mapsy-back-back-container:deploy가 정상적으로 pull 및 배포되어야 합니다.
• 볼륨 마운트 경로가 서버의 /volume1/projects/mapsy/backend와 일치해야 합니다.

⚙️ 환경 정보

• 배포 서버: Synology NAS (SSH 포트 2022)
• 서버 프로젝트 경로: /volume1/projects/mapsy/backend
• 워크플로우: GitHub Actions (appleboy/ssh-action@v1.0.3)

🙋‍♂️ 담당자

• 백엔드: @Cassiiopeia
• 프론트엔드: 이름
• 디자인: 이름

[Cassiiopeia]

Guide by SUH-LAB

브랜치

20260223_#38_SIMPLE_워크플로우_중복_트리거로_deploy_브랜치_배포_실패

커밋 메시지

SIMPLE 워크플로우 중복 트리거로 deploy 브랜치 배포 실패 : feat : {변경 사항에 대한 설명} https://github.com/MapSee-Lab/MapSy-BE/issues/38

[Cassiiopeia]

❗[버그][CICD] SIMPLE 워크플로우 중복 트리거로 deploy 브랜치 배포 실패

🗒️ 설명

• deploy 브랜치에 push 시 두 개의 워크플로우가 동시에 트리거되어 배포가 실패합니다.
  • PROJECT-SPRING-SYNOLOGY-MAPSEE-CICD.yaml (올바른 설정, PROJECT_NAME: "mapsy-back")
  • PROJECT-SPRING-SYNOLOGY-SIMPLE-CICD.yaml (잘못된 설정, PROJECT_NAME: "project")
• SIMPLE 워크플로우가 PROJECT_NAME: "project"로 실행되면서 존재하지 않는 Docker 이미지(project-back-container:deploy)를 pull하려 시도하여 SSH 배포 스텝에서 실패합니다.
• SIMPLE 워크플로우의 볼륨 마운트 경로도 /volume1/projects/project로 되어 있어 실제 서버 경로 /volume1/projects/mapsy/backend와 일치하지 않습니다.

🔄 재현 방법

1. deploy 브랜치에 push (또는 merge)
2. GitHub Actions에서 PROJECT-SPRING-SYNOLOGY-CICD 워크플로우 2개가 동시에 실행됨
3. SIMPLE 워크플로우의 원격 서버 배포 job에서 appleboy/ssh-action 스텝이 실패

📸 참고 자료

• 실패한 Run: Merge remote-tracking branch 'origin/main' into deploy #9
• 실패 로그에서 PROJECT_NAME="project" 확인 (SIMPLE 워크플로우)
• 관련 워크플로우 파일:
  • .github/workflows/PROJECT-SPRING-SYNOLOGY-SIMPLE-CICD.yaml
  • .github/workflows/PROJECT-SPRING-SYNOLOGY-MAPSEE-CICD.yaml

✅ 예상 동작

• deploy 브랜치 push 시 MAPSEE CICD 워크플로우만 실행되어야 합니다.
• Docker 이미지 mapsy-back-back-container:deploy가 정상적으로 pull 및 배포되어야 합니다.
• 볼륨 마운트 경로가 서버의 /volume1/projects/mapsy/backend와 일치해야 합니다.

⚙️ 환경 정보

• 배포 서버: Synology NAS (SSH 포트 2022)
• 서버 프로젝트 경로: /volume1/projects/mapsy/backend
• 워크플로우: GitHub Actions (appleboy/ssh-action@v1.0.3)

🙋‍♂️ 담당자

• 백엔드: 이름
• 프론트엔드: 이름
• 디자인: 이름

[Cassiiopeia]

Stable 반영 완료 이슈 완료처리합니다

[Cassiiopeia]

📌 작업 개요

deploy 브랜치에 push 시 PROJECT-SPRING-SYNOLOGY-SIMPLE-CICD와 PROJECT-SPRING-SYNOLOGY-MAPSEE-CICD 두 워크플로우가 동시에 트리거되어, SIMPLE 워크플로우가 잘못된 설정(PROJECT_NAME: "project")으로 실행되면서 SSH 배포 스텝에서 실패하는 버그 수정. 추가로 MAPSEE 워크플로우의 볼륨 마운트 경로를 실제 서버 경로(/volume1/projects/mapsy/backend)에 맞게 수정.

🔍 문제 분석

중복 트리거 문제:

• SIMPLE-CICD.yaml과 MAPSEE-CICD.yaml 모두 on.push.branches에 deploy가 등록되어 있어 동시 실행
• SIMPLE 워크플로우의 PROJECT_NAME: "project" (기본값 그대로) → Docker 이미지 project-back-container:deploy pull 시도 → 존재하지 않아 실패
• MAPSEE 워크플로우는 PROJECT_NAME: "mapsy-back"으로 정상 설정되어 있으나, SIMPLE이 함께 실행되면서 GitHub Actions에 실패 표시

볼륨 마운트 경로 불일치:

• 기존 MAPSEE 워크플로우: ENABLE_VOLUME_MOUNT: "false" (비활성화 상태)
• 기존 볼륨 마운트 로직이 VOLUME_HOST_PATH/${PROJECT_NAME} 형태로 경로를 조합하여, 활성화하더라도 /volume1/projects/mapsy/mapsy-back이 되어 실제 서버 경로 /volume1/projects/mapsy/backend와 불일치

실패 로그 확인:

• 실패한 Run: Merge remote-tracking branch 'origin/main' into deploy #9
• 로그에서 PROJECT_NAME="project" 출력 → SIMPLE 워크플로우에서 실행된 것 확인

✅ 구현 내용

1. SIMPLE 워크플로우에서 deploy 브랜치 트리거 제거

• 파일: .github/workflows/PROJECT-SPRING-SYNOLOGY-SIMPLE-CICD.yaml
• 변경 내용: on.push.branches에서 deploy 제거, test 브랜치만 유지
• 이유: deploy 브랜치 배포는 MAPSEE 전용 워크플로우에서 처리하므로 중복 트리거 방지

2. MAPSEE 워크플로우 볼륨 마운트 활성화 및 경로 수정

• 파일: .github/workflows/PROJECT-SPRING-SYNOLOGY-MAPSEE-CICD.yaml
• 변경 내용:
  • ENABLE_VOLUME_MOUNT: "false" → "true" (볼륨 마운트 활성화)
  • VOLUME_HOST_PATH: /volume1/projects/mapsy → /volume1/projects/mapsy/backend (실제 서버 경로에 맞게 수정)
  • 볼륨 마운트 스크립트에서 /${PROJECT_NAME} 접미사 제거 → VOLUME_HOST_PATH를 직접 사용하도록 변경

🔧 주요 변경사항 상세

SIMPLE-CICD.yaml — 트리거 변경

# 변경 전
on:
  push:
    branches:
      - deploy
      - test
  workflow_dispatch:

# 변경 후
on:
  # deploy 브랜치는 PROJECT-SPRING-SYNOLOGY-MAPSEE-CICD.yaml에서 처리
  push:
    branches:
      - test
  workflow_dispatch:

MAPSEE-CICD.yaml — 볼륨 마운트 환경변수 변경

# 변경 전
ENABLE_VOLUME_MOUNT: "false"
VOLUME_HOST_PATH: "/volume1/projects/mapsy"

# 변경 후
ENABLE_VOLUME_MOUNT: "true"
VOLUME_HOST_PATH: "/volume1/projects/mapsy/backend"

MAPSEE-CICD.yaml — 볼륨 마운트 스크립트 변경

기존 스크립트는 VOLUME_HOST_PATH/${PROJECT_NAME} 형태로 경로를 조합했으나, VOLUME_HOST_PATH를 직접 사용하도록 변경하여 경로가 정확히 /volume1/projects/mapsy/backend:/mnt로 마운트됨.

# 변경 전
VOLUME_MOUNT_OPTION="-v ${{ env.VOLUME_HOST_PATH }}/${PROJECT_NAME}:${{ env.VOLUME_CONTAINER_PATH }}/${PROJECT_NAME}"

# 변경 후
VOLUME_MOUNT_OPTION="-v ${{ env.VOLUME_HOST_PATH }}:${{ env.VOLUME_CONTAINER_PATH }}"

변경 파일 요약

워크플로우	변경 내용	영향
SIMPLE-CICD.yaml	deploy 트리거 제거	deploy push 시 더 이상 실행되지 않음
MAPSEE-CICD.yaml	볼륨 마운트 활성화 + 경로 수정	/volume1/projects/mapsy/backend → /mnt 마운트

🧪 테스트 및 검증

• deploy 브랜치 push 후 MAPSEE-CICD 워크플로우만 실행되는지 확인 (SIMPLE-CICD 미실행)
• 배포된 컨테이너에서 볼륨 마운트 확인: docker inspect mapsy-back → Mounts 항목에 /volume1/projects/mapsy/backend:/mnt 존재
• test 브랜치 push 시 SIMPLE-CICD 워크플로우가 정상 실행되는지 확인 (기존 기능 유지)

📌 참고사항

• SIMPLE 워크플로우는 범용 템플릿으로 PROJECT_NAME: "project" 기본값이 설정되어 있어, 프로젝트별 전용 워크플로우(MAPSEE-CICD)와 트리거가 겹치지 않도록 관리 필요
• 향후 새 브랜치 배포 전략 추가 시, 워크플로우 간 트리거 중복 여부를 반드시 확인할 것
• 볼륨 마운트 경로 변경으로 컨테이너 내부에서 /mnt 경로로 서버 파일에 접근 가능