Synology NAS를 도입한 이후 서버PC에서 호스팅 중이던 Gitlab을 NAS로 Migration하는 과정을 옮겨 적고자 합니다.
굳이 설명이 필요하지 않은 간단한 부분들은 빠르게 넘기도록 하겠습니다.
Synology NAS의 DSM(DiskStation Manager)에 접속한 뒤 Container Manager를 설치합니다.
레지스트리 항목에서 gitlab을 검색 후 gitlab/gitlab-ce를 다운로드합니다.
태그는 latest또는 원하는 버전을 선택해 다운로드합니다.
이후 이미지 탭에 해당 이미지가 제대로 다운로드 되었는지 확인합니다.
(설치 후 최신 버전이 업데이트 되어서 (업데이트 사용 가능)이라는 메세지가 표시되는데, 무시하셔도 됩니다.)
컨테이너 항목으로 이동해 생성을 클릭합니다.
다운로드받은 이미지를 선택하고, 컨테이너 이름을 원하는대로 지어줍니다.
리소스 제한 활성화는 NAS에 장착된 RAM이 8GB 이상일 때에만 설정하는 것을 추천드립니다.
(Gitlab 인스턴스를 1개 호스팅하는 기준으로 4GB 정도의 RAM이 있어야 원활히 동작하는 것 같습니다.)
자동 재시작 활성화는 체크 하는걸 추천드립니다.
Web Station을 통해 웹 포털 설정은, 해당 방법으로 호스팅해도 되고 안해도 됩니다.
저는 두 방법을 모두 사용해봤지만 우선 사용하지 않는 방식으로 설명하겠습니다.
SSH, HTTPS, HTTP 각각에 대해 사용하고 싶은 포트를 할당합니다.
좌측에 설정한 포트로 들어온 신호를 컨테이너 안의 포트로 포워딩해줍니다.
HTTPS를 사용하지 않는다면 - 버튼으로 삭제하셔도 됩니다.
저는 나중에 활성화할것을 염두해 모두 살려놓겠습니다.
볼륨 설정에서 폴더 추가 버튼을 누른 뒤 해당 폴더를 생성해 선택합니다.
위와 같이 설정해줍니다. backup 경로도 추가할 수 있지만, 따로 추가하진 않았습니다.
환경, 기능, 네트워크, 실행 명령, 링크는 수정하지 않고 위와 같이 그대로 유지합니다.
다음, 완료를 눌러 컨테이너 생성을 마무리합니다.
컨테이너 생성이 완료되었습니다.
환경에 따라 2~10분 뒤에 http://NAS_IP:HTTP_PORT로 접속을 시도해주세요.
컨테이너가 실행된 직후에는 위와 같은 화면이 나오는 것이 정상입니다.
일정 시간 뒤 컨테이너가 초기화고 접속하면 위와 같은 화면이 표시됩니다.
컨테이너 부팅은 완료되었고, Gitlab이 실행되는 과정입니다.
5초마다 페이지가 자동으로 새로고침되니 Gitlab 로그인 화면이 나올 때까지 대기하시면 됩니다.
Gitlab 인스턴스가 성공적으로 세팅되었습니다.
이제 접속하기 위한 root 계정의 비밀번호가 필요합니다.
root 계정 비밀번호는 컨테이너 안 /etc/gitlab 폴더의 initial_root_password 파일에 저장되어있습니다.
해당 파일을 찾기 위해 bash로 접근하셔도 되고,
DSM의 File Station앱을 이용해 텍스트 편집기로 열거나 다운로드하셔도 됩니다.
File Station에서 찾으시려면, 위의 폴더에서 지정했던 /docker/gitlab-tistory/config 폴더에서 찾을 수 있습니다.
여기서는 터미널로 접근하는 방법을 설명하겠습니다.
Container Manager의 컨테이너 탭에서 새로 생성한 컨테이너(gitlab-tistory)를 클릭합니다.
이후 작업-터미널 열기를 클릭합니다.
터미널 초기 화면입니다.
생성 버튼을 누릅니다.
위와 같이 새로운 명령 창이 열립니다.
`cat /etc/gitlab/initial_root_password | grep Password:` 명령어를 이용하여 패스워드를 읽어옵니다.
(Ctrl + C 로 복사가 안돼 마우스 우클릭 + 복사로 복사하셔야합니다.)
성공적으로 로그인되었습니다.
비밀번호 변경을 위해 프로필 이미지 클릭 - Edit profile을 클릭합니다.
좌측에서 Password 탭을 선택한 뒤 비밀번호를 원하는 비밀번호로 변경합니다.
이걸로 Gitlab 설정이 완료되었습니다.
포트포워딩을 통해 외부망에서 접근하는 법과
external_url 설정법은 추후에 별도의 글로 작성하겠습니다.
감사합니다.
'개발' 카테고리의 다른 글
[Synology NAS DS1522+] Gitlab 호스팅 시 external_url 설정법 (0) | 2025.03.19 |
---|