현상

윈도우 환경에서 도커를 사용하여 GitLab을 사용하고자 할 때. psql 관련 오류를 내면서 정상적인 동작을 하지 않는 현상이 발생한다.

원인

GitLab 공식 가이드를 비롯한 여러 곳에서 주는 설정을 그대로 적용 시

/var/opt/gitlab 경로가 도커 외부와 연결되어 사용할 때 문제가 있는 것으로 보인다.

해결

컨테이너 구성 시 /var/opt/gitlab 경로는 윈도우 경로로 잡지 않고 구성한다.

docker volume create gitlab-data

이때, 해당 볼륨을 컨테이너 내려도 유지할 수 있도록 별도로 만들어준다.

docker-compose.yml 파일 예시

...
services:
  gitlab:
    ...
    volumes:
      - '호스트_경로/config:/etc/gitlab'
      - '호스트_경로/logs:/var/log/gitlab'
      - 'gitlab-data:/var/opt/gitlab'
      - '호스트_경로/backup:/var/opt/gitlab/backups'
...
volumes:
  gitlab-data:
    external: true

(로그 파일이나 config 파일은 윈도우 시스템과 문제 생기는 일은 없으니 도커 외부와 연결해도 무방하다.)

이때, 데이터는 별도로 만들어둔 볼륨을 사용하도록 하고 내부에 백업 경로만 윈도우에서 접근 가능하도록 합니다.

그러나 리눅스 환경에서 도커를 운영했다면 애초에 이러한 일이 발생하지 않는다.