소개
이 랩에서는 docker compose cp 명령어를 사용하여 서비스 컨테이너와 로컬 파일 시스템 간에 파일 및 디렉토리를 복사하는 방법을 배우게 됩니다. 먼저 Docker Compose 프로젝트를 설정하는 것으로 시작하여 Docker Compose 를 설치하고 Ubuntu 이미지를 기반으로 하는 서비스를 포함하는 기본 docker-compose.yml 파일을 생성합니다.
프로젝트 설정 후, 서비스 컨테이너에서 로컬 머신으로 파일을 복사하는 연습을 하고, 로컬 머신에서 서비스 컨테이너로 파일을 복사하는 연습을 할 것입니다. 마지막으로, 서비스 컨테이너에서 로컬 파일 시스템으로 전체 디렉토리를 복사하는 방법을 배우면서 Docker Compose 환경 내에서 데이터를 관리하기 위한 docker compose cp 명령어의 유연성을 보여줄 것입니다.
간단한 Docker Compose 프로젝트 준비
이 단계에서는 간단한 Docker Compose 프로젝트를 준비합니다. LabEx 환경에는 Docker Compose 가 미리 설치되어 있지 않으므로 먼저 설치합니다. Docker Compose 는 다중 컨테이너 Docker 애플리케이션을 정의하고 실행하기 위한 도구입니다. Compose 를 사용하면 YAML 파일을 사용하여 애플리케이션의 서비스를 구성합니다. 그런 다음, 단일 명령으로 구성에서 모든 서비스를 생성하고 시작합니다.
먼저 Docker Compose 를 설치해 보겠습니다. Docker Compose 바이너리를 다운로드하고 실행 가능하게 만듭니다.
sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
이제 Docker Compose 버전을 확인하여 설치를 확인해 보겠습니다.
docker-compose --version
Docker Compose version v2.20.2와 유사한 출력을 볼 수 있습니다.
다음으로, 간단한 Docker Compose 프로젝트를 생성합니다. 프로젝트용 디렉토리를 생성한 다음, 그 안에 docker-compose.yml 파일을 생성합니다. 이 파일은 ubuntu 이미지를 사용하여 간단한 서비스를 정의합니다.
mkdir ~/project/my-compose-app
cd ~/project/my-compose-app
nano docker-compose.yml
nano 편집기에서 다음 내용을 docker-compose.yml 파일에 붙여넣습니다.
version: "3.8"
services:
my-service:
image: ubuntu:latest
command: tail -f /dev/null
Ctrl + X, Y, Enter를 눌러 저장하고 편집기를 종료합니다.
docker-compose.yml 파일을 자세히 살펴보겠습니다.
version: '3.8'은 Docker Compose 파일 형식 버전을 지정합니다.services:는 애플리케이션을 구성하는 서비스를 정의합니다.my-service:는 서비스의 이름입니다.image: ubuntu:latest는 이 서비스에 사용할 Docker 이미지를 지정합니다. 최신 버전의 Ubuntu 이미지를 사용하고 있습니다.command: tail -f /dev/null은 컨테이너가 시작될 때 실행될 명령어입니다. 이 명령어는 컨테이너가 상당한 리소스를 소비하지 않고 무기한으로 실행되도록 유지하며, 이는 테스트 및 디버깅에 유용합니다.
서비스를 시작하기 전에 ubuntu:latest 이미지를 가져와야 합니다.
docker pull ubuntu:latest
이제 docker-compose up 명령어를 사용하여 서비스를 시작할 수 있습니다. -d 플래그는 컨테이너를 분리된 모드 (detached mode) 로 실행합니다. 즉, 백그라운드에서 실행됩니다.
docker-compose up -d
서비스가 생성되고 시작되고 있음을 나타내는 출력을 볼 수 있습니다.
마지막으로, docker-compose ps 명령어를 사용하여 실행 중인 서비스의 상태를 확인해 보겠습니다.
docker-compose ps
my-service 컨테이너가 실행 중임을 보여주는 출력을 볼 수 있습니다.
서비스 컨테이너에서 로컬 파일 시스템으로 파일 복사
이 단계에서는 실행 중인 Docker 컨테이너에서 로컬 파일 시스템으로 파일을 복사하는 방법을 배우게 됩니다. 이는 컨테이너 내부에서 생성된 로그, 구성 파일 또는 기타 데이터를 검색해야 할 때 일반적인 작업입니다.
이 목적을 위해 docker cp 명령어를 사용합니다. docker cp 명령어는 컨테이너와 로컬 파일 시스템 간에 파일/폴더를 복사합니다. 컨테이너에서 로컬 파일 시스템으로 복사하는 구문은 docker cp <container>:<src_path> <dest_path>이고, 로컬 파일 시스템에서 컨테이너로 복사하는 구문은 docker cp <src_path> <container>:<dest_path>입니다.
먼저, 실행 중인 my-service 컨테이너 내부에 간단한 파일을 생성해 보겠습니다. docker exec 명령어를 사용하여 컨테이너 내에서 명령어를 실행합니다. docker exec 명령어는 실행 중인 컨테이너에서 새 명령어를 실행합니다.
~/project/my-compose-app 디렉토리에 있는지 확인하십시오.
cd ~/project/my-compose-app
docker-compose exec my-service bash -c "echo 'This is a test file inside the container.' > /tmp/container_file.txt"
이 명령어는 my-service 컨테이너 내에서 bash 셸을 실행한 다음 echo 명령어를 실행하여 /tmp/container_file.txt라는 이름의 파일을 내용과 함께 생성합니다.
이제 이 파일을 컨테이너에서 로컬 파일 시스템으로 복사해 보겠습니다. 현재 디렉토리 (~/project/my-compose-app) 로 복사합니다.
docker-compose cp my-service:/tmp/container_file.txt .
docker-compose cp 명령어는 docker cp와 유사하지만, docker-compose.yml 파일에 정의된 서비스 이름으로 작동합니다. my-service는 서비스의 이름이고, /tmp/container_file.txt는 컨테이너 내부의 파일 경로이며, .은 로컬 파일 시스템의 현재 디렉토리를 나타냅니다.
명령어를 실행한 후, ~/project/my-compose-app 디렉토리에 container_file.txt 파일이 표시되어야 합니다. 존재 여부와 내용을 확인해 보겠습니다.
ls container_file.txt
cat container_file.txt
파일 이름이 나열되고 "This is a test file inside the container." 내용이 콘솔에 출력되는 것을 볼 수 있습니다.
로컬 파일 시스템에서 서비스 컨테이너로 파일 복사
이 단계에서는 로컬 파일 시스템에서 실행 중인 Docker 컨테이너로 파일을 복사하는 방법을 배우게 됩니다. 이는 컨테이너가 시작된 후 구성 파일, 스크립트 또는 기타 데이터를 컨테이너에 추가해야 할 때 유용합니다.
다시 docker cp 명령어를 사용하지만, 이번에는 반대 방향으로 사용합니다: docker cp <src_path> <container>:<dest_path>.
먼저, ~/project/my-compose-app 디렉토리의 로컬 파일 시스템에 간단한 파일을 생성해 보겠습니다.
cd ~/project/my-compose-app
echo "This file is from the local filesystem." > local_file.txt
이제 이 local_file.txt 파일을 로컬 파일 시스템에서 my-service 컨테이너 내부의 /tmp/ 디렉토리로 복사해 보겠습니다.
docker-compose cp local_file.txt my-service:/tmp/
여기서는 docker-compose cp 명령어가 사용됩니다. local_file.txt는 로컬 파일 시스템의 파일 경로이고, my-service는 서비스의 이름이며, /tmp/는 컨테이너 내부의 대상 디렉토리입니다.
파일이 성공적으로 복사되었는지 확인하기 위해, 컨테이너 내에서 파일을 확인하고 내용을 표시하는 명령어를 실행합니다.
docker-compose exec my-service cat /tmp/local_file.txt
이 명령어는 my-service 컨테이너 내에서 cat /tmp/local_file.txt 명령어를 실행합니다. 콘솔에 "This file is from the local filesystem." 내용이 출력되어 파일이 올바르게 복사되었음을 확인할 수 있습니다.
서비스 컨테이너에서 로컬 파일 시스템으로 디렉토리 복사
이 단계에서는 실행 중인 Docker 컨테이너에서 로컬 파일 시스템으로 전체 디렉토리를 복사하는 방법을 배우게 됩니다. 이는 애플리케이션 출력 디렉토리, 로그 디렉토리 또는 컨테이너 내에서 생성된 기타 디렉토리 구조를 검색하는 데 유용합니다.
파일을 복사하는 것과 유사하게, docker cp 명령어를 다시 사용하지만, 디렉토리 경로를 지정합니다.
먼저, 실행 중인 my-service 컨테이너 내부에 디렉토리와 몇 개의 파일을 생성해 보겠습니다. 컨테이너 내에서 명령어를 실행하기 위해 docker-compose exec를 사용합니다.
~/project/my-compose-app 디렉토리에 있는지 확인하십시오.
cd ~/project/my-compose-app
docker-compose exec my-service bash -c "mkdir /tmp/container_dir && echo 'File 1' > /tmp/container_dir/file1.txt && echo 'File 2' > /tmp/container_dir/file2.txt"
이 명령어는 my-service 컨테이너 내부에 /tmp/container_dir라는 디렉토리를 생성한 다음, 해당 디렉토리 내에 file1.txt와 file2.txt 두 개의 파일을 생성합니다.
이제 이 전체 디렉토리를 컨테이너에서 로컬 파일 시스템으로 복사해 보겠습니다. 현재 디렉토리 (~/project/my-compose-app) 로 복사합니다.
docker-compose cp my-service:/tmp/container_dir .
여기서는 docker-compose cp 명령어가 사용됩니다. my-service는 서비스의 이름이고, /tmp/container_dir는 컨테이너 내부의 디렉토리 경로이며, .은 로컬 파일 시스템의 현재 디렉토리를 나타냅니다.
명령어를 실행한 후, ~/project/my-compose-app 디렉토리에 container_dir라는 새 디렉토리가 표시되어야 합니다. 존재 여부를 확인하고 내용을 나열해 보겠습니다.
ls container_dir
ls container_dir/file1.txt container_dir/file2.txt
container_dir가 나열되고, 그 안에 있는 두 파일 (file1.txt 및 file2.txt) 의 이름이 나열되어야 합니다.
마지막으로, 시작한 Docker Compose 서비스를 정리해 보겠습니다.
docker-compose down
이 명령어는 docker-compose up으로 생성된 컨테이너, 네트워크 및 볼륨을 중지하고 제거합니다.
요약
이 랩에서는 docker compose cp 명령어를 사용하여 서비스 컨테이너와 로컬 파일 시스템 간에 파일 및 디렉토리를 복사하는 방법을 배웠습니다. 먼저, Docker Compose 를 설치하고 Ubuntu 이미지를 사용하는 기본 서비스를 정의하는 docker-compose.yml 파일을 생성하는 등 간단한 Docker Compose 프로젝트를 준비하는 것으로 시작했습니다.
프로젝트 설정을 완료한 후, 서비스 컨테이너에서 로컬 파일 시스템으로 파일 복사, 로컬 파일 시스템에서 서비스 컨테이너로 파일 복사, 마지막으로 서비스 컨테이너에서 로컬 파일 시스템으로 전체 디렉토리 복사를 실습했습니다. 이러한 단계는 Docker Compose 환경 내에서 데이터 전송을 관리하기 위한 docker compose cp 명령어의 실용적인 적용을 보여주었습니다.
