맥에서 GitLab 설치 및 설정: Docker로 간편하게

 

안녕하세요, 개발자 여러분! 오늘은 맥(Mac)에 GitLab를 설치하고 설정하는 전 과정을 단계별로 다뤄보겠습니다. GitLab은 코드 저장소 관리, CI/CD, 이슈 트래킹 등 DevOps에 필수적인 기능을 제공하는 강력한 플랫폼입니다. 이번 가이드에서는 Docker를 활용해 GitLab을 설치하는데, Ruby와 Redis가 이미 이미지에 내장되어 있어 맥에 따로 설치할 필요 없이 간편하게 진행할 수 있습니다. 초보자도 따라 할 수 있도록 상세히 설명할게요!

1. 설치 전 준비: Docker와 기본 환경 점검

GitLab을 Docker로 설치하면 모든 의존성(Ruby, Redis, PostgreSQL 등)이 컨테이너 안에 포함되므로, 맥에서 준비할 것은 최소한으로 줄어듭니다. 아래에서 필요한 사전 작업을 확인해보죠.

1.1. Homebrew 설치

맥에서 소프트웨어를 쉽게 설치하려면 Homebrew가 유용합니다. Docker를 설치하기 위해 먼저 Homebrew를 준비합니다. 터미널을 열고 다음 명령어를 실행하세요:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

설치가 끝나면 brew --version으로 버전을 확인해 제대로 설치됐는지 체크하세요.

1.2. Docker 설치

GitLab을 컨테이너로 실행하려면 Docker가 필요합니다. Homebrew를 사용해 Docker Desktop을 설치합니다:

 

brew install --cask docker

설치 후, Finder에서 Docker 앱을 실행하고 상태바에 Docker 아이콘이 나타나는지 확인하세요. 처음 실행 시 설정 파일을 다운로드하므로 잠시 기다리셔야 합니다.

1.3. 시스템 요구 사항 확인

GitLab은 리소스를 꽤 사용합니다. Docker 이미지에는 Ruby와 Redis가 내장되어 있지만, 맥 자체의 성능이 중요합니다. 최소 4GB RAM(8GB 권장)과 10GB 이상의 저장 공간을 확보하세요. Docker Desktop에서 리소스 할당(CPU, 메모리)을 조정할 수도 있으니, 필요하면 설정을 확인해보세요.

1.4. Git 설치 (선택 사항)

GitLab은 Git을 기반으로 작동하며, 로컬에서 프로젝트를 클론하거나 푸시하려면 Git이 필요합니다. Docker 이미지에 Git이 포함되어 있지만, 맥에서 Git 명령어를 사용하려면 설치하세요:

 

brew install git

설치 후 git --version으로 확인합니다. 이건 GitLab 서버 설치와는 별개로 로컬 작업을 위한 준비입니다.

 

728x90

 

2. GitLab 설치: Docker로 빠르게

GitLab 공식 Docker 이미지(gitlab/gitlab-ce)는 Ruby와 Redis를 포함한 올인원 패키지입니다. 별도로 설치할 필요 없이 이미지 다운로드와 실행만으로 GitLab을 띄울 수 있습니다.

2.1. GitLab Docker 이미지 다운로드

터미널에서 최신 GitLab Community Edition(CE) 이미지를 가져옵니다:

 

docker pull gitlab/gitlab-ce:latest

다운로드가 완료되면 docker images 명령어로 이미지 목록을 확인하세요. gitlab/gitlab-ce와 태그(latest)가 보이면 성공입니다.

2.2. GitLab 컨테이너 실행

GitLab을 실행하려면 몇 가지 옵션을 설정해야 합니다. 아래 명령어를 입력해 컨테이너를 시작합니다:

 

docker run --detach \
  --hostname localhost \
  --publish 80:80 --publish 443:443 --publish 22:22 \
  --name gitlab \
  --restart always \
  --volume $HOME/gitlab/config:/etc/gitlab \
  --volume $HOME/gitlab/logs:/var/log/gitlab \
  --volume $HOME/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce:latest

• --detach: 백그라운드에서 실행.
• --hostname localhost: GitLab 서버의 호스트 이름(로컬 테스트용).
• --publish: 포트 매핑(HTTP 80, HTTPS 443, SSH 22).
• --name gitlab: 컨테이너 이름.
• --restart always: 맥 재부팅 시 자동 재시작.
• --volume: 설정, 로그, 데이터를 맥의 홈 디렉토리에 저장.

명령어를 실행하면 GitLab이 초기화되며, 처음엔 몇 분 정도 시간이 걸릴 수 있습니다. docker ps로 컨테이너가 실행 중인지 확인하세요.

2.3. Ruby와 Redis의 내장 확인 (궁금증 해소)

GitLab Docker 이미지에는 Ruby와 Redis가 포함되어 있습니다. 확인하고 싶다면 컨테이너에 들어가서 확인해볼 수 있어요:

• 컨테이너 접속: docker exec -it gitlab bash
• Ruby 확인: ruby --version (예: ruby 3.x.x)
• Redis 확인: redis-cli ping (응답: PONG)

이들은 컨테이너 내부에서 실행 중이며, 맥에 따로 설치하지 않아도 GitLab이 정상 작동합니다.

3. GitLab 초기 설정

GitLab이 실행되면 웹 브라우저로 접속해 초기 설정을 진행합니다.

3.1. GitLab에 접속

브라우저에서 http://localhost로 이동합니다. 처음 접속 시 관리자 계정의 초기 비밀번호를 설정하라는 화면이 나옵니다. 비밀번호를 입력하고 "Change your password"를 클릭하세요.

3.2. 관리자 로그인

기본 사용자 이름은 root이며, 방금 설정한 비밀번호로 로그인합니다. 성공하면 GitLab 대시보드가 표시됩니다.

3.3. 기본 설정 조정

• 프로필 설정: 상단 우측 프로필 아이콘을 클릭해 이름과 이메일을 업데이트하세요.
• SSH 키 등록: 로컬에서 GitLab에 푸시하려면 SSH 키가 필요합니다. 터미널에서 ssh-keygen -t rsa로 키를 생성하고, ~/.ssh/id_rsa.pub 내용을 GitLab의 "Settings > SSH Keys"에 추가합니다.
• URL 확인: 기본적으로 localhost로 설정되지만, 필요하면 --hostname을 다른 값(예: gitlab.example.com)으로 변경해 재실행합니다.

4. GitLab 사용 시작

설치와 설정이 끝났으니, 이제 GitLab을 활용해볼 차례입니다.

4.1. 첫 프로젝트 생성

대시보드에서 "New Project"를 클릭하고, 프로젝트 이름(예: my-first-project)과 설명을 입력합니다. "Create Project"를 누르면 저장소가 생성됩니다.

4.2. 로컬에서 GitLab 연결

로컬 터미널에서 프로젝트를 클론하고 첫 커밋을 해봅시다:

 

git clone http://localhost/root/my-first-project.git
cd my-first-project
echo "# My First Project" > README.md
git add .
git commit -m "Initial commit"
git push origin master

SSH를 설정했다면 git clone git@localhost:root/my-first-project.git처럼 SSH URL을 사용할 수도 있습니다.

 

 

728x90

 

5. 유지보수 및 문제 해결

GitLab을 오래 사용하려면 몇 가지 팁을 알아두면 좋습니다.

5.1. 포트 충돌 해결

80번 포트가 이미 사용 중이라면, --publish 8080:80으로 변경하고 http://localhost:8080으로 접속하세요.

5.2. 컨테이너 관리

• 중지: docker stop gitlab
• 재시작: docker start gitlab
• 로그 확인: docker logs gitlab

5.3. GitLab 업데이트

최신 버전으로 업그레이드하려면

docker stop gitlab
docker rm gitlab
docker pull gitlab/gitlab-ce:latest

그 후 처음 실행했던 docker run 명령어를 다시 실행하세요.

5.4. 성능 최적화

맥의 리소스가 부족할 경우, Docker Desktop의 "Preferences > Resources"에서 CPU와 메모리 할당을 늘리세요.

마무리

이제 맥에서 Docker를 사용해 GitLab을 설치하고 설정하는 과정을 완료했습니다! Ruby와 Redis가 내장된 Docker 이미지 덕분에 복잡한 의존성 설치 없이도 빠르게 환경을 구축할 수 있었죠. GitLab은 단순한 저장소를 넘어 CI/CD 파이프라인, 위키, 이슈 관리 등 다양한 기능을 제공하니, 필요에 따라 탐구해보세요. 궁금한 점이 있으면 언제든 댓글로 남겨주세요. 즐거운 코딩 되세요!