라이믹스/매뉴얼/라이믹스 업데이트

개요

라이믹스는 계속해서 새로운 기능이 추가되고, 버그 수정과 보안 패치가 수시로 이루어집니다. 따라서 라이믹스를 사용해 운영하는 사이트는 정기적으로 업데이트해야 안전하고 최신 기능을 유지할 수 있습니다.

업데이트 방법은 크게 두 가지입니다.

1. 새 버전으로 덮어씌우기 (초보자 추천)
2. Git을 이용한 업데이트 (버전 관리 시 추천)

새 버전으로 덮어씌우기

이 방법은 가장 간단하며, 라이믹스 설치 절차와 동일합니다.

1. 라이믹스 공식 릴리스 페이지에서 최신 ZIP 파일을 다운로드합니다.
2. 서버의 기존 라이믹스 설치 위치에 압축을 풀거나 덮어씌웁니다.

wget https://github.com/rhymix/rhymix/archive/master.zip
unzip master.zip -d /path/to/your/site

files 폴더와 DB에는 사용자 설정 및 첨부파일이 저장되므로, 덮어씌워도 데이터 손실 없이 안전합니다. 단, 코어 파일을 직접 수정한 경우 모든 변경 내역이 사라질 수 있습니다.

⚠ 경고: 코어 파일을 수정해서 사용 중이라면 이 방법을 쓰면 수정 내용이 전부 초기화됩니다.

→ 코어를 수정한 상태에서 업데이트하려면 아래의 Git 방법을 사용하세요.

Git으로 업데이트하기

Git으로 설치한 경우, 명령어 몇 개만으로 손쉽게 최신 상태로 유지할 수 있습니다.

소스 수정이 없는 경우

git status 명령을 실행했을 때 "modified", "deleted" 메시지가 없으면 코어 소스에 수정 사항이 없는 상태입니다. (추가한 모듈·스킨 등은 "Untracked files"에 표시되지만, 이는 문제가 되지 않습니다.) 이 상태라면 다음 한 줄로 업데이트가 완료됩니다.

git pull

설명:

• git pull은 원격 저장소의 최신 커밋을 로컬에 가져와 자동으로 병합합니다.
• 브랜치를 변경했다면, 해당 브랜치에서도 다시 git pull을 실행해야 합니다.

Git 공식 문서: git-pull

소스 수정이 있는 경우 (간단한 수정)

코어 파일을 일부 수정해 두었다면, 업데이트 시 충돌(conflict)이 발생할 수 있습니다. 작은 수정만 있을 때는 git stash로 임시 보관했다가 업데이트 후 다시 꺼내는 방법이 편리합니다.

단계별 가이드

1. 변경 사항을 임시 저장합니다:

git stash

2. 이때 git status를 실행하면 "clean" 상태가 됩니다.
3. 이제 원격 저장소에서 변경 사항을 가져옵니다:

git pull

4. 업데이트가 완료되면, 숨겨둔 변경 사항을 다시 적용합니다:

git stash apply

5. 충돌이 없으면 이걸로 끝납니다.

⚠ 경고: 동일한 파일의 동일한 부분을 수정했다면 git stash apply 단계에서 충돌이 발생합니다. 충돌 표시(<<<<<<<, =======, >>>>>>>)를 찾아 직접 수정한 뒤 저장하세요.

6. 작업이 모두 완료되면, 더 이상 필요 없는 임시 저장 데이터를 삭제합니다:

git stash clear

Git 공식 문서: git-stash

소스 수정이 있는 경우 (대규모 수정)

수정 분량이 많거나 여러 차례 커밋하며 작업했다면, 별도 브랜치에서 관리하는 편이 안전합니다.

단계별 가이드

1. 새 브랜치를 만듭니다 (브랜치명은 사이트 이름 등으로 구분):

git checkout -b mybranch

2. 현재 변경 내역을 모두 커밋합니다:

git add -u .
git commit -m "사이트 커스터마이징 커밋"

3. 공식 저장소의 master(또는 develop) 브랜치를 로컬로 가져옵니다:

git fetch origin master:master
git fetch origin develop:develop

4. 작업 브랜치에서 master를 병합합니다:

git merge master

5. 충돌이 없다면 완료. 충돌이 발생하면 표시된 파일을 열어 수정하고, 아래를 실행하세요:

git add -u .
git commit -m "충돌 해결 및 업데이트 반영"

ℹ 정보: 이 워크플로우는 대규모 커스터마이징 상태에서도 안전하게 업데이트와 충돌 관리를 할 수 있는 정석 방법입니다.

관련 문서

• Git#stash – stash 사용법
• Git#merge – merge 전략
• Git 공식 문서 전체