ubuntu

우분투에 GitLab 설치 사용하기 2 [사용]

소화자/ editor

  • 3 comments
  • 2,537 views
  • 2017년 7월 4일

우분투에서 GitLab 설치후 기본 사용법 알아봅니다.

시작하기 전에


 

우분투에 gitlab 설치 사용하기 1 에서 gitlab-ce가 잘 설치되어, 실행 된다면
이제 기본 사용법을 익혀 보도록 하겠습니다.

항상 새로운 프로그램을 설치하면, 어디서 부터 시작해야 할 지 그것이 문제입니다.

gitlab은 소프트웨어 버젼 관리 서버 툴이니, 유저와 프로젝트 관리, 그리고 클라이언트 사이드에서의
사용법이 알아야 할 기본 사용법이 됩니다.

기본 사용법만 한번 익히시면, GUI로 되어 있기 때문에 나머지 기능들도
연습 1~2번만으로도 활용할 수 있는  느낌이 금새 온 몸을 덮을겁니다.

그럼 또 달려볼까요~~

먼저 브라우져로 설치한 gitlab에 접속하셔서,root로 로그인 하시면, 아래와 같은 우측 상단 메뉴가 보입니다.

왼쪽 스패너 부터 마우스 올려보시면 Admin Area, New Project,Issues, Merge Request, Todos 와
Profile Settings Sign out 메뉴를 가진 동그라미가 있습니다.
메뉴이름이 직관적이어서 설명이 필요없습니다.

동그라미 >> Settings  의 Main settings에서 Email 부분을 본인 메일주소로  변경해줍니다.
Email 이외의 부분은 취향대로 자유롭게 하시면 됩니다.
SMTP 세팅에 문제가 없다면 본인메일주소로 링크가 포함된 confirm  메일이 와 있고, 해당 링크를 클릭하면
gitlab의 로그인 페이지로 연결 될겁니다.

화면 왼쪽 상단에 있는 까만 작대기 3개도 눌러보시면, Projects 부터 Help까지
자주 쓰게 되는 기능들을 메뉴로 모아 놓았습니다.  참 친절합니다.
친절함의 회답으로 잠시 시간을 내시어 오른쪽 상단메뉴부터 왼쪽 상단메뉴까지
휘리릭  클릭해보면서 눈인사 하는 척 GitLab의 전체적인 구성을 염탐해 둡니다.

 

USER 생성


유저를 생성하는 법은 크게 2가지 입니다.
유저가 직접 브라우져로 gitlab에 접속해서 register  하는 법과  gitlab 관리자가 등록해주는 법입니다.
여기서는 관리자(현상태에서는 root 1명)가 등록해 주는 것으로 하겠습니다.

화면 오른쪽 상단메뉴 스패너(Admin Area) 를 클릭하면 Overview  화면이 나오고,
하단부에 Projects ,  Users , Groups 가 현재 몇 개가 있는지와
각각을 추가할 수 있는 커다란 녹색 버튼이 보입니다.

가운데 있는 New user 버튼을 꾹 누릅니다.

위 그림 처럼 *required 붙은 부분은 꼭  채워주시고(Email은 정확하게),

Password 밑으로 있는 설정들은 만약 아주 친한 분의 계정을 생성하는 거라면
Projects limit는 기본값이 10000인데, 1억정도 주시고(어차피 다 사용하지 못하니까요~~)
Can create group 은 당연히  체크?
Access level은 아무리 친한 사이라 해도 Admin 권한을 줘도 되는지 한번 고민합니다.
Profile 부분은 계정 받으신 분이 나중에 채워야 겠지요.

왼쪽 하단 Create user 녹색 버튼을 누르면 유저가 생성되고,
해당 Email 주소로 아래와 같은 메일이 보내지고, 메일을 받은 사람(계정)은
링크를 타고 접속해서, 암호설정후 로그인 가능하게 됩니다

관리자는 일반 유저계정 정보 페이지에서 해당 계정을  Block[정지], Remove[삭제] 시킬수도 있으며,
Impersonate 버튼을  눌러, 해당유저의 대역역할을 해 줄 수도 있습니다.

 

 PROJECT 생성


프로젝트 생성은 위에서 만들어 준 USER(test)로 로그인해서 만들어 보겠습니다.
로그인 하면 관리자가 아니라서 오른쪽 상단메뉴에 스패너(Admin Area)는 빠지고,
+(New Project) 부터 나오고, 마지막 동그라미 색깔도 파란색 계열로 바뀝니다.

Project 추가를 위해 +를 눌러 줍니다.

자동으로 gitlab 서버ip 뒤에 유저 아이디가 붙어서 프로젝트 경로가 만들어집니다.
앞으로 test계정으로 만드는 모든 프로젝트는 이 경로 아래 붙게 됩니다.

Project name에 느낌오는 프로젝트명을 취향대로 써줍니다.
Project name 아래로, 그룹을 만들겠냐?, 다른 곳에서 프로젝트를 끌어오겠느냐?가 있고,
Project description(optional) 은 옵션이여서 안써도 되지만 , “연습용” 이라고 일단 간단히,
Visibility Level 은 Private은 허가 받은 유저만,  Internal은 로그인 계정을 받은 사람들만,
Public은 Anybody Everybody 누구나 볼 수 있다는 의미입니다.

상황을 쉽게 가져가기 위해서 Public 선택 후 왼쪽 하단 녹색 Create Project를 눌러줍니다.

왠지  Github에서 느껴졌던  그 느낌이 느껴지면서 프로젝트가 훨씬 잘 될 것 같습니다.

별과 HTTP,URL 복사버튼도 클릭해 보시고 ,+ 눌러서 파일도 한번 만들어보시고,
파란색으로 보이는 README 나 LICENSE 등도 눌러서 에디트 기능과도 눈인사를 해봅니다.

화면을 더 아래로 내려보시면, GitLab이 얼마나 친절한지 ,
커맨드 라인에서 Git명령어로 해당 프로젝트에 접속/사용하는 법도 알려줍니다.

현재 프로젝트에 아무것도 없으니, +를 눌러 New file 선택 후 Template >> LICENSE >> MIT License 클릭 후
Commit message에  ” 참 좋은 라이센스” 라고 쓴 후, 왼쪽 하단 녹색 Commit changes 를 꾹 눌러줍니다.

이제 다시 Project 메뉴를 클릭해 보시면, master에 라이센스 파일이 추가 되었음이 확인됩니다.

 

Client 사이드에서 사용


초 간략하나마 GitLab 서버에 테스트 해볼수 있는 프로젝트를 만들고, 파일도 1개 넣었으니
이제 네트워크내의 다른  컴퓨터에서 Git명령어로  작업하는 방법을 알아보겠습니다.

크게 서버의 프로젝트 파일을 클라이언트 쪽으로 복사해오는 것과 클라이언트 컴퓨터의 작업내용을
서버 프로젝트 파일에 반영하는 법 2가지만 보도록 하겠습니다.

GitLab은 Git을 바탕으로 만들어졌으니, 클라이언트 컴퓨터에서도
아래 명령어로 우선 Git을 설치해야 합니다.

$ sudo apt-get install git

## sudo apt-get install git-core 하시는 분들이 계신데
## apt-cache search git-core 명령어로 확인하시면 (obsolete) 이라고 뜨니
## git-core는 사용하지 않으시는 게 좋겠습니다.

git이 잘 설치가 되었다면, 서버의 프로젝트 메뉴에서 URL을 copy 하여
아래 코드처럼 git clone 명령 뒤에 붙이면, 서버에 만들었던 프로젝트가 그대로
컴퓨터에 복사되어 옴을 확인 할 수 있습니다.

$ cd ~
$ git clone http://test@192.168.0.111:9000/test/html5around.git
$ cd html5around
$ ls               ## 아까 만들었던 라이센스 파일 보임
$ git status

거꾸로 client 컴퓨터에서 변경한 내용을 서버에 있는 프로젝트에 합치려면 아래와 같이 합니다.

 $ pwd                                    ## ~/html5around 디렉토리인지 확인
 $ echo "Hello Html5Around" > test.txt    ## test.txt 파일 생성
 $ git add test.txt                       ## test.txt 파일을 git 작업 대상에 추가
 $ git commit -m "파일추가"                ## 메세지 "파일추가" 와 함께 commit실행
 $ git push -u origin master              ## 내용을 서버쪽에 반영하기 / 유저의 암호 물어봄
                                          ## 브라우져에서 프로젝트 내용확인하면 test.txt도 보임

 

마무리


어떻게 잘 활용할 수 있는 자신감이 생기셨는지 모르겠습니다.
Git을 먼저 따로 설명드렸어야 했었나 하는 애매한 느낌입니다. 🙂

연습으로 Group/Branch 만들기도 해보시고,  gitlab document 참고 하시어 과감하게 이것 저것 시도해 보시면,
금방 잘 쓰시게 될 거라고 생각됩니다.

참고로 SSH를 사용하시면, 훨씬 편리한데,  우분투에서 SSH설치,사용하기  참고 하시어, 키를 만든 후
gitlabt서버 User Setting 페이지에서 SSH Keys 메뉴를 클릭 후  key 텍스트 박스에
public key (~/.ssh/id_rsa.pub 파일 내용을 복사) 를 붙여 넣으시고,  아래 처럼 설정 하시면

$ git config --global user.name "test"
$ git config --global user.email "test@html5around.com"

HTTP대신  SSH URL을 이용하여 암호 필요없이 사용할 수 있어 훨씬 안전하고 편리합니다.

큰 프로젝트에나 필요하고, 작은 규모에는 판단여부에 따라 필요없는 기능도 많으니
너무 모든 기능을 사용하시려고 하는 것 보다는 적정선에서 타협을 보심이
좋을 것 같습니다. ~~

 

이 글이 누군가에게는 조금이나 도움이 되었으면 하는 작은 바램입니다.

 

소화자

존재를 드러내지 않고 무림의 배후를 조정하는 전설로만 전해지는 무엇이든 소화하는... 갑 오징어~^-^

3
Leave a Reply

avatar
2 Comment threads
1 Thread replies
0 Followers
 
Most reacted comment
Hottest comment thread
3 Comment authors
이성조소화자김기범 Recent comment authors
newest oldest most voted
김기범
Guest
김기범

많은 도움이 되었습니다. 감사합니다.

이성조
Guest
이성조

감사합니다. 많은 도움 되었네요…