멤버 업데이트 가이드라인¶

members.uwksa.ca 변경 사항을 반영하는 표준 절차를 안내합니다.

현재 멤버십 서버 관련 수정은 Git 워크플로우 중심으로 운영합니다. SSH는 서비스 재시작이 필요할 때만 사용합니다.

사전 준비¶

다음 항목이 준비되어 있어야 합니다:

Git - 버전 관리
GitHub 권한 - therealuwksatech/members.uwksa.ca 저장소 push 권한
코드 에디터 - VS Code 권장

1단계: 저장소 클론 (최초 1회)¶

처음 작업하는 경우 저장소를 클론합니다.

git clone https://github.com/therealuwksatech/members.uwksa.ca.git
cd members.uwksa.ca

SSH를 사용하는 경우

GitHub SSH를 사용하려면 아래 명령을 사용하세요.

git clone [email protected]:therealuwksatech/members.uwksa.ca.git
cd members.uwksa.ca

이미 클론된 저장소가 있다면 이 단계는 건너뜁니다.

2단계: 최신 코드 가져오기¶

작업 시작 전에 최신 변경 사항을 가져옵니다.

git pull origin main

주의

로컬 수정이 있는 상태에서 git pull하면 충돌이 날 수 있습니다.
먼저 git status로 작업 트리를 확인하세요.

3단계: 수정 대상 파일 확인¶

상황에 맞게 필요한 파일을 수정합니다.

작업 유형	수정 파일
멤버 username 추가/수정	`database/members.txt`
WatCard 이미지 추가	`static/images/WATCards/`
폼/템플릿 수정	`templates/*.html`
동기화 로직 수정	`database/*.py`, `add-member.sh`

4단계: 파일 수정¶

필요한 파일을 로컬에서 수정합니다.

멤버 username 반영¶

database/members.txt에 한 줄에 한 명씩 추가
중복 username은 넣지 않기
username 형식은 실제 WatIAM 기준으로 통일 (일반적으로 소문자)

WatCard 이미지 반영¶

이미지는 static/images/WATCards/에 추가
파일명은 해당 username과 매칭되도록 관리

5단계: 변경 사항 확인¶

커밋 전에 변경 내용을 확인합니다.

git status
git diff

필요하면 스테이징 후 커밋될 내용도 확인합니다.

git add <수정한 파일>
git diff --staged

6단계: 커밋¶

git add <수정한 파일>
git commit -m "멤버십 데이터 업데이트"

예시:

git add database/members.txt static/images/WATCards/k227lee.jpg
git commit -m "W26 멤버십 데이터 및 WatCard 이미지 업데이트"

7단계: 원격 저장소에 푸시¶

git push origin main

push 실패 시

다른 변경 사항이 먼저 올라간 경우입니다. 아래 순서로 다시 진행하세요.

git pull origin main
# 충돌 해결
git add <충돌 해결한 파일>
git commit -m "충돌 해결"
git push origin main

8단계: (필요 시) 서비스 재시작¶

기본 수정 작업은 SSH 없이 진행하지만, 운영 환경에서 서비스 재시작이 필요할 때는 아래 명령으로 처리합니다.

ssh ubuntu@server_ip "sudo systemctl restart members.uwksa.ca"

SSH 사용 범위

현재 운영 정책상 SSH는 주로 이 재시작 단계에서만 필요합니다.

전체 워크플로우 요약¶

git pull origin main
# ... 파일 수정 ...
git status
git add <수정한 파일>
git commit -m "변경 설명"
git push origin main
# 필요 시에만:
ssh ubuntu@server_ip "sudo systemctl restart members.uwksa.ca"

참고 문서¶

과거의 서버 직접 작업 방식은 레거시 문서에 보관되어 있습니다.