우분투(Ubuntu) 22.04 도커(Docker), 도커 컴포즈(Docker-Compose) 설치법을 정리한 글입니다.
혹시, Docker Compose CURL 다운로드 과정에서 Failure writing output to destination 오류는 아래를 참고하세요!
A. 도커 (Docker) 설치
1. 시스템 업데이트
sudo apt-get update -y
sudo apt-get upgrade -y
2. 의존성 패키지 설치
sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
3. 도커 GPG 키 추가
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
4. 도커 레포지토리 설정
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
5. 도커 설치
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io
6. 도커 시작 및 활성화
sudo systemctl start docker
sudo systemctl enable docker
7. 도커 상태 확인
sudo systemctl status docker
위와 같이 초록색 active (running) 시 정상 작동 중입니다
8. 도커 실행 확인
sudo docker run hello-world
위와 같이 정상적으로 실행되면 도커가 성공적으로 설치된 것입니다.
B. 도커 컴포즈 (Docker-Compose) 설치
1. 도커 컴포즈 다운로드 및 설치
sudo curl -L "https://github.com/docker/compose/releases/download/v2.29.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
도커 컴포즈 최신 버전은 https://github.com/docker/compose/releases 에서 확인할 수 있습니다.
위 명령어에서 버전을 최신 버전 혹은 원하는 버전으로 변경하면 됩니다.
2. 도커 컴포즈 실행 권한 부여
sudo chmod +x /usr/local/bin/docker-compose
3. 도커 컴포즈 설치 확인
docker-compose --version
위와 같이 설치한 버전이 나오면 성공이다.
C. 도커 컴포즈 CURL 오류 발생 시
우분투 22.04 서버에서 도커 컴포즈 CURL 설치 시 아래와 같은 오류가 발생하는 경우가 있다.
오류 코드를 살펴보면 아래와 같다.
Failed to create the file /usr/local/bin/docker-compose: No such file or directory
curl: (23) Failure writing output to destination 오류 발생
위 오류는 설치하려는 대상 디렉토리인 /usr/local/bin 폴더가 없어서 나는 오류이므로 폴더를 만들어주면 간단히 해결된다.
1. /usr/local/bin 폴더 생성
sudo mkdir -p /usr/local/bin
이후 다시 CURL 명령어를 실행(위 B-1단계)하면 잘 설치가 된다.
D. 도커 권한 부여
도커를 `sudo` 없이 실행시키려면 아래 명령어를 통해 모든 유저가 도커에 접근할 수 있도록 해주면 된다.
sudo chmod 666 /var/run/docker.sock
위 명령어를 실행하면 super user가 아니더라도 sudo 없이 실행할 수 있다.
