Windows10 에 gitlab 대신 gogs 설치하기, 그리고 간단 사용법

gogs

Windows 환경에 임시 개발환경을 구성해야 할 일이 생겼다. SCM(Source Code Management) 으로 git을 사용하고 자체 호스팅 git 서비스로 무엇을 쓸까 고민을 했다. linux에서는 gitlab을 쉽게 설치해서 사용을 했었는데 Windows10에 git을 설치하기는 생각보다 어려웠다. Windows 용으로 지원하는 파일도 없어서 docker를 사용해서 설치를 하려고 했는데 docker를 설치할 때 알수 없는 이유로 동작이 되지 않는다. 빠르게 구성을 해줘야 하는데 난감함에 봉착을 했을때! gogs라는것을 알게 되었다!

---

 

사전 준비사항으로는 물론 git 설치가 있다. Windows에서의 git 설치는 이 글을 참고하도록 하자. 

git 설치를 마쳤다면 이제 gogs를 설치하고 실행시켜 보자. 

 

gogs 설치 및 실행

 

From binary - Gogs

일단 gogs windows용을 위의 사이트에서 다운로드 받는다. 

 

gogs install

Windows 용 ZIP 파일을 다운로드 받는다. 용량이 크지 않아 금방 다운로드가 완료된다. 다운로드가 완료되면 적당한 위치로 이동시키고 압축을 풀어준다. 

 

gogs file

여기서 gogs.exe 파일을 실행시키면 cmd창이 순식간에 떴다가 사라지는것을 볼 수 있다. 뭐가 실행이 되려나? 하고 한참 기다려봐도 감감무소식이다. 나중에야 알았다.. 실행파일에 옵션을 주고 실행을 해야 한다는것을.. cmd 창을 열고 gogs.exe 파일이 있는 곳으로 이동을 하고 다음 명령어를 실행시켜보자. 

> gogs.exe web

gogs 실행화면

이렇게 컬러풀하게 로그가 찍히며 Listen 상태가 되면 실행상태가 된 것이다. gogs를 이용하는 동안은 cmd를 닫지 말자. cmd를 닫고도 이용하고 싶으면 service로 등록을 해주자. 

 

브라우저에 localhost:3000 을 입력하면 gogs의 설치화면이 다음과 같이 나올 것이다. 

 

gogs 최초 화면

여기서 다른 모든 것들은 변경 없이 그대로 사용하면 된다. 하지만 DB는 선택을 해야 한다. MySQL, PostgreSQL, MSSQL, TiDB, 그리고 SQLite3 을 지원한다고 되어 있다. SQLite3을 제외하고는 모두 직접 설치를 해야 한다. 필자와 같이 임시개발환경 구성을 위한 것이라면 별도로 설치를 할 필요가 없는 SQLite3을 사용하면 충분하다. 나머지 DB를 설치해서 정식으로 개발환경을 구성하려면 공홈에 있는 이 글을 참조하도록 하자. 

 

gogs SQLite3 

위와 같이 SQLite3을 설정하고 다른 설정을 바꾸고 싶은 것이 있다면 바꾸고 gogs 설치하기를 마무리 하면 된다. 

 

---

gogs 간단사용법

gogs 로그인

위의 과정을 모두 마치면 로그인창이 바로 나온다. 물론 계정이 없기에 위에서는 지금 가입하라는 곳으로 가서 가입을 해주면 된다. 

 

gogs 가입

가입을 하는데 인증같은건 필요 없다. 나중에 비밀번호 안까먹을 자신만 있다면 아무렇게 입력을 해도 된다. 새 계정 생성을 마치고 그 계정으로 로그인을 해본다. 

 

gogs 최초 로그인 화면

그럼 gitlab과 비슷한 조금은 익숙한 구조의 화면으로 넘어오게 되었다. 여기서 우측의 내 저장소 오른쪽에 있는 + 를 눌러서 새로운 프로젝트를 만들어 보자. 

 

gogs repo 생성

이렇게 입력하고 저장소 만들기를 누르면 된다. gitlab과 거의 사용법이 동일하다. 

 

gogs repo clone 정보

repo를 만들면 위와 같이 저장소에 대한 정보를 얻을 수 있고 이 이후로는 다음 글을 참고해서 gogs를 이용해보도록 하자. 

 

gogs 기본 사용법 및 권한관리 방법

 

 

끝!