맥북에서 Docker Desktop으로 GitLab 실행하기

이번 포스트에서는 Apple Silicon(M4) 기반 맥북에서 Docker Desktop을 이용해 **GitLab Community Edition(GitLab CE)**을 실행하는 방법을 소개합니다.
docker-compose.yml 파일을 활용해 손쉽게 GitLab 컨테이너를 구성하고, 초기 설정까지 완료해보겠습니다.

 

1. docker-compose.yml 파일 생성

먼저 GitLab 컨테이너를 정의하는 docker-compose.yml 파일을 생성합니다.
M1, M2, M3, M4 맥북은 ARM 아키텍처 기반이기 때문에, platform: linux/amd64 설정을 명시해줘야 정상적으로 GitLab이 실행됩니다.

version: '3.6'

services:
  gitlab:
    image: gitlab/gitlab-ce:latest
    platform: linux/amd64
    container_name: gitlab
    restart: always
    hostname: 'localhost'
    environment:
      GITLAB_OMNIBUS_CONFIG: |
        external_url 'http://localhost'
    ports:
      - '8088:80'
      - '443:443'
      - '22:22'
    volumes:
      - './gitlab/config:/etc/gitlab'
      - './gitlab/logs:/var/log/gitlab'
      - './gitlab/data:/var/opt/gitlab'

 

참고: 8088 포트를 호스트와 매핑했기 때문에, GitLab 웹 UI는 http://localhost:8088에서 접근 가능합니다.

 

 

2. 폴더 구성 및 실행

docker-compose.yml 파일을 관리하기 위해 프로젝트용 디렉터리를 구성해줍니다.
저는 홈 디렉터리 하위에 gitlab 폴더를 만들어 docker-compose.yml 파일을 위치시켰습니다.

mkdir ~/gitlab
cd ~/gitlab
# 위의 docker-compose.yml 파일을 이 위치에 저장

 

이제 아래 명령어로 GitLab 컨테이너를 실행합니다.

docker-compse up -d

 

개인 설정에 따라 macOS 부팅 시 자동으로 실행되도록 설정할 수도 있고, 필요할 때마다 위 명령어로 수동 실행해도 됩니다.

 

3. 관리자 계정 초기 비밀번호 설정

GitLab이 정상적으로 실행되고 나면, 브라우저에서 http://localhost:8088로 접속하면 로그인 화면이 표시됩니다.

처음 접속 시, root 계정의 비밀번호가 설정되지 않았기 때문에 수동으로 설정해주어야 합니다.

docker exec -it gitlab gitlab-rails console

GitLab의 Rails 콘솔에 진입한 뒤, 아래 명령어로 비밀번호를 설정합니다. 비밀번호는 원하는 값으로 변경하세요.

 

u = User.find_by(username: 'root')
u.password = 'SecureP@ssw0rd!'
u.password_confirmation = 'SecureP@ssw0rd!'
u.save!

정상적으로 저장되었다면, 다시 웹 브라우저로 이동해 root 계정으로 로그인하면 됩니다!