GitHub로 소스코드 관리하는 워크플로우! (Wordpress + GitHub )

안녕하세요~ 블로그 이웃 여러분! 😊

워드프레스로 블로그나 홈페이를 만드시는 분들이 많으신데요. 티스토리나 네이버 블로그와는 다르게 이것저것 신경 쓸 것들이 참 많더라고요. 내용은 별것 없어도(?) 예뻐야 하니 워드프레스의 테마도 골라 관리도 해야 하고, 테마가 지원해 주지 않는 기능이 있다면 직접 개발도 하는데요, 좀 편해보겠다고 워드프레스 유료 테마를 구입했어도 소스 관리는 해야 하더라고요. 😭

저는 건망증이 심해 소스 관리를 GitHub로 업로드를 할 때 마다 명령어를 잊어버려서 개발 열정(?)이 식어버릴 때가 많았어요. 이런 저를 위해 GitHub의 전체적인 워크플로우를 메모해 보았습니다.

---

🛠️ GitHub이란 무엇인가요? (Git과 어떻게 다른가요?)

Git = 자신의 컴퓨터 에서의 버전 관리 .

GitHub = Git 프로젝트를 저장 , 공유 , 협업할 수 있는 온라인 서비스입니다.

GitHub 계정 만들기

• https://github.com 으로 이동하세요
• 가입하고 이메일을 확인해 주세요.
• 새로운 저장소를 만들고 이름을 지정합니다 demo-repo.

🛠️ 로컬에 GitHub 초기 작업하고 싶을 때:

1. git 초기화 (git init)

서버(혹은 로컬 개발 환경)에서 WordPress 소스가 있는 디렉터리로 이동한 후, 아래 명령어로 git 저장소를 초기화합니다.

cd /home/username/public_html/   # 워드프레스 설치 경로로 이동
git init

Git은 현재 디렉터리를 기준으로 파일의 변경 이력을 추적하게 돼요.

2. .gitignore 파일 생성

워드프레스는 불필요한 파일(예: 업로드된 이미지, 캐시, 플러그인 등)이 많으므로, 추적하지 않을 파일을 .gitignore에 명시합니다.

예시:

wp-content/uploads/
wp-content/cache/
wp-content/upgrade/
wp-config.php
*.log

3. config 추가

 git config user.email "<email>"
 git config user.name "<유저명>"
 git remote add origin https://github.com/<리파지토리명>.git
 
 # 원격 저장소 주소 확인
 git remote -v

4. 소스 추가 및 첫 커밋

git add .
git commit -m "처음 워드프레스 소스 커밋"

5. GitHub 저장소 생성

GitHub 공식 사이트에서 회원등록 후 새 저장소(Repository)를 만듭니다.

• 예: https://github.com/yourname/awesome-kikcode

6. 원격 저장소 연결

git remote add origin https://github.com/yourname/awesome-kikcode.git

7. 첫 푸시

git branch -M main
git push -u origin main

---

🛠️ 이후 소스 변경/갱신 워크플로우

1. 변경 사항 확인

git status

수정된 파일 목록이 출력됩니다.

2. 변경 사항 임시 저장

로컬 변경 사항을 임시로 저장하여 깨끗한 상태로 만듭니다.

git stash

변경된 파일들을 임시영역으로 숨기고, 로컬 디렉터리를 초기 상태로 만듭니다.

3. 최신 코드 가져오기

원격 저장소의 최신 코드를 가져옵니다.

git pull origin main

로칼 파일들이 원격 저장소의 최신 상태로 업데이트됩니다.

4. 저장한 변경 사항 다시 적용하기

Stash에 저장했던 변경 사항을 다시 가져옵니다.

git stash pop

충돌이 없다면 변경 사항이 정상적으로 복구됩니다.

5. 충돌 해결하기

충돌이 발생한 파일에 <<<<<, =====, >>>>> 표시를 보고, 직접 수정(merge) 합니다.

6. 소스 추가

git add <충돌 해결한 파일>

충돌 해결한 파일을 추가합니다.

git add .

수정된 모든 파일을 추가합니다.

7. 커밋

Git에 add 한 파일들이 저장(commit)됩니다.

git commit -m "변경 내용 설명"

해당 커밋은 이제 Git 기록의 스냅샷이 되었습니다.

8. GitHub로 푸시

git push

---

🛠️ 서버와 로컬 개발 환경 동기화

• 로컬에서 작업 후 서버에 반영하려면, 서버에서 pull:

  git pull origin main

• 서버에서 작업 후 로컬에 반영하려면, 로컬에서 pull:

  git pull origin main

---

참고/팁

• 워드프레스의 wp-content/uploads 폴더 등은 git으로 관리하지 않는 것이 일반적입니다.
• wp-config.php 등 민감한 정보가 담긴 파일은 git에 올리지 않고, 예시 파일(wp-config-sample.php)만 관리하세요.
• 플러그인/테마만 별도 저장소로 관리하는 방법도 있습니다.