tayo 0.2.2 → 0.3.0

data/lib/tayo/templates/solid-cable-sqlite-setup.md

@@ -0,0 +1,90 @@
+# Solid Cable + SQLite 최적화 설정
+
+> 이 문서는 `tayo sqlite` 명령어로 자동 생성되었습니다.
+
+## 개요
+
+이 프로젝트는 Redis 없이 SQLite만으로 Action Cable 실시간 기능을 구현합니다.
+Rails 8에서 도입된 Solid Cable을 사용하여 WebSocket 브로드캐스트를 처리합니다.
+
+## 왜 Solid Cable인가?
+
+### Redis vs Solid Cable
+
+| 항목 | Redis | Solid Cable |
+|------|-------|-------------|
+| 의존성 | Redis 서버 필요 | DB만 사용 |
+| 방식 | Pub/Sub (푸시) | Polling (폴링) |
+| 지연시간 | ~1ms | ~25ms (설정값) |
+| 운영 복잡도 | Redis 관리 필요 | 단순 |
+
+### 체감 성능
+
+- **25ms 폴링**: 사용자가 지연을 체감하기 어려움 (200ms 이하는 "즉각적"으로 느껴짐)
+- **RTT 비교**: Redis ~80ms vs Solid Cable ~85ms (전체 왕복 시간 기준, 거의 동일)
+
+## 적용된 설정
+
+### 1. 데이터베이스 분리 (database.yml)
+
+```yaml
+production:
+  primary:
+    database: storage/production.sqlite3
+  cable:
+    database: storage/production_cable.sqlite3  # 별도 DB
+```
+
+**이유**: Cable 폴링이 메인 DB의 쓰기 작업과 락 경합하지 않도록 분리
+
+### 2. Cable 설정 (cable.yml)
+
+```yaml
+development:
+  adapter: async  # 단일 프로세스, 콘솔 디버깅 용이
+
+production:
+  adapter: solid_cable
+  polling_interval: 0.025.seconds  # 25ms
+  message_retention: 1.hour
+```
+
+**폴링 간격 선택 기준**:
+- 100ms: 기본값, 대부분 충분
+- 25ms: 채팅/실시간 앱에 적합
+- 10ms: Redis 수준, 부하 증가
+
+### 3. SQLite WAL 모드 최적화 (initializer)
+
+```ruby
+# config/initializers/solid_cable_sqlite.rb
+PRAGMA journal_mode=WAL      # 읽기/쓰기 동시 처리
+PRAGMA synchronous=NORMAL    # 쓰기 성능 향상
+PRAGMA cache_size=4000       # 캐시 증가
+```
+
+**WAL 모드 장점**:
+- 읽기(폴링)와 쓰기(브로드캐스트)가 동시에 가능
+- Solid Cable의 폴링 패턴에 최적화
+
+## 성능 가이드
+
+### 적정 사용 범위
+
+| 동시 접속 | 메시지/초 | 예상 지연 |
+|----------|----------|----------|
+| ~50명 | ~10 | 거의 없음 |
+| ~100명 | ~20 | ~50ms |
+| ~500명 | ~100 | 검토 필요 |
+
+### 스케일 아웃이 필요한 경우
+
+- 초당 200개 이상 메시지
+- 1000명 이상 동시 접속
+- → Redis 또는 PostgreSQL NOTIFY 고려
+
+## 참고 자료
+
+- [Solid Cable GitHub](https://github.com/rails/solid_cable)
+- [SQLite WAL Mode](https://sqlite.org/wal.html)
+- [Rails 8 Release Notes](https://rubyonrails.org/2024/11/7/rails-8-no-paas-required)

data/lib/tayo/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tayo
-  VERSION = "0.2.2"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tayo
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - 이원섭wonsup Lee/Alfonso
@@ -92,22 +92,17 @@ files:
 - CHANGELOG.md
 - README.md
 - Rakefile
+- docs/2025-11-29-cf-command-refactor.md
 - exe/tayo
 - lib/tayo.rb
 - lib/tayo/cli.rb
 - lib/tayo/commands/cf.rb
 - lib/tayo/commands/gh.rb
 - lib/tayo/commands/init.rb
-- lib/tayo/commands/proxy.rb
+- lib/tayo/commands/sqlite.rb
 - lib/tayo/dockerfile_modifier.rb
-- lib/tayo/proxy/cloudflare_client.rb
-- lib/tayo/proxy/docker_manager.rb
-- lib/tayo/proxy/network_config.rb
-- lib/tayo/proxy/traefik_config.rb
-- lib/tayo/proxy/welcome_service.rb
+- lib/tayo/templates/solid-cable-sqlite-setup.md
 - lib/tayo/version.rb
-- lib/templates/welcome/Dockerfile
-- lib/templates/welcome/index.html
 - pkg/homebody-0.1.0.gem
 - repomix-output.xml
 - sig/tayo.rbs
@@ -131,7 +126,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.1
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Rails deployment tool for home servers
 test_files: []

data/lib/tayo/commands/proxy.rb

@@ -1,97 +0,0 @@
-# frozen_string_literal: true
-
-require "colorize"
-require "tty-prompt"
-require_relative "../proxy/cloudflare_client"
-require_relative "../proxy/docker_manager"
-require_relative "../proxy/network_config"
-require_relative "../proxy/traefik_config"
-require_relative "../proxy/welcome_service"
-
-module Tayo
-  module Commands
-    class Proxy
-      def execute
-        puts "🚀 Kamal Proxy와 Caddy 설정을 시작합니다...".colorize(:green)
-        puts ""
-
-        # 1. Cloudflare 설정
-        cloudflare = Tayo::Proxy::CloudflareClient.new
-        cloudflare.ensure_token
-
-        # 2. 네트워크 설정
-        network = Tayo::Proxy::NetworkConfig.new
-        network.detect_ips
-        network.configure_ports
-
-        # 3. Docker 확인
-        docker = Tayo::Proxy::DockerManager.new
-        docker.check_containers
-
-        # 4. 도메인 선택
-        selected_domains = cloudflare.select_domains
-
-        if selected_domains.empty?
-          puts "❌ 도메인이 선택되지 않았습니다. 종료합니다.".colorize(:red)
-          return
-        end
-
-        # 5. DNS 설정
-        puts "\n📝 DNS 레코드를 설정합니다...".colorize(:yellow)
-        cloudflare.setup_dns_records(selected_domains, network.public_ip)
-
-        # 6. Welcome 서비스 확인
-        welcome = Tayo::Proxy::WelcomeService.new
-        welcome.ensure_running
-
-        # 7. Traefik 설정
-        traefik = Tayo::Proxy::TraefikConfig.new
-        traefik.setup(selected_domains)
-
-        # 8. 최종 안내
-        show_summary(selected_domains, network)
-
-      rescue => e
-        puts "❌ 오류가 발생했습니다: #{e.message}".colorize(:red)
-        puts e.backtrace.join("\n") if ENV["DEBUG"]
-        exit 1
-      end
-
-      private
-
-      def show_summary(domains, network)
-        puts "\n" + "="*60
-        puts "✅ Proxy 설정이 완료되었습니다!".colorize(:green)
-        puts "="*60
-
-        puts "\n📋 설정 요약:".colorize(:yellow)
-        puts "━"*40
-        puts "공인 IP: #{network.public_ip}".colorize(:white)
-        puts "내부 IP: #{network.internal_ip}".colorize(:white)
-        puts "Traefik: 80, 443 포트 사용 중".colorize(:white)
-        puts "대시보드: http://localhost:8080".colorize(:white)
-        puts "━"*40
-
-        puts "\n🌐 활성화된 도메인:".colorize(:yellow)
-        domains.each do |domain|
-          if network.use_custom_ports?
-            puts "• #{domain}".colorize(:cyan)
-            puts "  HTTP:  http://#{domain}:#{network.external_http}".colorize(:gray)
-            puts "  HTTPS: https://#{domain}:#{network.external_https}".colorize(:gray)
-          else
-            puts "• #{domain}".colorize(:cyan)
-            puts "  HTTP:  http://#{domain}".colorize(:gray)
-            puts "  HTTPS: https://#{domain}".colorize(:gray)
-          end
-        end
-
-        if network.use_custom_ports?
-          puts "\n💡 공유기 포트포워딩을 설정하세요!".colorize(:yellow)
-          network.show_port_forwarding_guide
-        end
-
-        puts "\n🎉 모든 설정이 완료되었습니다!".colorize(:green)
-      end
-    end
-  end
-end

data/lib/tayo/proxy/cloudflare_client.rb

@@ -1,323 +0,0 @@
-# frozen_string_literal: true
-
-require "colorize"
-require "tty-prompt"
-require "net/http"
-require "json"
-require "uri"
-require "fileutils"
-
-module Tayo
-  module Proxy
-    class CloudflareClient
-      TOKEN_FILE = File.expand_path("~/.tayo/cloudflare_token")
-
-      def initialize
-        @prompt = TTY::Prompt.new
-      end
-
-      def ensure_token
-        @token = load_saved_token
-
-        if @token
-          puts "🔑 저장된 Cloudflare 토큰을 확인합니다...".colorize(:yellow)
-
-          if test_token(@token)
-            puts "✅ 저장된 Cloudflare 토큰이 유효합니다.".colorize(:green)
-          else
-            puts "⚠️  저장된 토큰이 만료되었거나 유효하지 않습니다.".colorize(:yellow)
-            puts "새 토큰을 입력해주세요.".colorize(:cyan)
-            open_token_creation_page
-            @token = get_cloudflare_token
-            save_token(@token)
-          end
-        else
-          puts "\n🔑 Cloudflare API 토큰이 필요합니다.".colorize(:yellow)
-          open_token_creation_page
-          @token = get_cloudflare_token
-          save_token(@token)
-        end
-      end
-
-      def select_domains
-        puts "\n🌐 Cloudflare 도메인 목록을 조회합니다...".colorize(:yellow)
-
-        zones = get_cloudflare_zones
-
-        if zones.empty?
-          puts "❌ Cloudflare에 등록된 도메인이 없습니다.".colorize(:red)
-          puts "먼저 https://dash.cloudflare.com 에서 도메인을 추가해주세요.".colorize(:cyan)
-          return []
-        end
-
-        zone_choices = zones.map { |zone| "#{zone['name']} (#{zone['status']})" }
-
-        selected_zones = @prompt.multi_select(
-          "Caddy로 라우팅할 도메인을 선택하세요 (Space로 선택, Enter로 완료):",
-          zone_choices,
-          per_page: 10,
-          min: 1
-        )
-
-        # 선택된 항목이 없으면 빈 배열 반환
-        return [] if selected_zones.nil? || selected_zones.empty?
-
-        puts "DEBUG: selected_zones = #{selected_zones.inspect}" if ENV["DEBUG"]
-
-        selected_domains = selected_zones.map do |selection|
-          zone_name = selection.split(' ').first
-          zone = zones.find { |z| z['name'] == zone_name }
-
-          # 서브도메인 추가 여부 확인
-          if @prompt.yes?("#{zone_name}에 서브도메인을 추가하시겠습니까?")
-            subdomain = @prompt.ask("서브도메인을 입력하세요 (예: app, api):")
-            if subdomain && !subdomain.empty?
-              {
-                domain: "#{subdomain}.#{zone_name}",
-                zone_id: zone['id'],
-                zone_name: zone_name
-              }
-            else
-              {
-                domain: zone_name,
-                zone_id: zone['id'],
-                zone_name: zone_name
-              }
-            end
-          else
-            {
-              domain: zone_name,
-              zone_id: zone['id'],
-              zone_name: zone_name
-            }
-          end
-        end
-
-        puts "\n✅ 선택된 도메인:".colorize(:green)
-        selected_domains.each do |d|
-          puts "   • #{d[:domain]}".colorize(:cyan)
-        end
-
-        puts "DEBUG: returning selected_domains = #{selected_domains.inspect}" if ENV["DEBUG"]
-
-        selected_domains
-      end
-
-      def setup_dns_records(domains, public_ip)
-        domains.each do |domain_info|
-          domain = domain_info[:domain]
-          zone_id = domain_info[:zone_id]
-
-          puts "\n⚙️  #{domain}의 DNS 레코드를 설정합니다...".colorize(:yellow)
-
-          # 기존 A 레코드 확인
-          existing_records = get_dns_records(zone_id, domain, ['A'])
-
-          if existing_records.any?
-            existing_record = existing_records.first
-            if existing_record['content'] == public_ip
-              puts "✅ #{domain} → #{public_ip} (이미 설정됨)".colorize(:green)
-            else
-              puts "⚠️  기존 레코드를 업데이트합니다.".colorize(:yellow)
-              update_dns_record(zone_id, existing_record['id'], public_ip)
-            end
-          else
-            # 새 A 레코드 생성
-            create_dns_record(zone_id, domain, 'A', public_ip)
-          end
-        end
-      end
-
-      private
-
-      def load_saved_token
-        return nil unless File.exist?(TOKEN_FILE)
-        File.read(TOKEN_FILE).strip
-      rescue
-        nil
-      end
-
-      def save_token(token)
-        dir = File.dirname(TOKEN_FILE)
-
-        # 디렉토리가 파일로 존재하는 경우 삭제
-        if File.exist?(dir) && !File.directory?(dir)
-          FileUtils.rm(dir)
-        end
-
-        # 디렉토리가 없을 때만 생성
-        FileUtils.mkdir_p(dir) unless File.directory?(dir)
-
-        File.write(TOKEN_FILE, token)
-        File.chmod(0600, TOKEN_FILE)
-        puts "✅ API 토큰이 저장되었습니다.".colorize(:green)
-      end
-
-      def open_token_creation_page
-        puts "토큰 생성 페이지를 엽니다...".colorize(:cyan)
-        system("open 'https://dash.cloudflare.com/profile/api-tokens' 2>/dev/null || xdg-open 'https://dash.cloudflare.com/profile/api-tokens' 2>/dev/null")
-
-        puts "\n다음 권한으로 토큰을 생성해주세요:".colorize(:yellow)
-        puts ""
-        puts "한국어 화면:".colorize(:gray)
-        puts "• 영역 → 영역 → 읽기".colorize(:white)
-        puts "• 영역 → DNS → 편집".colorize(:white)
-        puts "  (영역 리소스는 '모든 영역' 선택)".colorize(:gray)
-        puts ""
-        puts "English:".colorize(:gray)
-        puts "• Zone → Zone → Read".colorize(:white)
-        puts "• Zone → DNS → Edit".colorize(:white)
-        puts "  (Zone Resources: Select 'All zones')".colorize(:gray)
-        puts ""
-      end
-
-      def get_cloudflare_token
-        token = @prompt.mask("생성된 Cloudflare API 토큰을 붙여넣으세요:")
-
-        if token.nil? || token.strip.empty?
-          puts "❌ 토큰이 입력되지 않았습니다.".colorize(:red)
-          exit 1
-        end
-
-        if test_token(token.strip)
-          puts "✅ 토큰이 확인되었습니다.".colorize(:green)
-          return token.strip
-        else
-          puts "❌ 토큰이 올바르지 않거나 권한이 부족합니다.".colorize(:red)
-          exit 1
-        end
-      end
-
-      def test_token(token)
-        uri = URI('https://api.cloudflare.com/client/v4/user/tokens/verify')
-        http = Net::HTTP.new(uri.host, uri.port)
-        http.use_ssl = true
-
-        request = Net::HTTP::Get.new(uri)
-        request['Authorization'] = "Bearer #{token}"
-        request['Content-Type'] = 'application/json'
-
-        response = http.request(request)
-
-        if response.code == '200'
-          data = JSON.parse(response.body)
-          return data['success'] == true
-        else
-          return false
-        end
-      rescue => e
-        puts "⚠️  토큰 검증 중 오류: #{e.message}".colorize(:yellow) if ENV["DEBUG"]
-        false
-      end
-
-      def get_cloudflare_zones
-        uri = URI('https://api.cloudflare.com/client/v4/zones')
-        http = Net::HTTP.new(uri.host, uri.port)
-        http.use_ssl = true
-
-        request = Net::HTTP::Get.new(uri)
-        request['Authorization'] = "Bearer #{@token}"
-        request['Content-Type'] = 'application/json'
-
-        response = http.request(request)
-
-        if response.code == '200'
-          data = JSON.parse(response.body)
-          return data['result'] || []
-        else
-          puts "❌ 도메인 목록 조회에 실패했습니다: #{response.code}".colorize(:red)
-          []
-        end
-      rescue => e
-        puts "❌ API 요청 중 오류가 발생했습니다: #{e.message}".colorize(:red)
-        []
-      end
-
-      def get_dns_records(zone_id, name, types)
-        records = []
-
-        types.each do |type|
-          uri = URI("https://api.cloudflare.com/client/v4/zones/#{zone_id}/dns_records")
-          uri.query = URI.encode_www_form({
-            type: type,
-            name: name
-          })
-
-          http = Net::HTTP.new(uri.host, uri.port)
-          http.use_ssl = true
-
-          request = Net::HTTP::Get.new(uri)
-          request['Authorization'] = "Bearer #{@token}"
-          request['Content-Type'] = 'application/json'
-
-          response = http.request(request)
-
-          if response.code == '200'
-            data = JSON.parse(response.body)
-            records.concat(data['result'] || [])
-          end
-        end
-
-        records
-      rescue => e
-        puts "⚠️  DNS 레코드 조회 중 오류: #{e.message}".colorize(:yellow)
-        []
-      end
-
-      def create_dns_record(zone_id, name, type, content)
-        uri = URI("https://api.cloudflare.com/client/v4/zones/#{zone_id}/dns_records")
-        http = Net::HTTP.new(uri.host, uri.port)
-        http.use_ssl = true
-
-        request = Net::HTTP::Post.new(uri)
-        request['Authorization'] = "Bearer #{@token}"
-        request['Content-Type'] = 'application/json'
-
-        data = {
-          type: type,
-          name: name,
-          content: content,
-          ttl: 300,
-          proxied: false
-        }
-
-        request.body = data.to_json
-        response = http.request(request)
-
-        if response.code == '200'
-          puts "✅ #{name} → #{content} (A 레코드 생성됨)".colorize(:green)
-        else
-          puts "❌ DNS 레코드 생성 실패: #{response.code}".colorize(:red)
-          puts response.body if ENV["DEBUG"]
-        end
-      rescue => e
-        puts "❌ DNS 레코드 생성 중 오류: #{e.message}".colorize(:red)
-      end
-
-      def update_dns_record(zone_id, record_id, new_content)
-        uri = URI("https://api.cloudflare.com/client/v4/zones/#{zone_id}/dns_records/#{record_id}")
-        http = Net::HTTP.new(uri.host, uri.port)
-        http.use_ssl = true
-
-        request = Net::HTTP::Patch.new(uri)
-        request['Authorization'] = "Bearer #{@token}"
-        request['Content-Type'] = 'application/json'
-
-        data = {
-          content: new_content
-        }
-
-        request.body = data.to_json
-        response = http.request(request)
-
-        if response.code == '200'
-          puts "✅ DNS 레코드가 업데이트되었습니다.".colorize(:green)
-        else
-          puts "❌ DNS 레코드 업데이트 실패: #{response.code}".colorize(:red)
-        end
-      rescue => e
-        puts "❌ DNS 레코드 업데이트 중 오류: #{e.message}".colorize(:red)
-      end
-    end
-  end
-end