Docker 일반 계정에 권한 부여하기

서론.

이번 포스팅 글은 CI/CD github Action을 하는 과정에서 일반 계정 사용자를 이용하여 Deploy 했을 시 발생했던 이슈에 관하여 정리한 글입니다.

---

문제 발생 발단.

  - name: Bootup server
      uses: cross-the-world/ssh-scp-ssh-pipelines@latest
      with:
        host: ${{ secrets.HOST_IP }}
        user: ${{ secrets.POSTOFFICE_NAME }}
        pass: ${{ secrets.POSTOFFICE_PASS }}
        port: ${{ secrets.PORT }}
        connect_timeout: 10s
        first_ssh: |
          docker stop dailyroutine || true
          docker rm dailyroutine || true
          docker image rm dailyroutine:latest || true
          docker load -i /home/postoffice/dailyroutine/dailyroutine.tar
          docker run -d -p 32468:8080 --name dailyroutine

 

위의 실행 스크립트의 과정을 설명하자면

1. docker stop dailyroutine : dailyroutine 컨테이너 정지
2. docker rm dailyroutine : dailyroutine 컨테이너 삭제
3. docker image rm dailyroutine:latest: 이미지 dailyroutine 삭제
4. docker load -i : 새로 생성된 dailyroutine.tar 파일을 이미지 파일로 로드
5. docker run -d  : dailyroutine 이미지 컨테이너에 올림

 

에러 메세지.

permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Post "http://%2Fvar%2Frun%2Fdocker.sock/v1.45/containers/***/stop": dial unix /var/run/docker.sock: connect: permission denied
permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Delete "http://%2Fvar%2Frun%2Fdocker.sock/v1.45/containers/***": dial unix /var/run/docker.sock: connect: permission denied
permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Delete "http://%2Fvar%2Frun%2Fdocker.sock/v1.45/images/***:latest": dial unix /var/run/docker.sock: connect: permission denied

 

오류 글의 뜻은 간단합니다. 

 

Docker 소켓 권한 문제

 

'permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock' 은 Docker 데몬에 접근할 권한이 없다는 것을 의미합니다.

 

해결 방법.

Docker 소켓에 대한 권한을 조정하거나 Docker를 실행할 사용자에게 올바른 권한을 부여해야 합니다.

 

1. 권한을 조정한다는 것은 앞에 sudo를 붙여서 권한을 조정한다는 의미 입니다.

sudo docker stop dailyroutine || true
sudo docker rm dailyroutine || true
sudo docker image rm dailyroutine:latest || true
sudo docker load -i /home/dailyroutine/versions/dailyroutine.tar
sudo docker run -d -p 32468:8080 --name dailyroutine dailyroutine:latest

 

2. Docker 실행할 사용자에게 올바른 권한 주기

 

sudo usermod -aG docker $USER

 

우선 사용자 계정이 Docker 그룹의 일원인지 확인을 합니다.

 

만약 그룹이 아닐 경우에는 위의 명령어를 통해 docker 그룹의 일원이 되도록 설정합니다.

 

특정 사용자 계정에 대해 dockr 그룹에 추가를 하게 되면 sudo 명령어를 사용하지 않고 docker 명령어를 사용할 수 있습니다.

 

위의 설정을 진행한 후에는 도커를 재시작해 줍니다.

 

service docker restart # 우분투 기준

systemctl restart docker # Centos 기준