+
+ {{-- ============================================================ --}}
+ {{-- 히어로 배너 --}}
+ {{-- ============================================================ --}}
+
+
+{{-- Lightbox --}}
+
+
+
+
+
+
+
+
+ 아카데미
+
+ Docker 명령어
+
+ Docker 명령어
+SAM 프로젝트 로컬 Docker 환경에서 반드시 알아야 할 명령어 — 실전 중심 가이드
+
+
+
+ 🐳
+
+
+ {{-- ============================================================ --}}
+ {{-- 좌측 고정 목차 (TOC) --}}
+ {{-- ============================================================ --}}
+
+
+ {{-- ============================================================ --}}
+ {{-- 우측 콘텐츠 --}}
+ {{-- ============================================================ --}}
+
+
+
+ {{-- 모바일 목차 --}}
+
+
+
+ {{-- ============================================================ --}}
+ {{-- 2. 컨테이너 제어 --}}
+ {{-- ============================================================ --}}
+
+
+
+ {{-- ============================================================ --}}
+ {{-- 3. 컨테이너 진입 & 실행 --}}
+ {{-- ============================================================ --}}
+
+
+
+ {{-- ============================================================ --}}
+ {{-- 4. 로그 확인 --}}
+ {{-- ============================================================ --}}
+
+
+
+ {{-- ============================================================ --}}
+ {{-- 5. Docker Compose --}}
+ {{-- ============================================================ --}}
+
+
+
+ {{-- ============================================================ --}}
+ {{-- 6. 볼륨 & 네트워크 --}}
+ {{-- ============================================================ --}}
+
+
+
+ {{-- ============================================================ --}}
+ {{-- 7. 트러블슈팅 --}}
+ {{-- ============================================================ --}}
+
+
+
+ {{-- ============================================================ --}}
+ {{-- 8. 위험한 명령어 --}}
+ {{-- ============================================================ --}}
+
+
+
+
+
+
+
+ {{-- ============================================================ --}}
+ {{-- 1. Docker 기본 확인 --}}
+ {{-- ============================================================ --}}
+
+
+ + + 목차 보기 +
+ +
+
+ + 1 + Docker 기본 확인 +
+ +
+
+
+ + + docker ps — 실행 중인 컨테이너 확인 + ?가장 자주 쓰는 명령어. "지금 어떤 컨테이너가 돌아가고 있지?" 궁금할 때 사용한다. +
+
+
+ 비유: 사무실 좌석 현황판
+
+ 사무실 출입구에 있는 좌석 현황판처럼, docker ps는
+ 지금 근무 중인(실행 중인) 컨테이너 목록을 보여준다.
+
+
+
+
+
+ 기본
+ 실행 중인 컨테이너만
+
+ $ docker ps
+CONTAINER ID IMAGE STATUS NAMES
+a1b2c3d4 sam-mng Up 2 hours sam-mng-1
+e5f6g7h8 sam-api Up 2 hours sam-api-1
+i9j0k1l2 mysql:8.0 Up 2 hours sam-mysql-1
+m3n4o5p6 nginx:alpine Up 2 hours sam-nginx-1
+
+
+
+ 응용
+ 모든 컨테이너 (중지된 것 포함)
+
+ $ docker ps -a
+# -a = all. 중지된 컨테이너까지 전부 보여준다
+CONTAINER ID IMAGE STATUS NAMES
+a1b2c3d4 sam-mng Up 2 hours sam-mng-1
+q7r8s9t0 sam-react Exited (0) 3 hours ago sam-react-1
+
+
+ + + docker images — 설치된 이미지 목록 + ?이미지는 컨테이너를 만들기 위한 "설계도"이다. 어떤 설계도가 설치되어 있는지 확인할 때 사용한다. +
+
+
+ $ docker images
+REPOSITORY TAG IMAGE ID SIZE
+sam-mng latest abc123def 650MB
+sam-api latest 456ghi789 620MB
+mysql 8.0 jkl012mno 580MB
+nginx alpine pqr345stu 40MB
+
+
+ + 2 + 컨테이너 제어 +
+ +
+
+ + + start / stop / restart + ?컨테이너를 시작, 중지, 재시작하는 명령어. 전원 버튼을 누르는 것과 같다. +
+
+
+ 비유: 가전제품 전원 관리
+
+ stop은 TV 끄기,
+ start는 TV 켜기,
+ restart는 TV를 껐다 다시 켜는 것이다.
+
+
+
+
+
+ 시작
+ 컨테이너 시작
+
+ $ docker start sam-api-1
+# 중지된 컨테이너를 다시 시작
+
+
+
+ 중지
+ 컨테이너 중지
+
+ $ docker stop sam-mng-1
+# 실행 중인 컨테이너를 안전하게 중지
+
+
+
+ 재시작
+ 컨테이너 재시작
+
+ $ docker restart sam-api-1
+# stop + start를 한 번에. 설정 변경 후 자주 사용
+
+
+
+ 응용
+ 여러 컨테이너 한번에
+
+ # 여러 컨테이너를 한 번에 중지/시작/재시작
+$ docker stop sam-api-1 sam-mng-1
+$ docker start sam-api-1 sam-mng-1
+$ docker restart sam-api-1 sam-mng-1 sam-nginx-1
+
+
+ + 3 + 컨테이너 진입 & 실행 +
+ +
+
+
+ + + docker exec — 컨테이너 안에서 명령 실행 + ?실행 중인 컨테이너 "안으로 들어가서" 명령어를 실행한다. SAM에서 가장 많이 쓰는 핵심 명령어이다. +
+
+
+ 비유: 회의실에 들어가서 지시하기
+
+ docker exec는
+ 컨테이너라는 방 안에 들어가서 명령을 전달하는 것이다.
+ 내 PC(WSL)에는 PHP가 없지만, 컨테이너 안에는 있으므로 exec로 실행한다.
+
+
+
+
+
+
+ 기본
+ 명령어 한 줄 실행
+
+ $ docker exec sam-api-1 php artisan migrate
+# sam-api-1 컨테이너 안에서 php artisan migrate 실행
+
+
+
+ 대화형
+ 컨테이너 안에 직접 들어가기 (-it)
+
+ $ docker exec -it sam-api-1 bash
+# -i = interactive (키보드 입력 가능)
+# -t = tty (터미널 화면 할당)
+# bash = 쉘 프로그램 실행
+root@a1b2c3d4:/var/www/html# ← 컨테이너 안에 들어온 상태
+root@a1b2c3d4:/var/www/html# exit ← exit로 빠져나오기
+
+
+ -it 언제 쓰나?
+
+
+ 쓰지 않아도 되는 경우: 명령어 하나만 실행하고 끝날 때 docker exec sam-api-1 php artisan migrate
써야 하는 경우: 컨테이너 안에서 여러 명령을 연속으로 할 때, 또는 tinker처럼 대화형 프로그램을 실행할 때
+
+ + + SAM 프로젝트 전용 명령어 패턴 +
+
+
+
+ !
+
+
+
+ 핵심: 마이그레이션은 반드시 API 컨테이너에서!
+MNG에서 마이그레이션 실행 금지. 모든 DB 관련 작업은 sam-api-1에서만 실행한다.
+
+
+
+
+
+ | 목적 | +명령어 | +
|---|---|
| 마이그레이션 | +docker exec sam-api-1 php artisan migrate |
+
| 캐시 클리어 (MNG) | +docker exec sam-mng-1 php artisan cache:clear |
+
| 캐시 클리어 (API) | +docker exec sam-api-1 php artisan cache:clear |
+
| 설정 초기화 | +docker exec sam-api-1 php artisan config:clear |
+
| Composer 설치 | +docker exec sam-api-1 composer install |
+
| Tinker (대화형) | +docker exec -it sam-api-1 php artisan tinker |
+
| MySQL 접속 | +docker exec -it sam-mysql-1 mysql -u root -proot samdb |
+
| Pint 포맷팅 (MNG) | +docker exec sam-mng-1 ./vendor/bin/pint |
+
| 라우트 목록 | +docker exec sam-mng-1 php artisan route:list |
+
+
+
+
+ sam-api-1
+API 서버 (Laravel)
마이그레이션, 시더, API
+
+ sam-mng-1
+관리자 웹 (Laravel)
뷰, 라우트, 포맷팅
+
+ sam-mysql-1
+MySQL 데이터베이스
DB 접속, 쿼리 실행
+
+ + 4 + 로그 확인 +
+ +
+
+ + + docker logs — 컨테이너 로그 보기 + ?컨테이너가 출력하는 모든 메시지(에러, 접속 기록 등)를 확인할 수 있다. 오류 원인을 찾을 때 필수. +
+
+
+
+
+
+ 기본
+ 전체 로그 보기
+
+ $ docker logs sam-api-1
+# 컨테이너 시작부터 지금까지의 모든 로그 출력
+
+
+
+ 응용
+ 최근 N줄만 보기 (--tail)
+
+ $ docker logs --tail 50 sam-nginx-1
+# 최근 50줄만 출력. 로그가 많을 때 유용
+
+
+
+ 실시간
+ 실시간 로그 추적 (-f)
+
+ $ docker logs -f sam-api-1
+# -f = follow. 새 로그가 생기면 실시간으로 표시
+# Ctrl + C 로 종료
+
+
+
+ 시간 필터
+ 특정 시간 이후 로그 (--since)
+
+ $ docker logs --since 30m sam-api-1
+# 최근 30분 이내의 로그만 출력
+$ docker logs --since 2h sam-mng-1
+# 최근 2시간 이내의 로그만 출력
+
+
+
+ 조합
+ 실무에서 가장 많이 쓰는 조합
+
+ $ docker logs --tail 100 -f sam-api-1
+# 최근 100줄 출력 후 실시간 추적. 실무 디버깅의 기본!
+
+
+ + 5 + Docker Compose +
+ +
+
+ + + 주요 명령어 + ?Docker Compose는 여러 컨테이너를 한 번에 관리하는 도구이다. docker-compose.yml 파일에 모든 설정이 정의되어 있다. +
+
+
+
+ 비유: 오케스트라 지휘자
++ Docker Compose는 오케스트라 지휘자와 같다. 지휘자가 악보(docker-compose.yml) 하나로 + 모든 악기(컨테이너)를 동시에 시작·중지·조율하듯, Compose는 여러 컨테이너를 한 번에 관리한다. +
+
+
+
+ SAM의 docker-compose.yml 위치
+/home/aweso/sam/docker-compose.yml
모든 docker compose 명령어는 이 파일이 있는 디렉토리(/home/aweso/sam)에서 실행해야 한다.
+
+
+
+
+ 시작
+ 모든 컨테이너 시작
+
+ $ cd /home/aweso/sam
+$ docker compose up -d
+# -d = detached (백그라운드 실행)
+# docker-compose.yml에 정의된 모든 서비스를 한 번에 시작
+
+
+
+ 종료
+ 모든 컨테이너 종료
+
+ $ docker compose down
+# 모든 컨테이너를 중지하고 제거
+# 볼륨(DB 데이터)은 유지됨!
+
+
+
+ 상태
+ 서비스 상태 확인
+
+ $ docker compose ps
+NAME SERVICE STATUS PORTS
+sam-api-1 api running 9000/tcp
+sam-mng-1 mng running 9000/tcp
+sam-mysql-1 mysql running 3306/tcp
+sam-nginx-1 nginx running 0.0.0.0:80->80/tcp
+
+
+
+ 로그
+ 전체 서비스 로그 보기
+
+ $ docker compose logs -f
+# 모든 서비스의 로그를 한 화면에서 실시간 추적
+
+$ docker compose logs -f api mng
+# 특정 서비스만 골라서 로그 확인
+
+
+
+ 재시작
+ 특정 서비스만 재시작
+
+ $ docker compose restart api
+# api 서비스만 재시작 (다른 서비스는 그대로)
+
+$ docker compose restart
+# 모든 서비스 재시작
+
+
+ + 6 + 볼륨 & 네트워크 +
+ +
+
+
+ + + 볼륨 관리 + ?볼륨은 컨테이너 데이터를 영구 저장하는 공간이다. 컨테이너를 삭제해도 볼륨에 저장된 데이터(DB 등)는 남아 있다. +
+
+
+ 비유: USB 외장하드
++ 컨테이너가 컴퓨터라면, 볼륨은 USB 외장하드이다. + 컴퓨터(컨테이너)를 바꿔도 외장하드(볼륨)에 저장한 데이터는 그대로 남아 있다. +
+
+
+
+
+
+ $ docker volume ls
+# 생성된 볼륨 목록 조회
+DRIVER VOLUME NAME
+local sam_mysql-data
+local sam_phpmyadmin-data
+
+
+ $ docker volume inspect sam_mysql-data
+# 볼륨의 상세 정보(저장 위치 등) 확인
+
+
+
+
+
+ | 볼륨 이름 | +용도 | +삭제 시 영향 | +
|---|---|---|
| sam_mysql-data | +MySQL 데이터 저장 | +DB 데이터 전체 삭제! | +
| sam_phpmyadmin-data | +phpMyAdmin 세션 | +영향 미미 | +
+
+ + + 네트워크 관리 + ?Docker 네트워크는 컨테이너들이 서로 통신하는 가상 네트워크이다. SAM의 모든 컨테이너는 samnet이라는 하나의 네트워크에 연결되어 있다. +
+
+
+
+
+ $ docker network ls
+# Docker 네트워크 목록 조회
+NETWORK ID NAME DRIVER SCOPE
+abc123def samnet bridge local
+
+
+ $ docker network inspect samnet
+# samnet에 연결된 컨테이너 목록과 IP 주소 확인
+
+
+ SAM 네트워크 구조
+
+ 모든 SAM 컨테이너는 samnet 브리지 네트워크에 연결되어 있다.
+ 같은 네트워크 안에서는 컨테이너 이름으로 서로 접근할 수 있다.
+ 예: API 컨테이너가 MySQL에 접속할 때 sam-mysql-1:3306으로 연결한다.
+
+
+ + 7 + 트러블슈팅 +
+ +
+
+ + + 자주 발생하는 문제 & 해결 방법 +
+ + {{-- 문제 1 --}} +
+
+
+ {{-- 문제 2 --}}
+
+
+ 문제 1: "사이트에 연결할 수 없음" (mng.sam.kr 접속 불가)
+원인: Docker 컨테이너가 실행되지 않았거나 중지된 상태
+해결:
+$ docker ps # 실행 중인 컨테이너 확인
+$ cd /home/aweso/sam
+$ docker compose up -d # 모든 서비스 시작
+
+
+
+ {{-- 문제 3 --}}
+
+
+ 문제 2: "500 Server Error" (서버 내부 오류)
+원인: PHP 오류, .env 설정 문제, 캐시 문제 등
+해결:
+# 1. 로그 확인 (원인 파악)
+$ docker logs --tail 50 sam-mng-1
+
+# 2. 캐시 전부 클리어
+$ docker exec sam-mng-1 php artisan config:clear
+$ docker exec sam-mng-1 php artisan cache:clear
+$ docker exec sam-mng-1 php artisan view:clear
+
+
+
+ {{-- 문제 4 --}}
+
+
+ 문제 3: "Class not found" (클래스를 찾을 수 없음)
+원인: Composer autoload가 갱신되지 않았거나, 새 패키지 설치가 필요
+해결:
+$ docker exec sam-mng-1 composer dump-autoload
+# 또는 composer install로 전체 의존성 재설치
+$ docker exec sam-mng-1 composer install
+
+
+
+ {{-- 문제 5 --}}
+
+
+ 문제 4: "Connection refused" (MySQL 접속 실패)
+원인: MySQL 컨테이너가 아직 시작되지 않았거나, .env의 DB 설정이 잘못됨
+해결:
+# 1. MySQL 컨테이너 상태 확인
+$ docker ps -a | grep mysql
+# STATUS가 "Up"인지 확인
+
+# 2. MySQL이 중지되어 있다면 시작
+$ docker start sam-mysql-1
+
+# 3. MySQL 접속 테스트
+$ docker exec -it sam-mysql-1 mysql -u root -proot samdb
+
+
+
+ {{-- SAM 캐시 클리어 총정리 --}}
+
+
+ 문제 5: "Permission denied" (권한 오류)
+원인: storage, bootstrap/cache 디렉토리의 쓰기 권한이 없음
+해결:
+$ docker exec sam-mng-1 chmod -R 777 storage bootstrap/cache
+# storage와 bootstrap/cache에 모든 권한 부여
+
+
+ + 🧹 SAM 캐시 클리어 총정리 (외우면 좋은 명령어) +
+# === MNG 캐시 클리어 ===
+$ docker exec sam-mng-1 php artisan config:clear # 설정 캐시
+$ docker exec sam-mng-1 php artisan cache:clear # 앱 캐시
+$ docker exec sam-mng-1 php artisan view:clear # 뷰 캐시
+$ docker exec sam-mng-1 php artisan route:clear # 라우트 캐시
+
+# === API 캐시 클리어 ===
+$ docker exec sam-api-1 php artisan config:clear
+$ docker exec sam-api-1 php artisan cache:clear
+$ docker exec sam-api-1 php artisan view:clear
+$ docker exec sam-api-1 php artisan route:clear
+
+ 팁: .env 파일을 수정했다면 반드시 config:clear를 실행해야 변경이 적용된다.
+
+
+ + 8 + 위험한 명령어 +
+ +
+
+
+
+
+
+ !
+
+
+
+ 경고: 아래 명령어는 데이터 손실을 유발할 수 있다
++ 의미를 정확히 이해하지 않은 채 실행하면 DB 데이터 전체 삭제, 이미지 삭제 등 돌이킬 수 없는 피해가 발생할 수 있다. + 반드시 팀장이나 담당 개발자에게 확인 후 실행하자. +
+
+
+
+ {{-- 안전 체크리스트 --}}
+
+
+
+
+ 위험도 ★★★
+ docker compose down -v
+
+ $ docker compose down -v
+# -v = volumes. 컨테이너뿐만 아니라 볼륨(DB 데이터)까지 전부 삭제!
+# MySQL 데이터가 완전히 사라진다. 절대 함부로 실행하지 말 것!
+
+ 안전한 대안: docker compose down (-v 없이) — 볼륨은 유지하면서 컨테이너만 종료
+
+
+
+
+ 위험도 ★★★
+ docker system prune -a
+
+ $ docker system prune -a
+# 사용하지 않는 모든 이미지, 네트워크, 컨테이너를 일괄 삭제
+# SAM 이미지까지 삭제되어 docker compose up 시 처음부터 빌드해야 함
+
+ 디스크 공간이 부족하다면: docker image prune — 안 쓰는 이미지만 선별 삭제
+
+
+
+
+ 위험도 ★★
+ docker rm -f
+
+ $ docker rm -f sam-api-1
+# -f = force. 실행 중인 컨테이너를 강제로 삭제
+# 정상적인 종료 절차 없이 즉시 제거됨
+
+ 안전한 대안: docker stop sam-api-1 — 먼저 안전하게 중지
+
+
+
+
+ 위험도 ★★
+ docker volume rm
+
+ $ docker volume rm sam_mysql-data
+# MySQL 데이터 볼륨 삭제 = DB 데이터 완전 손실!
+# 관련 컨테이너가 중지된 상태에서만 삭제 가능
+
+ 볼륨 삭제 전 반드시: docker exec -it sam-mysql-1 mysqldump ...로 백업 먼저!
+
+
+
+ 위험도 ★★
+ docker rmi
+
+ $ docker rmi sam-mng
+# SAM MNG 이미지 삭제. 다시 빌드하는 데 시간이 소요됨
+
+
+ + ✅ Docker 사용 시 안전 수칙 +
+-
+
-
+ 1.
+
-v,-f,prune플래그가 보이면 한 번 더 생각하기 +
+ - + 2. + 볼륨 삭제 전 반드시 DB 백업 + +
-
+ 3.
+
docker compose down은 안전,docker compose down -v는 위험 +
+ - + 4. + 모르는 명령어는 팀장에게 확인 후 실행 + +
-
+ 5.
+
docker ps로 현재 상태를 먼저 확인하는 습관 기르기 +
+
+ ![]()
+
+
+@include('components.academy-glossary', ['domain' => 'docker-commands'])
+@endsection
+
+@push('scripts')
+
+@endpush
diff --git a/resources/views/academy/git-tools.blade.php b/resources/views/academy/git-tools.blade.php
new file mode 100644
index 00000000..ae70e94a
--- /dev/null
+++ b/resources/views/academy/git-tools.blade.php
@@ -0,0 +1,968 @@
+@extends('layouts.app')
+
+@section('title', 'Git 관리도구')
+
+@push('styles')
+
+@endpush
+
+@section('content')
+
+
+ {{-- ============================================================ --}}
+ {{-- 히어로 배너 --}}
+ {{-- ============================================================ --}}
+
+
+
+
+@include('components.academy-glossary', ['domain' => 'git-tools'])
+@endsection
diff --git a/resources/views/components/academy-glossary.blade.php b/resources/views/components/academy-glossary.blade.php
index 12b6b355..25225177 100644
--- a/resources/views/components/academy-glossary.blade.php
+++ b/resources/views/components/academy-glossary.blade.php
@@ -1,7 +1,7 @@
{{--
Academy Glossary Tooltip Component
@include('components.academy-glossary', ['domain' => 'fire-shutter'])
- 도메인: fire-shutter | it-planning | server-knowledge | frontend-dev | docker-environment | backend-dev | web-basics | env-management | nginx-encyclopedia
+ 도메인: fire-shutter | it-planning | server-knowledge | frontend-dev | docker-environment | docker-commands | backend-dev | web-basics | env-management | nginx-encyclopedia | git-policy | git-tools
--}}
@push('styles')
@@ -373,6 +373,32 @@
"error_log": "Nginx 오류 및 경고를 기록하는 로그 파일. 설정 오류, 백엔드 연결 실패 등이 기록된다.",
"nginx -t": "Nginx 설정 파일의 문법 오류를 검사하는 명령어. 설정 변경 후 반드시 실행하여 오류를 확인해야 한다."
};
+@elseif($domain === 'docker-commands')
+window.__GLOSSARY_DATA['docker-commands'] = {
+ "docker ps": "실행 중인 컨테이너 목록을 보여주는 명령어. -a를 붙이면 중지된 컨테이너까지 표시한다.",
+ "docker exec": "실행 중인 컨테이너 안에서 명령을 실행하는 명령어. SAM에서 php artisan 명령을 실행할 때 필수로 사용한다.",
+ "docker logs": "컨테이너가 출력한 로그를 확인하는 명령어. -f로 실시간 추적, --tail로 최근 N줄만 볼 수 있다.",
+ "docker start": "중지된 컨테이너를 다시 시작하는 명령어.",
+ "docker stop": "실행 중인 컨테이너를 안전하게 중지하는 명령어. 프로세스에 종료 신호를 보낸다.",
+ "docker restart": "컨테이너를 중지 후 즉시 다시 시작하는 명령어. stop + start를 한 번에 실행하는 것과 같다.",
+ "docker images": "로컬에 저장된 Docker 이미지 목록을 보여주는 명령어. 이미지는 컨테이너를 만들기 위한 설계도이다.",
+ "docker compose up": "docker-compose.yml에 정의된 모든 서비스를 한 번에 생성하고 시작하는 명령어. -d로 백그라운드 실행.",
+ "docker compose down": "Compose로 생성된 모든 컨테이너를 중지하고 제거하는 명령어. -v를 붙이면 볼륨까지 삭제되므로 주의.",
+ "docker compose ps": "Compose로 관리되는 서비스들의 상태를 보여주는 명령어.",
+ "docker compose logs": "Compose 서비스의 로그를 확인하는 명령어. 서비스 이름을 지정하여 특정 서비스만 볼 수 있다.",
+ "docker compose restart": "Compose 서비스를 재시작하는 명령어. 서비스 이름을 지정하면 해당 서비스만 재시작한다.",
+ "-it 플래그": "-i(interactive)와 -t(tty)를 합친 옵션. 키보드 입력이 필요한 대화형 프로그램(bash, tinker 등) 실행 시 필수.",
+ "--tail": "로그 출력을 최근 N줄로 제한하는 옵션. docker logs --tail 50처럼 사용한다.",
+ "-f (follow)": "실시간으로 새 로그를 계속 출력하는 옵션. docker logs -f로 사용하며 Ctrl+C로 종료한다.",
+ "--since": "지정한 시간 이후의 로그만 출력하는 옵션. --since 30m(30분), --since 2h(2시간) 형태로 사용한다.",
+ "-d (detached)": "컨테이너를 백그라운드에서 실행하는 옵션. docker compose up -d로 주로 사용한다.",
+ "볼륨(Volume)": "컨테이너 데이터를 영구적으로 저장하는 Docker 관리 저장소. 컨테이너 삭제 후에도 데이터가 유지된다.",
+ "docker volume ls": "생성된 Docker 볼륨 목록을 보여주는 명령어.",
+ "docker network ls": "생성된 Docker 네트워크 목록을 보여주는 명령어.",
+ "samnet": "SAM 프로젝트의 Docker 브리지 네트워크. 모든 컨테이너가 이 네트워크로 서로 통신한다.",
+ "docker system prune": "사용하지 않는 Docker 리소스(컨테이너, 이미지, 네트워크)를 일괄 삭제하는 명령어. -a 옵션은 위험.",
+ "docker-compose.yml": "Docker Compose의 설정 파일. 서비스, 볼륨, 네트워크 등을 YAML 형식으로 정의한다."
+};
@elseif($domain === 'env-management')
window.__GLOSSARY_DATA['env-management'] = {
".env": "환경 변수를 저장하는 설정 파일. DB 접속 정보, API 키 등 환경마다 달라지는 값을 관리한다.",
@@ -391,6 +417,29 @@
"FCM": "Firebase Cloud Messaging. Google의 무료 푸시 알림 서비스.",
"GCS": "Google Cloud Storage. Google의 클라우드 파일 저장소 서비스."
};
+@elseif($domain === 'git-tools')
+window.__GLOSSARY_DATA['git-tools'] = {
+ "Git Graph": "VS Code 확장 프로그램. 브랜치를 색상별 그래프로 시각화하여 커밋 이력을 한눈에 파악할 수 있다.",
+ "GitLens": "VS Code 확장 프로그램. 코드 줄마다 누가, 언제, 왜 수정했는지 Inline Blame으로 보여준다.",
+ "Rebase": "브랜치의 커밋들을 다른 브랜치 위에 재배치하는 것. 이력이 깔끔한 직선이 되지만 커밋 해시가 변경된다.",
+ "Merge": "두 브랜치의 변경 사항을 하나로 합치는 것. 합류 기록(Merge 커밋)이 남아 이력이 보존된다.",
+ "Interactive Rebase": "커밋 순서 변경, 합치기(Squash), 수정 등을 대화형으로 수행하는 Rebase. git rebase -i로 실행한다.",
+ "Squash": "여러 개의 커밋을 하나로 합치는 것. 불필요한 중간 커밋을 정리할 때 사용한다.",
+ "Cherry-pick": "다른 브랜치의 특정 커밋 하나만 현재 브랜치에 가져오는 것. 전체 Merge 없이 필요한 변경만 적용한다.",
+ "HEAD": "현재 체크아웃된 브랜치의 최신 커밋을 가리키는 포인터. '지금 내가 보고 있는 위치'를 뜻한다.",
+ "Fast-forward": "브랜치 사이에 분기가 없을 때 포인터만 앞으로 이동하는 Merge 방식. Merge 커밋이 생성되지 않는다.",
+ "Blame": "파일의 각 줄을 누가 마지막으로 수정했는지 보여주는 기능. git blame 명령어 또는 GitLens Inline Blame으로 확인한다.",
+ "Source Control": "VS Code에 내장된 Git 관리 패널. Ctrl+Shift+G로 열 수 있으며 Stage, Commit, Push 등을 GUI로 수행한다.",
+ "Diff": "두 버전 간 차이를 줄 단위로 비교하는 것. 추가(초록), 삭제(빨강), 수정(파랑)으로 색상 구분된다.",
+ "Stash": "작업 중인 변경 사항을 임시로 저장하고 Working Directory를 깨끗하게 만드는 기능. 나중에 꺼내어 적용할 수 있다.",
+ "GitKraken": "유료 독립 Git GUI 도구. 직관적 UI와 드래그&드롭 방식의 Merge/Rebase를 지원한다.",
+ "Sourcetree": "Atlassian에서 제공하는 무료 Git GUI 도구. Windows와 macOS를 지원한다.",
+ "Fork": "경량 유료 Git GUI 도구. 빠른 속도와 깔끔한 인터페이스가 특징이다.",
+ "lazygit": "터미널에서 동작하는 Git TUI(Text UI) 도구. SSH 환경에서도 시각적으로 Git을 관리할 수 있다.",
+ "Timeline": "VS Code 파일 탐색기 하단의 패널. 파일의 변경 이력을 시간순으로 보여준다.",
+ "Conflict": "같은 파일의 같은 부분을 두 사람이 다르게 수정했을 때 발생하는 충돌. 수동으로 해결해야 한다.",
+ "3-way Merge": "공통 조상, 현재 브랜치, 대상 브랜치 세 가지를 비교하여 충돌을 해결하는 Merge 방식."
+};
@endif
diff --git a/resources/views/esign/sign/sign.blade.php b/resources/views/esign/sign/sign.blade.php
index d72ba92f..4e3de3af 100644
--- a/resources/views/esign/sign/sign.blade.php
+++ b/resources/views/esign/sign/sign.blade.php
@@ -37,7 +37,7 @@
const [submitting, setSubmitting] = useState(false);
const [error, setError] = useState('');
const [signatureData, setSignatureData] = useState(null);
- const [signMode, setSignMode] = useState('signature'); // 'signature' | 'stamp'
+ const [signMode, setSignMode] = useState('stamp'); // 'signature' | 'stamp'
const [stampPreview, setStampPreview] = useState(null);
const [stampData, setStampData] = useState(null);
const canvasRef = useRef(null);
@@ -282,7 +282,7 @@ className="inline-flex items-center px-4 py-2 bg-blue-600 text-white rounded-lg
문서 열기 / 다운로드
- {(signer?.has_stamp || signer?.role === 'counterpart') && (
+ {(signer?.has_stamp || signer?.role === 'counterpart' || signer?.role === 'creator') && (
+
+
+
+
+
+
+
+ 아카데미
+
+ Git 관리도구
+
+ Git 관리도구
+VS Code 기반 IDE에서 Git 브랜치를 시각적으로 관리하는 도구 추천과 사용법
+
+
+
+ 🔀
+
+
+ {{-- ============================================================ --}}
+ {{-- 좌측 고정 목차 (TOC) --}}
+ {{-- ============================================================ --}}
+
+
+ {{-- ============================================================ --}}
+ {{-- 우측 콘텐츠 --}}
+ {{-- ============================================================ --}}
+
+
+
+ {{-- 모바일 목차 --}}
+
+
+
+ {{-- ============================================================ --}}
+ {{-- 2. Git Graph --}}
+ {{-- ============================================================ --}}
+
+
+
+ {{-- ============================================================ --}}
+ {{-- 3. GitLens --}}
+ {{-- ============================================================ --}}
+
+
+
+ {{-- ============================================================ --}}
+ {{-- 4. VS Code 내장 Source Control --}}
+ {{-- ============================================================ --}}
+
+
+
+ {{-- ============================================================ --}}
+ {{-- 5. 독립 GUI 도구 비교 --}}
+ {{-- ============================================================ --}}
+
+
+
+ {{-- ============================================================ --}}
+ {{-- 6. Rebase vs Merge --}}
+ {{-- ============================================================ --}}
+
+
+
+ {{-- ============================================================ --}}
+ {{-- 7. SAM 프로젝트 실전 워크플로우 --}}
+ {{-- ============================================================ --}}
+
+
+
+ {{-- ============================================================ --}}
+ {{-- 8. 터미널 기반 도구 --}}
+ {{-- ============================================================ --}}
+
+
+
+
+
+
+
+ {{-- ============================================================ --}}
+ {{-- 1. 왜 시각화 도구가 필요한가? --}}
+ {{-- ============================================================ --}}
+
+
+ + + 목차 보기 +
+ +
+
+ + 1 + 왜 Git 시각화 도구가 필요한가? +
+ +
+
+
+ + + CLI만으로는 부족하다 + ?터미널에서 git log --graph를 실행하면 브랜치를 볼 수 있지만, 복잡한 프로젝트에서는 읽기 어렵다. +
+
+
+ 비유: 네비게이션 없이 운전하기
++ 주소만 보고 처음 가는 곳을 찾아가는 것은 가능하지만, 네비게이션이 있으면 훨씬 빠르고 안전하다. + Git 시각화 도구는 코드 저장소의 네비게이션이다. +
+
+
+
+
+ CLI에서 보는 브랜치 그래프
+$ git log --oneline --graph --all
+* 3a7f2c1 (HEAD -> feature/calendar) feat: 달력 기능 추가
+| * b8e4d3a (develop) fix: 로그인 오류 수정
+|/
+* 1c5e9f0 (main) chore: 초기 설정
+| * d4a2b7c (feature/dashboard) feat: 대시보드 추가
+|/
+* 9e3f1a2 docs: README 업데이트
+# 브랜치가 10개 이상이면 이 그래프는 읽기 힘들어진다
+
+
+ 시각화 도구에서 보는 같은 내용
++ 시각화 도구는 색상으로 브랜치를 구분하고, 마우스 클릭만으로 커밋 상세 정보를 볼 수 있다. + Merge와 Rebase 결과도 즉시 확인할 수 있어 실수를 방지한다. +
+
+
+ + + 시각화 도구의 장점 +
+
+
+
+
+ 🎨
+ 색상 구분
+브랜치별 다른 색상으로 한눈에 구분 가능
+
+
+ 🖱
+ 클릭 조작
+명령어 대신 마우스 클릭으로 Merge, Rebase 실행
+
+
+ 🔍
+ Diff 미리보기
+커밋 클릭만으로 변경 사항을 바로 확인
+
+
+ ⚠
+ 실수 방지
+위험한 작업 전 시각적 확인으로 사고 방지
+
+
+ + 2 + Git Graph + 필수 설치 +
+ +
+
+ + + 설치 및 기본 사용 + ?Cursor, AntiGravity 등 VS Code 기반 IDE에서 동일하게 사용 가능하다. +
+ +
+
+
+ 비유: 지하철 노선도
++ Git Graph는 지하철 노선도처럼 브랜치를 보여준다. + 각 노선(브랜치)이 어디서 갈라지고 합쳐지는지 한눈에 파악할 수 있다. +
+
+
+
+
+
+ 설치 방법
+# VS Code / Cursor / AntiGravity 확장 마켓플레이스에서 설치
+# Extension ID:
+mhutchie.git-graph
+
+# 또는 명령 팔레트 (Ctrl+Shift+P)에서:
+ext install mhutchie.git-graph
+
+
+
+ 사용 방법
+
+
+
+ 1
+ Source Control 탭에서 "Git Graph" 아이콘 클릭 (또는 명령 팔레트에서
+ Git Graph: View Git Graph)
+
+ 2
+ 전체 브랜치 그래프가 색상별로 표시됨
+
+
+ 3
+ 커밋을 클릭하면 변경 파일 목록과 Diff를 볼 수 있음
+
+
+ 4
+ 커밋을 우클릭하면 Cherry-pick, Revert, Reset 등 Git 작업 메뉴 표시
+
+
+
+ 주요 기능
+
+
+
+
+
+ | 기능 | +설명 | +사용법 | +
|---|---|---|
| 브랜치 그래프 | 모든 브랜치를 색상별 그래프로 표시 | 자동 표시 |
| 커밋 상세 | 변경 파일, Diff 미리보기 | 커밋 클릭 |
| 브랜치 생성 | 커밋에서 새 브랜치 생성 | 커밋 우클릭 > Create Branch |
| Merge | 브랜치를 현재 브랜치에 병합 | 브랜치 우클릭 > Merge |
| Rebase | 현재 브랜치를 다른 브랜치 위에 재배치 | 브랜치 우클릭 > Rebase |
| Cherry-pick | 특정 커밋만 가져오기 | 커밋 우클릭 > Cherry Pick |
| 태그 | 커밋에 버전 태그 추가 | 커밋 우클릭 > Add Tag |
+
+ + 3 + GitLens + 필수 설치 +
+ +
+
+ + + 핵심 기능 + ?GitLens는 코드 편집기 안에서 "누가, 언제, 왜 이 코드를 바꿨는지"를 바로 보여준다. +
+ +
+
+
+ 비유: CCTV 재생
++ GitLens는 코드의 CCTV와 같다. 어떤 줄이든 클릭하면 + 누가(작성자), 언제(날짜), 왜(커밋 메시지) 수정했는지 바로 확인할 수 있다. +
+
+
+
+
+
+ 설치 방법
+# Extension ID:
+eamodio.gitlens
+
+# 또는 명령 팔레트에서:
+ext install eamodio.gitlens
+
+
+
+
+
+
+
+ 무료
+ Inline Blame
+
+ 코드 줄 끝에 최근 수정자와 커밋 메시지가 흐릿하게 표시된다. 커서를 올리면 상세 정보를 볼 수 있다.
+// 코드 편집기에서 이렇게 보인다:
+function calculateTotal() { // 홍길동, 3일 전 — fix: 합계 계산 오류 수정
+ return items.reduce(...) // 김철수, 1주 전 — feat: 합계 기능 추가
+}
+
+
+
+
+ 무료
+ File History
+
+ 파일의 전체 변경 이력을 시간순으로 보여준다. 특정 시점의 내용으로 쉽게 비교할 수 있다.
+
+
+
+ 유료
+ Commit Graph
+
+ Git Graph와 유사한 시각적 브랜치 그래프. GitLens+ (유료) 기능이지만, Git Graph 확장으로 대체 가능하다.
+
+
+ 무료 vs 유료 비교
+
+
+
+
+
+ | 기능 | +무료 | +유료 (Pro) | +
|---|---|---|
| Inline Blame | ✔ | ✔ |
| File History | ✔ | ✔ |
| Line History | ✔ | ✔ |
| Status Bar Blame | ✔ | ✔ |
| Commit Graph | ✘ | ✔ |
| Visual File History | ✘ | ✔ |
| Worktrees | ✘ | ✔ |
* 무료 기능만으로도 충분히 유용하다. Commit Graph는 Git Graph 확장으로 대체하면 된다.
+
+
+ + 4 + VS Code 내장 Source Control +
+ +
+
+ + + 별도 설치 없이 바로 사용 + ?VS Code, Cursor, AntiGravity 모두 기본 내장되어 있다. 확장 설치 없이 바로 사용 가능하다. +
+ +
+
+
+
+
+ 주요 단축키
+
+
+
+
+
+ | 단축키 | +기능 | +설명 | +
|---|---|---|
| Ctrl+Shift+G | Source Control 열기 | Git 패널 열기 |
| Ctrl+Shift+P | 명령 팔레트 | "Git:" 입력 후 모든 Git 명령 접근 |
| Ctrl+Enter | 커밋 | Source Control에서 메시지 입력 후 커밋 |
| 파일 클릭 | Diff 보기 | 변경된 파일 클릭 시 Diff 뷰어 열림 |
| + 버튼 | Stage (git add) | 파일 옆 + 클릭 시 스테이징 |
| - 버튼 | Unstage | 스테이지된 파일 옆 - 클릭 시 언스테이지 |
+
+ 내장 기능 활용
+
+
+
+ Diff
+ 변경된 파일 클릭 시 좌우 분할 Diff 뷰어가 열린다. 어떤 줄이 추가/삭제/수정되었는지 색상으로 구분된다.
+
+
+ Timeline
+ 파일 탐색기 하단의 Timeline 패널에서 파일의 변경 이력을 시간순으로 볼 수 있다.
+
+
+ Gutter
+ 편집기 좌측 거터에 변경 표시(초록: 추가, 파랑: 수정, 빨강: 삭제)가 나타난다.
+
+
+ Branch
+ 하단 상태바의 브랜치 이름을 클릭하면 브랜치 전환이나 새 브랜치 생성을 할 수 있다.
+
+
+
+ + 5 + 독립 GUI 도구 비교 +
+ +
+
+ + + 전체 도구 비교 테이블 + ?VS Code 확장으로 충분하지만, 더 복잡한 Git 작업이 필요하면 독립 GUI 도구를 고려해 볼 수 있다. +
+ +
+
+
+
+
+
+ | 도구 | +분류 | +가격 | +OS | +Rebase 시각화 | +장점 | +단점 | +추천도 | +
|---|---|---|---|---|---|---|---|
| Git Graph | +VS Code 확장 | +무료 | +All | +✔ | +IDE 통합, 경량 | +대규모 레포에서 느림 | ++ |
| GitLens | +VS Code 확장 | +무료+유료 | +All | +유료 | +Inline Blame, 상세 이력 | +일부 기능 유료 | ++ |
| VS Code SCM | +내장 | +무료 | +All | +✘ | +설치 불필요, 기본 제공 | +그래프 없음 | +★ | +
| GitKraken | +독립 GUI | +유료 | +Win/Mac/Linux | +✔ | +직관적 UI, 드래그&드롭 | +유료, 무거움 | +★ | +
| Sourcetree | +독립 GUI | +무료 | +Win/Mac | +✔ | +무료, Atlassian 제품 | +Linux 미지원, 느림 | +★ | +
| Fork | +독립 GUI | +유료 | +Win/Mac | +✔ | +경량, 빠른 속도 | +Linux 미지원 | +★ | +
| lazygit | +터미널 | +무료 | +All | +✔ | +터미널 전용, 초경량 | +학습 필요 | +★ | +
+
+ + SAM 프로젝트 추천 조합: + Git Graph (브랜치 시각화) + GitLens (코드 이력 추적) + VS Code SCM (기본 Git 작업). + 이 3개면 별도 GUI 도구 없이 모든 Git 작업을 처리할 수 있다. +
+
+
+ + 6 + Rebase vs Merge 시각으로 이해하기 +
+ +
+
+
+ + + Merge: 합류 기록을 남긴다 + ?두 도로가 만나는 교차로를 만드는 것과 같다. "여기서 합쳐졌다"는 기록이 남는다. +
+
+
+
+ Merge 후 그래프 (다이아몬드 형태)
+# git merge feature/calendar
+
+ * ─── M (Merge commit) ← develop
+ |\
+ | * ── C3 (feat: 날짜 선택)
+ | * ── C2 (feat: 달력 UI)
+ |/
+ * ──── C1 (이전 커밋) ← 분기점
+
+ 두 브랜치가 합쳐지는 "다이아몬드" 형태
+ Merge 커밋(M)이 생성되어 합류 기록이 남는다
+ + + Rebase: 직선으로 정리한다 + ?줄을 서다가 맨 앞으로 끼어드는 것과 같다. 이력이 깔끔한 직선이 된다. +
+
+
+ Rebase 후 그래프 (직선 형태)
+# git rebase develop (feature 브랜치에서 실행)
+
+ * ── C3' (feat: 날짜 선택) ← feature/calendar
+ * ── C2' (feat: 달력 UI)
+ * ── C1 (이전 커밋) ← develop
+
+ 브랜치 분기 없이 깔끔한 "직선" 형태
+ 커밋이 develop 위에 재배치(re-base)된다
+
+
+
+ + + 비교 정리 +
+
+
+
+
+
+ | 항목 | +Merge | +Rebase | +
|---|---|---|
| 그래프 모양 | 다이아몬드 (분기+합류) | 직선 |
| 이력 | 합류 기록 보존 | 깔끔한 직선 이력 |
| Merge 커밋 | 생성됨 | 생성 안 됨 |
| 안전성 | 안전 (기존 커밋 변경 없음) | 주의 필요 (커밋 해시 변경) |
| 추천 상황 | 공유 브랜치, PR 머지 | 로컬 feature 브랜치 정리 |
+
+
+
+
+ ⚠ 절대 주의!
+
+ + 이미 Push한 브랜치에서 Rebase를 하면 안 된다! +
++ Rebase는 커밋의 해시값을 변경한다. Push한 브랜치를 Rebase하면 원격 저장소와 이력이 달라져 + 다른 팀원들의 작업이 꼬이게 된다. Force Push가 필요해지며, 이는 매우 위험하다. +
+# ✔ 안전: 아직 Push하지 않은 로컬 브랜치에서 Rebase
+git checkout feature/my-work
+git rebase develop
+
+# ✘ 위험: 이미 Push한 브랜치에서 Rebase
+git checkout feature/shared-work # 이미 push됨!
+git rebase develop # ✘ 하면 안 됨!
+git push --force # ✘ 더 위험!
+
+
+ + 7 + SAM 프로젝트 실전 워크플로우 +
+ +
+
+
+ + + 브랜치 흐름 도식 + ?SAM 프로젝트의 Git 정책은 Git 정책 페이지에서 자세히 확인할 수 있다. +
+
+
+ # SAM 프로젝트 브랜치 전략
+
+feature/* ──push──> develop ──PR merge──> main/master
+ | |
+ v v
+ 개발 서버 운영 서버
+ (자동 배포) (Jenkins CI/CD)
+
+# 저장소 3개 (각각 독립적으로 관리)
+mng/ ── 관리자 웹 (Laravel)
+api/ ── API 서버 (Laravel)
+react/ ── 프론트엔드 (Next.js)
+
+
+ + + 3개 저장소 관리 팁 +
+
+
+
+
+
+
+ Git Graph에서 3개 저장소 전환하기
+
+
+
+ 1
+ VS Code에서 File > Open Folder로 원하는 저장소 폴더를 연다 (
+ mng/, api/, react/)
+
+ 2
+ Git Graph 아이콘을 클릭하면 해당 저장소의 브랜치 그래프가 표시됨
+
+
+ 3
+ 또는 Workspace 기능으로 3개 폴더를 한 번에 열어 전환 가능
+
+
+
+ Step-by-Step: feature 브랜치 작업 흐름
+# 1. develop 브랜치에서 최신 코드 받기
+git checkout develop
+git pull origin develop
+
+# 2. feature 브랜치 생성
+git checkout -b feature/calendar
+
+# 3. 작업 후 커밋 (SAM 커밋 메시지 규칙 준수)
+git add app/Http/Controllers/CalendarController.php
+git commit -m "feat: [calendar] 달력 기능 추가"
+
+# 4. develop에 Push (자동 배포됨)
+git checkout develop
+git merge feature/calendar
+git push origin develop
+
+# 5. feature 브랜치 정리
+git branch -d feature/calendar
+
+
+ + 📖 관련 문서: + SAM 프로젝트의 Git 정책, 커밋 메시지 규칙, 브랜치 전략은 + Git 정책 페이지에서 자세히 확인할 수 있다. +
+
+
+ + 8 + 터미널 기반 도구 +
+ +
+
+ + + lazygit + ?터미널에서 동작하는 Git GUI. SSH 접속 환경에서도 사용할 수 있어 서버 작업 시 유용하다. +
+ +
+
+
+ 비유: 터미널 속 미니 Git 데스크톱
++ lazygit는 터미널 안에서 동작하는 미니 Git 데스크톱 앱이다. + 키보드만으로 Stage, Commit, Push, Branch 전환, Rebase까지 모든 Git 작업을 할 수 있다. +
+
+
+
+
+
+ 설치 방법
+# Ubuntu/WSL
+sudo add-apt-repository ppa:lazygit-team/release
+sudo apt update
+sudo apt install lazygit
+
+# macOS
+brew install lazygit
+
+# Windows (scoop)
+scoop install lazygit
+
+
+
+ 실행 및 기본 사용
+# Git 저장소에서 실행
+$ lazygit
+
+# 화면 구성 (5개 패널)
+┌─ Status ──────┬─ Files ──────────────────────────┐
+│ │ M app/Controller.php │
+│ On branch: │ M resources/views/index.blade │
+│ develop │ A new-file.php │
+│ │ │
+├─ Branches ────┤──────────────────────────────────┤
+│ * develop │ Diff / Commit details │
+│ feature/cal │ │
+│ main │ │
+├─ Commits ─────┤ │
+│ abc1234 feat │ │
+│ def5678 fix │ │
+└───────────────┴──────────────────────────────────┘
+
+
+
+ 핵심 단축키
+
+
+
+
+
+ | 키 | +기능 | +설명 | +
|---|---|---|
| Space | Stage/Unstage | 파일 또는 줄 단위 스테이징 |
| c | Commit | 스테이지된 파일 커밋 |
| P | Push | 원격 저장소에 Push |
| p | Pull | 원격 저장소에서 Pull |
| n | New Branch | 새 브랜치 생성 |
| r | Rebase | 선택한 브랜치에 Rebase |
| M | Merge | 선택한 브랜치 Merge |
| e | Edit | 에디터로 파일 열기 |
| q | Quit | lazygit 종료 |
| ? | Help | 전체 단축키 보기 |
+
+
+ SSH 환경에서의 장점:
+ 개발 서버에 SSH로 접속하면 GUI 도구를 사용할 수 없다.
+ lazygit를 설치해두면 서버에서도 시각적으로 Git을 관리할 수 있다.
+ ssh pro@114.203.209.83 접속 후
+ cd /home/webservice/mng && lazygit로 바로 사용 가능.
+
서명 방법을 선택해 주세요.
diff --git a/resources/views/finance/account-transactions.blade.php b/resources/views/finance/account-transactions.blade.php
index feabc615..f1310e21 100644
--- a/resources/views/finance/account-transactions.blade.php
+++ b/resources/views/finance/account-transactions.blade.php
@@ -16,6 +16,19 @@
@push('scripts')
@include('partials.react-cdn')
+
@verbatim