CentOS 7 에서 Jekyll설치 및 GitHub Page 연동

1. 개요

GitHub 페이지를 만들어보고자 정적 페이지 생성 프레임워크인 Jekyll을 설치한 내용을 정리한 문서입니다.

2. GitHub 설정

1. 새로운 레파지토리 생성
   생성시 레파지토리 명은 [GitHub ID].github.io 로 생성

3. 설치

1. EPEL 레포지토리 등록

   sudo yum install http://mirror.premi.st/epel//epel-release-latest-7.noarch.rpm
   

2. 의존 파일 설치

   sudo yum install nodejs npm ruby ruby-devel rubygems git python-pip
   

3. 루비 gem을 이용한 jekyll 설치

   gem install jekyll
   

4. GitHub 레파지토리 Clone

   git clone [레파지토리 URL]
   

5. GitHub 디렉토리로 이동

   cd [레파지토리]
   

6. jekyll 구성
   .대신 디렉토리 이름을 사용하면 해당 디렉토리명으로 jekyll이 구성됨

   jekyll new .
   

7. 문서 생성 등 작업
   간단하게 _posts 디렉토리 밑에 YYYY-MM-DD-POST명.md식으로 마크다운 문서를 집어넣고 jekyll build를 하면 _sites 밑으로 포스트가 생성되는 식이다.
   welcome 파일을 참고해서 헤더를 추가하거나 기타 작업을을 하면 쉽게 생성이 된다.
   자세한 내용은 Jekyll 홈페이지나 번역 페이지를 참조하세요.

   jekyll 홈페이지 : http://jekyllrb.com/docs/usage/
   jekyll 한국어 번역 페이지 : http://jekyllrb-ko.github.io/docs/usage/

8. git 설정
   • 사용자 정보 설정

     git config --global user.name "[이름]"
     git config --global user.email [이메일 주소]
     

9. git을 이용하여 등록

   git add .
   

   git commit -m "[커밋 메시지]"
   

   최초 1회만 git push origin master로 하면 이후부터는 git push명령을 사용하면 master 브랜치에 자동으로 푸시해줌. 특별히 브랜치를 변경하지 않는 이상 최초 1회 이후엔 git push로 진행

   git push origin master
   

• 온전히 구성하기 어렵다면 jekyll 테마 사이트를 통해 테마를 다운 하거나 git Fork후 테마를 적용시키면 된다.
• jekyll serve 명령을 입력하면 4000번 포트로 작은 웹서버가 구동이 되는데, 로컬 외에서의 접속이 잘 안되서 나는 그냥 git에 바로 커밋 & push로 테스트를 했다.

GitHub 와 Jenkins CI 연동하기

1. 개요

GitHub 에서도 Jenkins를 적용해보고자 설정한 내용을 정리한 문서입니다.

2. Jenkins 설정

1. Jenkins 접속
2. Jenkins 관리 메뉴 클릭
3. 플러그인 관리 메뉴 클릭
4. GitHub 연동 플러그인 설치
   • GitHub plugin
   • GitHub API Plugin
   • GIT plugin
   • GIT clent plugin
5. 잡 구성 설정
   • GitHub project / Project url : GitHub로 접속가능한 메뉴에 사용될 정보
   • Git 관련 설정은 GitLab 과 Jenkins CI 연동하기 참고
   • 빌드 유발 부분에 Build when a change is pushed to GitHub 체크
   • 그외 배포 등의 설정은 프로젝트 설정에 따라서 설정

3. GitHub 설정

1. 연동할 GitHub 레파지토리 접속
2. Settings 메뉴 클릭
3. Webhooks & services 메뉴 클릭
4. Services에서 Add Service 메뉴 선택
5. Jenkins (GitHub plugin)를 찾아서 선택
6. Jenkins hook url 부분 설정
   [Jenkins URL]/github-webhook/
   • Jenkins URL은 각 프로젝트별 URL을 의미하는것이 아닌 Jenkins Root URL을 의미
7. Add service 버튼 클릭

GitLab과 Mylyn Plugin 연동하기

1) 개요

프로그래밍을 하다 보면 작업단위를 메모지등에 적어놓고 완료되면 지우고 하던 때가 있었는데, IDE툴 자체에서 관리하면 좋을 것 같아 알아 보다 Eclipse의 Task List가 있음을 알게 되었다.
그러다 최근 Git을 사용해보면서 Git의 이슈와 연동 가능한 방법을 찾아 보니 Mylyn이라는 플러그인을 사용하면 된다는 것을 알고 연동 작업을 했던 때의 내용을 정리한 문서 입니다.

• GitHub용 플러그인도 있으니 GitHub용 플러그인도 있으니 GitHub 사용하시는 분은 GitHub용을 받아 사용하시면 됩니다.

2) Mylyn Plugin 설치

1. Eclipse의 [Help] -> [Eclipse Marketplace…] 메뉴 클릭
2. Mylyn Gilab Connector를 검색하여 플러그인 설치
3. Eclipse 재시작
4. [Window] -> [Show View] -> [Task List]를 클릭하여 Task List View를 활성화

3) GitLab과 연동

1. Task List View에서 [Add Repository…] 메뉴 클릭

   

   
   

   

   
   

2. [Gitlab issues] 클릭 후 [Next >]

   

   
   

3. 프로젝트 정보 입력 후 [Finish] 버튼 클릭

   

   
   

4. 이슈를 가져올 필터를 지금 설정할 것인지 메뉴가 나오면 등록 할 것이라면 [Yes] 클릭

   

   
   

5. 필터 조건을 설정후 [Finish] 버튼 클릭

   

   
   

• 등록된 mylyn 설정을 지울려면 Eclipse 종료 후, Eclipse WorskSpace 디렉토리에 [.metadata] -> [.mylyn] 디렉토리를 삭제 후 Eclipse를 실행해주면 mylyn 설정이 사라져있을 것이다.

Git 한 프로젝트에서 GitLab과 GitHub 원격 저장소 동시에 사용 하기

1) 개요

GitLab을 사용하면서 GitHub를 백업 용도로 동시에 관리하는 프로젝트를 사용하면 어떻게 될까 라는 단순한 호기심에 테스트 해본 내용을 정리한 문서입니다.

2) GitHub 설정

1. GitHub에서 레파지토리를 생성한다.
2. 끝

3) GitLab 설정

1. GitLab에 로그인 한다.

2. NEW PROJECT 버튼을 클릭 한다.

   

3. GITHUB 버튼을 클릭 한다.

   

4. GitHub에서 가져온 프로젝트 중 같이 관리할 프로젝트를 IMPORT 버튼을 클릭하여 가져온다.

   

   
   

4) Eclipse 설정

• 여기서 부터는 어느정도 개인의 취향에 따라 달라진다.
• GitLab과 GibHub의 원격 저장소에 PUSH할 때 각각 할 것인지, 아니면 GitHub로 푸시할때는 GitHub만 푸시 하고 GitLab에 올릴때 GitHub와 동시에 할 것인지 인지 등 세부 설정은 알아서 하면 된다.
• 여기서는 일반 PUSH 상황에서 두 군데 동시에 올리도록 설정 할 것이다.

1. 이클립스에 Clone한 레파지토리에서 Remotes에서 원격 저장소 중 PUSH 부분 선택후 오른쪽 마우스를 클릭 한다.

   

   
   

2. Configure Push... 메뉴를 클릭 한다.

   

   
   

3. Push URIs를 선택 후 Add... 버튼을 클릭 한다.

   

   
   

4. GitLab과 GitHub 저장소를 각각 입력 해서 등록 한다.

   

   
   

5. Save 버튼을 클릭 한다.

   

   
   

GitLab 과 Jenkins CI 연동하기

1) 개요

GitLab의 프로젝트의 CI를 Jenkins로 연동해서 나중에 사용할 수 있도록 테스트 삼아 설정한 내용을 정리한 문서입니다.

2) 사전 준비

1. Git 설치하기

   CentOS 7 에서 Git Server 설치하기 참고하여 설치 진행

2. 컴파일용 JDK 설치하기

   CentOS 7 에서 Oracle JDK 설치하기 참고하여 설치 진행

3. GitLab에서 젠키스와 연동할 jenkins 계정 생성

4. GitLab에 젠킨스 계정 로그인

5. [ProfileSettings] 메뉴 클릭
   

6. [Account] 메뉴 클릭
   
7. Private token 값을 복사 해놓거나 이 위치를 기억 해 둔다.
   

   3) 기본 연동 설정하기

8. [Jenkins 관리] 메뉴 클릭 하기
   
9. [플러그인 관리] 메뉴 클릭 하기
   

10. [설치가능] 탭을 클릭하고 필요한 플러그인 설치하기
    저는 이미 설치가 되어있어서 화면 첨부는 못 했습니다.

    • GIT Plugin : Git 사용 위한 플러그인
    • GitLab Plugin : GitLab 연동 위한 플러그인
    • embeddable-build-status : 빌드 상태를 마크다운 문서등에 아이콘으로 표시하기 위한 플러그인
      
    • [재시작 없이 설치하기] 나 [지금 다운로드하고 재시작 후 설치하기] 중 원하는 대로 설치 진행

11. SSH 접속을 위한 SSH-Key 생성

     mkdir [젠킨스 계정 홈 디렉토리]/.ssh //젠킨스 설치때 사용한 계정 또는 /var/lib/jenkins를 사용한다.
     cd [젠킨스 계정 홈 디렉토리]/.ssh
     sudo -u [젠킨스 계정] ssh-keygen -t rsa -C "구분값"
    

12. [Jenkins 관리] 메뉴 클릭 후 [Manage Credentials] 메뉴 클릭
    

13. [Add Credentials] 클릭 후 [SSH Username with private key]를 선택 한다.
    

    • Scope : Global(Jenkins, nodes, items, all child items, etc) 선택
    • Username : [Jenkins 계정]
    • Private Key : From the Jenkins master ~/.ssh 선택

14. [Save] 버튼을 클릭하여 설정을 저장한다.

15. [Jenkins 관리] 메뉴 클릭 후 [시스템 설정] 메뉴 클릭
    

16. JDK, Git가 설치된 위치를 지정 해 준다.
    

    • 빌드를 위한 Ant, Maven 등의 툴을 사용한다면 관련 툴에 대한 세팅도 해줘야 한다.
    • 아직 잉여라 Ant만 조금 써보고 Maven은 써보지 못 했고, 대세는 Gradle이라고 하니 나중에 빌드 툴은 Gradle로 구성을 위해 빌드 툴 설정은 안했다. (사실 빌드 툴을 제대로 써본게 없어서…ㅜㅜ)

17. GitLab 연동 관련 부분을 설정 해 준다.

    • GitLab host URL에는 GitLab 사이트 주소를 작성 해준다.
    • API Token 부분에 위에서 복사해둔 Private token을 입력 한다.
      
    • [Test Connection] 버튼을 클릭하여 연동이 잘 되었는지 확인 한다.

18. [저장] 버튼을 클릭하여 기본 연동 설정을 저장 한다.

4) 프로젝트 연동하기

1. GitLab 설정하기
   1. GitLab 로그인 후 Jenkins와 연동할 프로젝트를 클릭 한다.
   2. [Settings] 메뉴 클릭
      
   3. [DeployKeys] 메뉴 클릭
      
   4. [NEW DEPLOY KEY] 버튼 클릭
      
   5. ssh키 추가 후 [CREATE] 버튼 클릭
      • [젠킨스 홈 디렉토리]/.ssh/id_rsa.pub 파일의 내용을 추가 해준다.
        
2. Jenkins Project 설정하기
   1. Jenkins 메인 화면에서 [새로운 Item] 메뉴 클릭
      
   2. Item 이름입력 후 Freestyle project 선택 하고 [OK] 버튼 클릭
      
   3. 소스 코드 관리 부분 설정
      • Repository URL은 GitLab에서 Clone하는 프로젝트 주소를 입력 해준다.
      • Credentials는 아까 설정한 Credentials 계정을 선택 한다.
      • Repository browser는 gitlab을 선택 한다.
      • URL은 Jenkins Item과 연동할 GitLab의 Project주소를 입력한다.
      • Version은 관리할려는 버전을 입력하면 되는 듯 함. (즉, 아무렇게나…)
        
   4. 빌드 유발 부분 설정 후 [저장] 버튼 클릭
      • Build when a change is pushed to GiLab. GitLab CI Service URL: [젠킨스주소]/project/[Item명] 를 체크 한다.
      • GitLab 버전에 따라 Use GitLab CI features(GitLab 8.1 required!)를 체크 한다.
        

3. GitLab에 WebHoks 등록하기

   1. GitLab 로그인 후 Jenkins와 연동할 프로젝트를 클릭 한다.
   2. [Settings] 메뉴 클릭
      
   3. [Web Hooks] 메뉴 클릭
      

   4. Hook 설정을 입력 후 [ADD WEB HOOK]버튼을 클릭 한다.

      • URL에는 젠킨스에서 설정시 체크박스 옆에 있던 주소인 [젠킨스주소]/project/[Item명]를 입력 한다.
        
      • 젠킨스를 HTTPS로 사용할 때 인증된 인증서 사용하지 않는 경우 Enable SSL verification 체크를 해제 해준다.

   5. [TEST HOOK] 버튼을 클릭하여 잘 동작하는지 확인 해본다.
      
      

• Emebeddable Build Status 메뉴를 이용하면 빌드 상태를 마크로 볼 수 있다.
  
  

GitLab과 Slack 연동하기

1) 개요

팀 챗으로 유명한 Slack에 GitLab을 연동할 수 있다는 이야기를 듣고 한번 테스트 삼아 연동한 내용을 정리하고자 작성하였습니다.
관련 내용을 한글로 된 문서를 찾기 어려웠고, 간단하게만 연동한 내용을 공개합니다.

2) Slack 설정

1. Slack의 [Team Settings]메뉴에 접속한다.

2. [Integrations] 메뉴를 클릭한다.

   

   
   

3. 서비스 중에 Incoming WebHooks를 찾아 클릭한다.

   

   
   

4. 포스팅 할 채널을 선택 한다.

   

   
   

5. [Add Incoming WebHooks Integration] 버튼을 클릭 합니다.

   
   

   

6. 설정을 진행 한 후, Webhook URL을 복사 해 둔다.

   

   
   

7. [SaveSettings] 버튼을 클릭하여 설정을 완료합니다.

3) GitLab 설정하기

1. Slack에 연동 할 프로젝트를 선택 합니다.

2. [Settings] 메뉴를 클릭 합니다.

   

   
   

3. [WebHooks] 메뉴를 클릭 합니다.

   

   
   

4. URL에 Slack에서 설정한 Webhook URL을 입력 한다.

5. 어떤 이벤트에 포스팅할지 설정 하고 [Add WEB HOOK]버튼을 클릭한다.

   

   
   

• GitLab에 HTTPS를 사용 시 인증되지 않은 SSL을 사용중이라면 Enable SSL verification 옵션은 체크 해제 한다.

GitLab에 GitHub 레파지토리 Import 하기

1) 개요

GitLab과 GitHub를 동시에 관리 해보기 위해 테스트한 내용을 정리하기 위해 작성되었습니다.

2) GitHub에 GitLab에 접근가능하도록 설정하기.

1. GitHub에 로그인 한다.

2. 오른쪽 상단에 계정을 선택 후, [Settings] 메뉴를 클릭한다.

   

   

3. [Applications] 메뉴를 클릭한다.

   

4. [Developer applications] 메뉴를 클릭한다.

   

5. [register an application.] 를 클릭한다.

   

6. 아래 내용을 작성한 후, [Register application]버튼을 클릭하여 외부 접근 가능한 Application을 생성한다.

   
   

   

7. 정보를 잘 적어놓는다.

   

   
   

3) GitLab 설정하기

1. GitLab 설정 파일 수정

    sudo vi /etc/gitlab/gitlab.rb
   

    약 110 라인쯤에 주석을 제거한 후 해당 내용을 설정한다.
    위에서 적어놓은 Client ID, Client Secret 내용을 입력하면 된다.
    gitlab_rails['omniauth_providers'] = [
        {
          "name" => "github",
          "app_id" => "[생성된 ID]",
          "app_secret" => "[생성된 SECRET 번호]",
          "url" => "https://github.com/",
          "args" => { "scope" => "user:email" }
        }
    ]
   






2. GitLab 설정파일을 다시 설정을 한다.

    sudo gitlab-ctl reconfigure
   

GitLab에 HTTPS 보안 적용을 위한 OpenSSL 설정하기

1) 개요

HTTP로 사용중 OpenSSL 기술을 적용해보고자 설정한 내용을 정리하기 위해 작성되었습니다.

2) 인증서 생성하기

1. 개인키 생성하기

   sudo openssl genrsa -des3 -out [설정 파일 이름].key 1024 //일반적으로 server.key를 사용
   

2. CSR 파일 생성하기
   개인 인증기관 파일인듯하고 나중에 정리하겠습니다.

   openssl req -new -days 365 -key [설정 파일 이름].key -out [설정 파일 이름].csr
   

   Country Name = [KR]
   State or Province Name = [시 이름]
   Locality Name = [구 이름]
   Organization Name = [회사명]
   Organizational Unit Name = [부서명] //공백 가능
   Common Name = [사용하는 도메인 이름]
   Email = [이메일 주소]
   Challenge password = [] //공백 가능
   optional company name = [] //공백 가능
   

3. 개인키 파일에 암호 제거하기

   cp [설정 파일 이름].key [설정 파일 이름].key.org //백업
   openssl rsa -in [설정 파일 이름].key.org -out [설정 파일 이름].key
   

4. 공유키(인증서) 생성하기

   openssl x509 -req -days 365 -in [설정 파일 이름].csr -signkey [설정 파일 이름].key -out [설정 파일 이름].crt
   

3) GitLab에 HTTPS 적용하기

1. GitLab 설정파일 수정하기

   sudo vi /etc/gitlab/gitlab.rb
   

   • gitlab.rb에 수정할 내용

     external_url '[HTTP를 HTTPS로 변경]'
     nginx['redirect_http_to_https'] = true
     nginx['redirect_http_to_https_port'] = [포트번호] //HTTP 주소로 접속하면 HTTPS로 리다이렉트 시켜주는 옵션이다.
     

2. SSL 디렉토리 생성 및 키 적용하기

   sudo mkdir -p /etc/gitlab/ssl
   sudo chmod 700 /etc/gitlab/ssl
   sudo mv [설정 파일 이름].crt /etc/gitlab/ssl
   sudo mv [설정 파일 이름].key /etc/gitlab/ssl
   

3. HTTPS 방화벽 해제하기

   sudo firewall-cmd --add-service=https --permanent
   sudo firewall-cmd --reload
   

4. GitLab 레파지토리 재설정하기

   sudo gitlab-ctl reconfigure
   

• Git Client 사용자 SSL 인증 오류시 아래 내용 중 선택하여 적용하기
  1. SSL 검증 안하는 방법

     git config --global http.sslVerify false
     

  2. 제대로된 인증기관으로부터 인증 받는 방법

     대부분 유료이지만 간혹 무료로 인증해주는 곳도 있습니다.
     대표적인 무료 SSL 사이트는 StartSSL이 있습니다.

GitLab 업그레이드 하기

1) 개요

기존 사용하던 GitLab의 업그레이드 버전이 나와 업그레이드를 진행한 내용을 정리하기 위해 작성되었습니다.

2) 업그레이드 하기

1. 실행중인 GitLab서비스 중지하기

   sudo gitlab-ctl stop unicorn
   sudo gitlab-ctl stop sidekiq
   sudo gitlab-ctl stop nginx
   

2. GitLab 백업하기

   sudo gitlab-rake gitlab:backup:create
   

3. GitLab 업그레이드하기

   sudo yum install gitlab-ce
   

4. GitLab 레파지토리 재설정 및 서버 재시작

   sudo gitlab-ctl reconfigure
   sudo gitlab-ctl restart
   

CentOS 7 에서 GitLab 설치하기

1) 개요

개인적으로 VM Ware을 통해 Git서버를 구성하던 중 지인들과 같이 사용하게 되어 관리의 편의성을 위해 GitLab 구성 중 작성했던 내용을 간단하게 나마 정리하기 위해 작성되었습니다.

2) 설치하기

1. 의존패키지 설치하기

   sudo yum install curl openssh-server postfix
   

2. GitLab에서 사용하기 위해 ssh 및 이메일 발송 서비스(postfix) 서비스 자동실행 설정하기

   sudo systemctl enable sshd postfix
   sudo systemctl start sshd postfix
   

3. GitLab 패키지 다운로드

   curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
   sudo yum install gitlab-ce
   

4. GitLab 레파지토리 설치를 위한 정보 설정하기

   sudo vi /etc/gitlab/gitlab.rb
   

   • gitlab.rb에 변경할 부분(개인이 필요한 부분만 수정하면 됩니다.)

     external_url "[IP주소:포트]" //외부에서 접속할 주소 및 포트정보 수정
     git_data_dir "[GitLab 레파지토리로 사용할 경로]"
     user['username'] = "[GitLab 레파지토리 관리할 계정명]"
     user['group'] = "[GitLab 레파지토리 관리할 계정의 그룹명]“
     user[‘home’] = “[GitLab 레파지토리 관리할 계정의 홈디렉토리]”
     user[‘gid’] = “[GitLab 레파지토리 관리할 계정의 GID]” //id 명령어로 확인이 가능합니다.
     user[‘uid’] = “[GitLab 레파지토리 관리할 계정의 UID]” //id 명령어로 확인이 가능합니다.
     gitlab_rails['smtp_enable'] = true
     gitlab_rails['smtp_address'] = "[SMTP 주소]" //G-mail 예) smtp.gmail.com
     gitlab_rails['smtp_port'] = [SMTP 포트]//G-mail 예) 587
     gitlab_rails['smtp_user_name'] = "[메일 ID]"
     gitlab_rails['smtp_password'] = "[메일 비밀번호]"
     gitlab_rails['smtp_domain'] = "[SMTP 도메인]" //G-mail 예) gmail.com
     gitlab_rails['smtp_authentication'] = :plain
     gitlab_rails['smtp_enable_starttls_auto'] = true
     

5. GitLab 레파지토리 설치하기

   sudo gitlab-ctl reconfigure
   

6. GitLab 페이지 접속을 위한 방화벽 해제하기

   sudo firewall-cmd --permanent --add-service=http //내부 웹 서버인 Nginx 포트
   sudo firewall-cmd --zone=public --add-port=[위에서 설정한 포트]/tcp --permanent
   sudo systemctl reload firewalld
   

7. GitLab 재시작하기

   sudo gitlab-ctl restart
   

   • 만약 콘솔의 표시정보가 이상하게 변했다면 아래 내용 적용하기

     sudo vi /etc/profile
     

     아래 내용 추가

     export PS1="[\u@\h \w]\\$ "
     

8. GitLab 초기 설정하기

   IP주소:포트로 접속
   

   초기 관리자 계정 및 암호

   Username: root 
   Password: 5iveL!fe
   

• GitLab 서버의 시작 / 종료 명령어
  1. GitLab 서버 시작

     sudo gitlab-ctl start
     

  2. GitLab 서버 종료

     sudo gitlab-ctl stop
     

• 502 에러가 발생한다면 아래 내용 적용하기
  log 디렉토리에 권한이 없어서 발생한 경우가 대부분인듯 하다.

  sudo chown -R [GitLab관리계정명:GitLab관리계정그룹명] /var/log/gitlab/unicorn
  sudo chown -R [GitLab관리계정명:GitLab관리계정그룹명] /var/log/gitlab/gitlab-git-http-server
  sudo chown -R [GitLab관리계정명:GitLab관리계정그룹명] /var/log/gitlab/gitlab-rails
  sudo chown -R [GitLab관리계정명:GitLab관리계정그룹명] /var/log/gitlab/gitlab-shell
  sudo chown -R [GitLab관리계정명:GitLab관리계정그룹명] /var/log/gitlab/sidekiq
  이 외에도 /var/opt/gitlab 부분도 확인해보기.
  

* GitLab은 내부적으로 Nginx가 80포트, Unicorn이 8080포트, GitLab의 지정된 포트 3가지 정도를 사용하게 된다.