XE를 git으로 설치하면 업데이트가 편리합니다.

새 버전 나올 때마다 변경파일 받아서 일일이 복사해 넣지 않아도

git pull 명령 하나면 자동으로 변경내역이 반영되고,

심지어 코어를 수정한 상태에서 업데이트해도

내가 수정한 부분은 그대로 남죠.

한마디로 새로운 세상이 열립니다 ^^

 

그러나 처음에 XE를 설치할 때 zip 또는 tar.gz 압축을 풀어서 설치했다면

git 작동에 필요한 정보가 포함되어 있지 않아서

매번 변경파일을 일일이 복사해 넣어주어야만 합니다.

그렇다고 git으로 새로 설치하자니 막막하고요...

 

그래서 오늘은 압축 풀어 설치했던 XE를 git으로 변환하는 방법을 소개해 드리겠습니다.

리눅스 콘솔 기준이며, 윈도우에서도 git이 설치되어 있다면 비슷한 방법을 사용할 수 있습니다.

 

[주의]

XE가 github으로 이전한 1.7.3.6 이후 버전에서만 git 변환이 가능합니다.

예전에 Google Code에서 svn을 사용하던 시절 버전은 안됩니다.

1.7.3.6 미만 버전을 사용하신다면 우선 변경파일을 사용해서 1.7.3.6까지 업데이트하신 후에

아래의 방법을 사용하시기 바랍니다.

 

[경고]

작업 전 백업은 필수입니다. 실수로 다 날려먹어도 책임 못져요.

 

 

우선 현재 운영중인 홈페이지와 전혀 무관한 별도의 폴더에 git으로 XE를 설치합니다.

 

    git clone https://github.com/xpressengine/xe-core.git

 

이렇게 하면 xe-core라는 폴더에 XE가 설치됩니다. 이 폴더로 이동합니다.

 

    cd xe-core

 

여기 설치되는 XE는 당연히 최신 버전입니다. 실제 사용중인 버전과 맞춰 줘야겠죠?

이 예제에서는 1.7.5.7로 맞춰 보겠습니다.

 

    git reset --hard 1.7.5.7

 

리눅스 서버에서는 git이 기억하는 퍼미션과 실제 퍼미션이 다른 경우가 종종 있습니다.

이것 때문에 나중에 변경내역을 조회할 때 엉뚱한 파일이 변경된 것으로 나오기도 하므로,

변경내역 조회시 퍼미션은 무시하도록 설정해 줍니다.

 

    git config core.fileMode false

 

이제 git은 준비가 다 되었습니다.

 

자, 이제 이렇게 git으로 설치한 폴더에서 아래의 파일 및 서브폴더들을 선택하여

기존에 운영하던 홈페이지 경로로 복사해 줍니다.

 

    .git/

    .gitattributes

    .gitignore

    .travis.yml

    Gruntfile.js

    package.json

    phpDoc/

    tests/

    tools/

 

마지막에 슬래시(/)를 붙인 것은 폴더입니다.

버전에 따라 위의 파일과 폴더들 중 일부가 없을 수도 있습니다. 없으면 건너뛰세요.

단, 어떤 경우에도 .git 폴더는 반드시 있어야 합니다. (용량 70MB 내외)

 

그 밖의 파일과 폴더들은 사실 없어도 되지만, 없으면 나중에 변경내역 조회시

불필요한 내용이 많이 출력되기 때문에 넣어주는 것이 편합니다.

만약 기존에 운영하던 홈페이지에 phpDoc, tests, tools 등의 폴더가 이미 있다면 건너뛰어도 됩니다.

 

복사를 마쳤으면 기존에 운영하던 홈페이지 경로로 가봅시다.

 

    cd /님/웹사이트/경로

 

여기에 git이 제대로 적용되었는지 확인해 봅시다.

 

    git status

 

정상적인 상태라면 님이 수정한 파일 목록만 나옵니다.

(board 모듈을 별도로 설치하던 시절의 버전이라면 board 폴더도 나올 수 있습니다.)

 

축하합니다! 이제부터는 git pull 명령을 사용해서 XE를 업데이트할 수 있습니다!

 

단, 님이 수정한 부분이 애매하다면 git pull 명령 실행시 conflict(충돌)이 발생해서 업데이트에 실패할 수도 있습니다.

이 경우에는 에러가 나는 파일을 직접 수정한 후 업데이트를 완료해 주어야 합니다.

대체로 그냥 git pull 하는 것보다는 git stash 명령을 사용해서 수정된 부분을 별도로 저장한 후 업데이트하고,

업데이트한 후 git stash apply 명령으로 아까 별도로 저장한 수정분을 다시 덮어씌우는 것이 편하더군요.