docker 를 티기고 티기는 WSL(Ubuntu) + docker cli + git에 이미지 올리기

📌 이 글은 Docker & 배포 자동화 시리즈 중 하나입니다.

Windows에서 WSL(Ubuntu) + Docker CLI + Git 이미지 올리기 전체 과정

1. WSL2 설치 (Windows Terminal, PowerShell 관리자 모드)

wsl --install

WSL 설치 상태 확인

wsl --list --verbose

Ubuntu 설치 (필요한 경우)

wsl --install -d Ubuntu

기본 WSL2로 설정 (확인용)

wsl --set-default-version 2

---

2. Ubuntu 실행

wsl -d Ubuntu

또는

시작 메뉴 → Ubuntu 검색 → 실행

---

3. 초기 사용자 계정 생성

실행 시 다음처럼 입력

Enter new UNIX username: yourname
New password: ********
Retype new password: ********

---

4. Ubuntu 패키지 업데이트

sudo apt update
sudo apt upgrade -y

---

5. Git 설치

sudo apt install -y git

Git 버전 확인

git --version

---

6. Docker Engine 설치

sudo apt install -y ca-certificates curl gnupg lsb-release

sudo mkdir -m 0755 -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Docker 데몬 실행

sudo service docker start

---

7. Docker 빌드 준비

cd /path/to/your/project

Dockerfile 확인

ls -l Dockerfile

---

8. Docker 이미지 빌드

sudo docker build -t myimage:latest .

이미지 확인

sudo docker images

---

9. Docker 이미지 tar 파일로 저장

sudo docker save -o myimage.tar myimage:latest

tar 파일 확인

ls -lh myimage.tar

---

10. Git 저장소 준비

(필요하다면)

git init

기존 저장소 클론 (필요하다면)

git clone https://github.com/사용자명/저장소명.git
cd 저장소명

---

11. Git에 Docker 이미지 파일 올리기

git add myimage.tar
git commit -m "Add Docker image file"
git push origin main

---

⚠ 주의 사항

• Docker 이미지 tar 파일은 매우 크기 때문에 Git LFS 사용을 권장합니다.
• GitHub 일반 저장소는 파일 2GB 이하까지만 가능.