tayo 0.1.12 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2a5fae5e5027e6af704d0de853a7402c0011dbe9e4e9638bd8e05553a60d9f13
-  data.tar.gz: 7b0446e1db678ae717d49176d415095820622e19b3f75812182090a9ff32aa89
+  metadata.gz: b5fa91902d5a43f2bd8259bdd3949017b629c6f228cf68600f9b4fd238a13299
+  data.tar.gz: 66e296458abdfca8cebf3e919be4f36f06fcbb1238cefd2e441d96cc193fcdda
 SHA512:
-  metadata.gz: 5b9c66d762054c1df3a9a40d1a0f98e29eb2428aa43dd048ad678ce85461f2f81f1486bd92e2e67b7b7c1d34ccfe2818a59bea4bfd02972a2948f9ee55f4597f
-  data.tar.gz: 6df1da4eeaa3def9471469d100ed1dd8575129eb1ac959a2915d45a20da0f3e7f97f3d893d7ac46965207827ff0febd73a55732ac3538a0dd9156ccd30e4d7bf
+  metadata.gz: 876880104575214b91231682c947c40a73ea233dd558644bb5d34d75e90e5b4a6046185e9e650c9a945d5d9e3d4fd77cc29a4fefbabb83d1c1f82683d2b5ce9b
+  data.tar.gz: 2955f65d56f1395e823b159cc64fd2285dfe523dae26b21ea2aa896b350c499029d9fe84908fdbfad0ffbc50734e309386f1ef2613517f087c7499205d06dc36

data/CHANGELOG.md

@@ -1,57 +1,67 @@
-# 변경 기록 (Changelog)
-
-## [0.1.12] - 2025-01-20
-
-### 🚀 새로운 기능
-- **CLAUDE.md 문서 지원**: Claude AI 도우미를 위한 프로젝트별 지침 파일 지원
-- **Cloudflare DNS 설정 대폭 개선**:
-  - Cloudflare Zone 목록에서 도메인을 직접 선택하는 방식으로 변경
-  - 루트 도메인(@)과 서브도메인 선택 UI 개선
-  - 기존 DNS 레코드 확인 및 덮어쓰기 시 사용자 확인 프롬프트 추가
-  - Cloudflare API 토큰을 `~/.tayo` 파일에 안전하게 저장 및 재사용
-- **자동 Git 커밋**: `tayo gh`와 `tayo cf` 명령어 실행 후 자동으로 변경사항 커밋
-- **버전 표시**: 명령어 실행 시 Tayo 버전 표시
-
-### 🛠️ 개선사항
-- **Init 워크플로우 간소화**:
-  - Gemfile 수정 제거로 더 깔끔한 초기화 프로세스
-  - Docker 캐시 정리 기능 추가
-  - bootsnap 자동 처리 제거 (안정성 문제로 인해)
-- **GitHub Container Registry 설정**:
-  - 조직(Organization) 계정 지원 추가
-  - ghcr.io URL 중복 제거 버그 수정
-  - Docker 로그인 자동화
-
-### 🐛 버그 수정
-- Dockerfile bootsnap 프리컴파일 이슈 수정
-- DNS 레코드 생성 시 프록시 설정 누락 문제 해결
-
-## [0.1.11] - 2025-01-19
-
-### 🛠️ 개선사항
-- Bootsnap 처리를 DockerfileModifier 클래스로 리팩토링
-- 더 안정적인 bootsnap 라인 제거 로직 구현
-- 테스트 커버리지 강화
-
-## [0.1.10] - 2025-01-18
-
-### 🚀 새로운 기능
-- Dockerfile에서 bootsnap 관련 설정 자동 제거/비활성화
-
-### 🐛 버그 수정
-- Dockerfile bootsnap 프리컴파일 관련 다양한 엣지 케이스 처리
-
-## [0.1.9] - 2025-01-17
-
-### 🏗️ 기타 변경사항
-- 홈페이지 URL을 TeamMilestone 조직으로 업데이트
-- 저장소 이전에 따른 메타데이터 업데이트
-
-## [0.1.0] - 2025-01-15
-
-### 🎉 최초 릴리스
-- `tayo init`: Rails 프로젝트 초기 설정 (Docker, Welcome 페이지)
-- `tayo gh`: GitHub 저장소 및 Container Registry 설정
-- `tayo cf`: Cloudflare DNS 설정
-- OrbStack 자동 감지 및 실행
-- 한국어 UI 지원
+# 변경 이력
+
+모든 주요 변경사항은 이 파일에 기록됩니다.
+
+이 프로젝트는 [Semantic Versioning](https://semver.org/lang/ko/)을 따릅니다.
+
+## [0.2.0] - 2024-12-28
+
+### 추가됨
+- 새로운 `tayo proxy` 명령어 - 고급 프록시 서버 설정 기능
+- Traefik 기반 리버스 프록시와 자동 SSL 관리
+- Docker Compose를 통한 편리한 컨테이너 관리
+- 멀티 도메인 라우팅 지원
+- Let's Encrypt를 통한 자동 SSL 인증서 발급 및 갱신
+- 기본 랜딩 페이지를 위한 Welcome 서비스
+- 도메인 관리를 위한 Cloudflare DNS 통합
+- Docker 컨테이너와 호스트 서비스 모두 지원 (host.docker.internal)
+- Traefik 대시보드 제공 (http://localhost:8080, admin/admin)
+- 공유기 포트포워딩 설정 지원 (80/443 또는 커스텀 포트)
+
+### 개선됨
+- Welcome 서비스의 호스트 포트 감지 개선
+- Rails 개발 서버 우선순위 처리
+- 프록시 아키텍처 문서 개선
+
+## [0.1.11] - 2024-12-27
+
+### 개선됨
+- Gemfile 수정 제거 및 초기화 워크플로우 개선
+- bootsnap 처리를 DockerfileModifier 클래스로 리팩토링
+
+## [0.1.10] - 2024-12-26
+
+### 추가됨
+- 버전 표시 및 디버깅 기능
+- bootsnap 제거에 대한 포괄적인 테스트
+- 엣지 케이스 수정
+
+### 개선됨
+- reject 패턴 매칭으로 bootsnap 제거 단순화
+
+## [0.1.0] - 2024-12-25
+
+### 추가됨
+- `tayo init` - Rails 프로젝트 초기화 명령어
+  - OrbStack 설치 확인
+  - Linux 플랫폼 추가 (x86_64-linux, aarch64-linux)
+  - Dockerfile 자동 생성
+  - Welcome 페이지 생성
+  - 자동 Git 커밋
+  - Docker 캐시 정리
+
+- `tayo gh` - GitHub 저장소 및 Container Registry 설정
+  - GitHub CLI 인증 확인
+  - 저장소 생성/연결
+  - GitHub Container Registry 설정
+  - deploy.yml 설정 파일 생성
+
+- `tayo cf` - Cloudflare DNS 설정
+  - API 토큰 관리 (macOS Keychain 사용)
+  - 도메인 Zone 자동 감지
+  - DNS A 레코드 생성/업데이트
+
+[0.2.0]: https://github.com/TeamMilestone/tayo/compare/v0.1.11...v0.2.0
+[0.1.11]: https://github.com/TeamMilestone/tayo/compare/v0.1.10...v0.1.11
+[0.1.10]: https://github.com/TeamMilestone/tayo/compare/v0.1.0...v0.1.10
+[0.1.0]: https://github.com/TeamMilestone/tayo/releases/tag/v0.1.0

data/README.md

@@ -1,6 +1,6 @@
 # Tayo
 
-Rails 애플리케이션을 홈서버에 배포하기 위한 도구입니다. GitHub Container Registry와 Cloudflare를 활용하여 간편한 배포 워크플로우를 제공합니다.
+Rails 애플리케이션을 홈서버에 배포하기 위한 도구입니다.
 
 ## 설치
 
@@ -23,13 +23,15 @@ tayo init
 이 명령어는 다음 작업들을 수행합니다:
 
 - **OrbStack 설치 확인**: Docker 컨테이너를 실행하기 위한 OrbStack이 설치되어 있는지 확인합니다
+- **Bundle 설치**: 의존성을 설치합니다
+- **Linux 플랫폼 추가**: `x86_64-linux`와 `aarch64-linux` 플랫폼을 Gemfile.lock에 추가합니다
 - **Dockerfile 생성**: Rails 7 기본 Dockerfile이 없으면 생성합니다
 - **Welcome 페이지 생성**: 
   - `app/controllers/welcome_controller.rb` 컨트롤러 생성
   - `app/views/welcome/index.html.erb` 뷰 파일 생성 (애니메이션이 있는 예쁜 랜딩 페이지)
   - `config/routes.rb`에 `root 'welcome#index'` 설정 추가
-- **Docker 캐시 정리**: 디스크 공간 확보를 위해 Docker 캐시를 정리합니다
 - **Git 커밋**: 변경사항을 자동으로 커밋합니다
+- **Docker 캐시 정리**: 디스크 공간 확보를 위해 Docker 캐시를 정리합니다
 
 ### 2. `tayo gh` - GitHub 저장소 및 Container Registry 설정
 
@@ -50,7 +52,6 @@ tayo gh
 - **GitHub 원격 저장소 설정**:
   - 기존 원격 저장소가 있으면 사용
   - 없으면 새 저장소 생성 (public/private 선택 가능)
-  - 개인 계정 및 조직(Organization) 계정 모두 지원
   - 코드를 GitHub에 푸시
 - **GitHub Container Registry 설정**:
   - Registry URL 생성: `ghcr.io/username/repository-name`
@@ -61,7 +62,6 @@ tayo gh
 - **환경 변수 파일 준비**:
   - `.env.production` 파일 생성
   - `.gitignore`에 추가하여 보안 유지
-- **Git 커밋**: 설정 변경사항을 자동으로 커밋합니다
 
 ### 3. `tayo cf` - Cloudflare DNS 설정
 
@@ -73,57 +73,95 @@ tayo cf
 
 이 명령어는 다음 작업들을 수행합니다:
 
+- **설정 파일 확인**: `config/deploy.yml` 파일에서 서버 IP와 도메인 정보를 읽습니다
 - **Cloudflare 인증**:
   - API 토큰 입력 요청 (처음 실행 시)
-  - 토큰을 `~/.tayo` 파일에 안전하게 저장하여 재사용
-  - 필요한 권한: Zone:Read, DNS:Edit
-- **도메인 설정**: 
-  - Cloudflare 계정의 Zone 목록에서 도메인 선택
-  - 루트 도메인(@) 또는 서브도메인 설정 지원
-  - 대화형 UI로 쉽게 설정 가능
+  - 토큰을 안전하게 저장 (macOS Keychain 사용)
+- **도메인 Zone 확인**:
+  - Cloudflare 계정에서 도메인을 찾습니다
+  - Zone ID를 자동으로 가져옵니다
 - **DNS 레코드 생성/업데이트**:
-  - A 레코드 생성: IP 주소로 연결
-  - CNAME 레코드 생성: 도메인으로 연결
-  - 기존 레코드가 있으면 사용자 확인 후 업데이트
+  - A 레코드 생성: 도메인을 서버 IP에 연결
+  - 기존 레코드가 있으면 업데이트
   - Proxied 설정 (Cloudflare CDN 사용)
-- **배포 설정 업데이트**:
-  - `config/deploy.yml` 파일의 proxy.host 자동 업데이트
-  - 서버 정보 및 SSH 사용자 설정
-- **Git 커밋**: DNS 설정 변경사항을 자동으로 커밋합니다
+- **설정 완료 확인**:
+  - DNS 설정이 완료되면 성공 메시지 표시
+  - 도메인으로 접속 가능함을 안내
 
-## 전체 워크플로우
+### 4. `tayo proxy` - 프록시 서버 설정 (고급)
+
+Traefik을 Docker로 설정하여 도메인 라우팅과 SSL을 자동 관리합니다.
 
 ```bash
-# 1. 새 Rails 프로젝트 생성
-rails new myapp
-cd myapp
+tayo proxy
+```
 
-# 2. Tayo로 배포 준비
-tayo init    # Rails 프로젝트 초기화
-tayo gh      # GitHub 저장소 및 Container Registry 설정
-tayo cf      # Cloudflare DNS 설정
+이 명령어는 다음 작업들을 수행합니다:
 
-# 3. Kamal로 배포
+- **Cloudflare API 설정**:
+  - API 토큰 확인 및 검증 (`~/.tayo/cloudflare_token`)
+  - 토큰이 없거나 만료되면 재입력 안내
+  - 도메인 목록에서 멀티 선택 가능
+
+- **네트워크 구성**:
+  - 공인 IP 자동 감지 (`curl ifconfig.me`)
+  - 내부 네트워크 IP 감지
+  - 포트포워딩 방식 선택:
+    - 직접 연결: 80, 443 (기본)
+    - 커스텀 포트: 8080, 8443 등 (80/443이 사용 중일 때)
+
+- **Docker 컨테이너 관리**:
+  - **Traefik**: 리버스 프록시 서버로 80, 443 포트에서 실행
+    - 도메인별 자동 라우팅 (File Provider 사용)
+    - Let's Encrypt SSL 인증서 자동 발급 및 갱신 (ACME)
+    - 호스트에서 실행 중인 서비스 연결 지원 (host.docker.internal)
+    - Docker Compose로 관리
+  - **Welcome Service**: 3000 포트에 기본 페이지 제공 (Rails 등 호스트 서비스가 없을 때만)
+  - **대시보드**: http://localhost:8080 에서 Traefik 상태 및 라우팅 규칙 확인 (admin/admin)
+
+- **DNS 자동 설정**:
+  - 선택한 도메인에 공인 IP를 A 레코드로 등록
+  - 기존 레코드는 자동 업데이트
+
+- **프록시 아키텍처**:
+  ```
+  [인터넷] → [공유기] → [Traefik:80,443] → [호스트 앱:3000]
+                              ↓
+                    [Docker Compose 관리]
+                    - traefik.yml (정적 설정)
+                    - dynamic.yml (동적 라우팅)
+                    - acme.json (SSL 인증서)
+  ```
+
+**사용 시나리오:**
+- 홈서버에서 여러 도메인 호스팅
+- 자동 SSL 인증서 관리 (Let's Encrypt ACME)
+- 공유기 포트포워딩과 함께 사용
+- 기존 웹서버와 병행 운영 (커스텀 포트 사용)
+- Docker 컨테이너 및 호스트 서비스 모두 지원
+
+자세한 아키텍처 문서: [doc/proxy-architecture.md](doc/proxy-architecture.md)
+
+각 명령어는 단계별로 진행 상황을 표시하며, 오류가 발생하면 친절한 안내 메시지를 제공합니다.
+
+## 사용 예시
+
+### Rails 앱 배포 (기본)
+```bash
+rails new myapp
+cd myapp
+bundle exec tayo init
+bundle exec tayo gh
+bundle exec tayo cf
 bin/kamal setup
 ```
 
-## 주요 기능
-
-- **🚀 원스톱 배포 설정**: 3개의 명령어로 배포 준비 완료
-- **🐳 Docker 기반**: OrbStack과 GitHub Container Registry 활용
-- **🌐 Cloudflare 통합**: 자동 DNS 설정 및 CDN 지원
-- **🔒 보안**: 토큰과 환경 변수를 안전하게 관리
-- **🎯 한국어 UI**: 모든 메시지가 한국어로 제공
-- **🛡️ 오류 처리**: 각 단계별 검증과 친절한 오류 메시지
-
-## 요구사항
-
-- Ruby 3.1.0 이상
-- Rails 7.0 이상
-- macOS (OrbStack 사용)
-- GitHub 계정
-- Cloudflare 계정
-
-## 라이선스
+### 프록시 서버 설정 (고급)
+```bash
+# 홈서버에 프록시 환경 구성
+tayo proxy
 
-MIT License
+# 여러 도메인을 한 서버에서 호스팅
+# SSL 인증서 자동 관리
+# 공유기 포트포워딩과 함께 사용
+```

data/lib/tayo/cli.rb

@@ -5,6 +5,7 @@ require "colorize"
 require_relative "commands/init"
 require_relative "commands/gh"
 require_relative "commands/cf"
+require_relative "commands/proxy"
 
 module Tayo
   class CLI < Thor
@@ -23,6 +24,11 @@ module Tayo
       Commands::Cf.new.execute
     end
 
+    desc "proxy", "Traefik을 설정하여 도메인 라우팅과 SSL을 관리합니다"
+    def proxy
+      Commands::Proxy.new.execute
+    end
+
     desc "version", "Tayo 버전을 표시합니다"
     def version
       puts "Tayo #{VERSION}"