jeon/HECO2

Files

T

jeon 5a96a696b1 chore: HERV 통합 저장소 초기 커밋

- 펌웨어(program), C# 대시보드(TestProgram), 시뮬레이터(Simulator),
  프로토콜/문서(Protocol, doc) 전체를 단일 저장소로 통합
- program 폴더의 별도 git 저장소를 제거하고 통합 저장소에 흡수
- 빌드 산출물(program/build, bin/obj, *.o/.elf/.bin/.hex 등) .gitignore 처리
- 사내 Synology NAS Git 원격 연결 예정

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-15 21:44:23 +09:00

3.3 KiB

Raw Blame History

팀 공유 · 이동 중 작업 환경 구성 (검토 메모)

작성일: 2026-06-15

1. 배경 / 요구사항

이동 중에도 지금처럼 VS Code로 수정·저장하는 방식을 유지하고 싶다.
기존 Google Drive 방식(수동 다운로드/업로드)은 번거롭고 버전 꼬임이 생겨 개선 필요.
다른 직원과 소스 공유도 해야 한다.

2. 결론

Git + 사내 원격 저장소(private) 로 간다. 한 번에 세 가지를 해결:

팀 공유 — 각자 clone, 수정 후 push, 누가 뭘 바꿨는지 추적
이동 중 작업 — 노트북에서 clone, 또는 브라우저 웹 IDE로 편집
변경 이력 — 현재 이 폴더는 git 저장소가 아니라 diff 추적 불가 → git 도입으로 영구 해결

폴더 동기화(Google Drive / OneDrive / Syncthing)는 여러 명이 동시에 수정하면 충돌 파일이 쌓여 팀 공유에는 부적합. 단독 백업 용도라면 OneDrive/Syncthing이 Drive보다 낫지만, 본 목적에는 Git 채택.

3. 호스팅: 회사 Synology NAS (확정)

사내에 소스가 머무르고 직원 공유가 깔끔함. 내일 NAS에 Git 설치 후 진행 예정.

방식 비교

방식	특징	추천 상황
Git Server 패키지 (추천)	패키지 센터에서 `Git Server` 설치, SSH로 bare repo 접근. 가볍고 간단.	소규모 팀(현재)
GitLab (패키지/Docker)	머지요청·이슈·권한관리·웹 편집 등 풀기능 웹 UI. 무겁고 RAM 사용 큼.	코드리뷰/PR 문화 필요 시

→ 우선 Git Server 패키지로 시작, 필요해지면 GitLab으로 확장.

Git Server 방식 절차 (예시)

# NAS 측 (SSH 접속 후) — bare 저장소 생성
git init --bare /volume1/git/HERV.git

# 직원 PC 측 — clone
git clone ssh://사용자@NAS주소:포트/volume1/git/HERV.git

4. 로컬 준비 (NAS 연결 전, 오늘 가능)

원격 설정만 내일 하면 되도록 로컬 git을 먼저 초기화:

.gitignore 생성 — 빌드 산출물 제외, 소스·문서·PDF만 추적
- 제외 대상: program/build/, C# bin/ · obj/, *.o *.d *.elf *.bin *.hex *.map
git init + 첫 커밋 (현재 상태 스냅샷 → 이 시점부터 변경 이력 남음)

내일 NAS 작업:

git remote add origin ssh://사용자@NAS주소:포트/volume1/git/HERV.git
git push -u origin main

5. 이동 중 작업 옵션 (참고)

노트북 + git clone: 가장 일반적. 평소처럼 VS Code 편집.
브라우저 웹 IDE: GitLab 도입 시 웹 편집 가능(Git Server 단독은 미지원).
VS Code Remote Tunnel: 집/사무실 PC에 code tunnel 켜두고 원격 접속 → 그 PC의 실제 파일·빌드툴·연결된 PBA 보드까지 그대로 사용. (빌드·실보드 시험을 이동 중에도 해야 할 때 유용)

6. 주의 / 작업 범위

모든 작업은 D:\project\nuvoton\HERV 폴더 내부에서만 진행 (외부 D:\project\C#\ 등은 건드리지 않음).
빌드 산출물은 git에 올리지 않음(.gitignore 처리) — 저장소를 소스·문서 위주로 깨끗하게 유지.

7. 다음 할 일

(오늘/원하면) 로컬 git init + .gitignore + 첫 커밋
(내일) NAS에 Git Server 패키지 설치, bare repo 생성
NAS를 remote로 추가하고 push
직원 계정/접근 권한 부여 및 clone 테스트

3.3 KiB Raw Blame History