tayo 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d2af6b108a756159090d922a64ba1e159590c4b0d0a17978c67a14794828f147
-  data.tar.gz: ef4333b8b9094ab0e040c330338cc61eaa4c9f13ea52a6cfc19354d7d3fcd92d
+  metadata.gz: a128e0d938a02268ef73d7c92f956d9f316923eaf1ba7c8827f416a738e2365f
+  data.tar.gz: 6e8c5fa59202380639d5f44dc05ea1723b3df5018a15ae9ec56bb5acf2765f58
 SHA512:
-  metadata.gz: 4ae8aa7b218f16d90aec6ed99d7a0ee96884dd84b033faf6d359811c9d7105ea4ffc224d11093d626a207d6be15dc89b8eed74ae51c3991ff107ae263c851fcc
-  data.tar.gz: d6759cafa8c5c33ea27ab65c736109bb4575d2a9f658adbea2dec7b9a5f0ed827ed3e760a7f21581dca55767e73c7a33a5f0308bf68f90fe2619090a9e1315a4
+  metadata.gz: 4a08ad8b3b192257dbbae0cf19f007210f70e303d7b64727eb388d1381b45ac36d9b3ff9e2441490951c37eb7732da2cd0e4e14fa771fd0b3b58685f36f05490
+  data.tar.gz: 53919de826cf6970b5cd96c9bbeda335c6346df981cd9f46b7790c8f5fb310baf2362b704477ee4a5d5f84d487260ec794ece693fc67bcebbe9d9278acd22943

data/docs/2025-11-29-cf-command-refactor.md

@@ -0,0 +1,53 @@
+# tayo cf 명령어 리팩토링
+
+**날짜**: 2025-11-29
+
+## 변경 사항
+
+### 문제점
+
+1. **흐름이 어색함**: 도메인 입력을 먼저 받고 나서 Cloudflare Zone 목록을 보여주는 순서가 비직관적
+2. **기존 레코드 확인 버그**: `check_existing_records`가 `domain_info`를 파라미터로 받지만 사용하지 않고, 항상 루트 도메인만 조회
+3. **권한 안내 오류**: DNS 편집 권한만 있으면 읽기도 가능한데, 불필요하게 읽기 권한도 안내
+
+### 해결
+
+#### 새로운 흐름
+
+```
+기존:                          변경 후:
+1. 도메인 입력                  1. 토큰 입력
+2. 토큰 입력                    2. Zone 선택
+3. Zone 선택                    3. 기존 레코드 목록 표시
+4. 기존 레코드 확인 (버그)       4. 서비스 도메인 입력
+5. DNS 레코드 설정              5. 홈서버 연결 정보 입력
+6. deploy.yml 업데이트          6. DNS 레코드 생성/수정
+7. Git 커밋                     7. deploy.yml 업데이트
+                                8. Git 커밋
+```
+
+#### 주요 변경 내용
+
+1. **`show_existing_records` 메서드 추가**
+   - Zone 전체의 A/CNAME 레코드를 조회하여 표시
+   - `get_all_dns_records` 헬퍼 메서드로 name 필터 없이 조회
+
+2. **`get_domain_input` 수정**
+   - Zone 정보를 파라미터로 받아서 활용
+   - 서브도메인 사용 여부를 먼저 질문 후 입력받음
+
+3. **`get_server_info` 메서드 분리**
+   - 기존 `setup_dns_record`에서 서버 정보 입력 로직 분리
+   - "홈서버 연결 정보" 단계로 명명
+
+4. **`setup_dns_record` 단순화**
+   - 인스턴스 변수 대신 파라미터로 데이터 전달
+   - `determine_final_domain` 로직 제거 (사용자가 직접 선택)
+
+5. **권한 안내 수정**
+   - "영역 → DNS → 읽기" 제거
+   - "영역 → DNS → 편집"만 안내
+
+## 파일 변경
+
+- `lib/tayo/commands/cf.rb`: 143 insertions, 113 deletions

data/lib/tayo/cli.rb

@@ -6,6 +6,7 @@ require_relative "commands/init"
 require_relative "commands/gh"
 require_relative "commands/cf"
 require_relative "commands/proxy"
+require_relative "commands/sqlite"
 
 module Tayo
   class CLI < Thor
@@ -29,6 +30,11 @@ module Tayo
       Commands::Proxy.new.execute
     end
 
+    desc "sqlite", "SQLite + Solid Cable 최적화 설정을 적용합니다"
+    def sqlite
+      Commands::Sqlite.new.execute
+    end
+
     desc "version", "Tayo 버전을 표시합니다"
     def version
       puts "Tayo #{VERSION}"

data/lib/tayo/commands/sqlite.rb

@@ -0,0 +1,371 @@
+# frozen_string_literal: true
+
+require "colorize"
+require "yaml"
+
+module Tayo
+  module Commands
+    class Sqlite
+      def execute
+        puts "🗄️  SQLite 최적화 설정을 시작합니다...".colorize(:green)
+
+        unless rails_project?
+          puts "❌ Rails 프로젝트가 아닙니다. Rails 프로젝트 루트에서 실행해주세요.".colorize(:red)
+          return
+        end
+
+        unless sqlite_project?
+          puts "❌ SQLite를 사용하는 프로젝트가 아닙니다.".colorize(:red)
+          return
+        end
+
+        unless rails_8_or_higher?
+          puts "❌ Rails 8 이상이 필요합니다. (현재: Rails #{detect_rails_version || '알 수 없음'})".colorize(:red)
+          puts "   Solid Cable은 Rails 8에서 도입되었습니다.".colorize(:yellow)
+          return
+        end
+
+        puts "   Rails #{detect_rails_version} 확인됨".colorize(:gray)
+
+        add_solid_cable_gem
+        run_bundle_install
+        install_solid_cable
+        update_database_yml
+        update_cable_yml
+        create_sqlite_initializer
+        run_migrations
+        create_documentation
+
+        puts ""
+        puts "✅ SQLite + Solid Cable 최적화 설정이 완료되었습니다!".colorize(:green)
+        puts "   📄 설정 배경 문서: docs/solid-cable-sqlite-setup.md".colorize(:gray)
+      end
+
+      private
+
+      def rails_project?
+        File.exist?("Gemfile") && File.exist?("config/application.rb")
+      end
+
+      def sqlite_project?
+        return false unless File.exist?("config/database.yml")
+
+        database_yml = File.read("config/database.yml")
+        database_yml.include?("sqlite3")
+      end
+
+      def rails_8_or_higher?
+        version = detect_rails_version
+        return false unless version
+
+        major_version = version.split(".").first.to_i
+        major_version >= 8
+      end
+
+      def detect_rails_version
+        # Gemfile.lock에서 rails 버전 확인
+        if File.exist?("Gemfile.lock")
+          lockfile = File.read("Gemfile.lock")
+          if match = lockfile.match(/^\s+rails\s+\((\d+\.\d+\.\d+)/)
+            return match[1]
+          end
+        end
+
+        # Gemfile에서 확인 (edge rails 등)
+        if File.exist?("Gemfile")
+          gemfile = File.read("Gemfile")
+          # gem "rails", "~> 8.0" 형식
+          if match = gemfile.match(/gem\s+["']rails["'],\s*["']~>\s*(\d+\.\d+)["']/)
+            return "#{match[1]}.0"
+          end
+          # github: "rails/rails" (edge) - Rails 8+ 가정
+          if gemfile.match?(/gem\s+["']rails["'].*github:\s*["']rails\/rails["']/)
+            return "8.0.0 (edge)"
+          end
+        end
+
+        nil
+      end
+
+      def add_solid_cable_gem
+        puts "📦 Gemfile에 solid_cable을 추가합니다...".colorize(:yellow)
+
+        gemfile = File.read("Gemfile")
+
+        if gemfile.include?("solid_cable")
+          puts "   ℹ️  solid_cable이 이미 존재합니다.".colorize(:yellow)
+          return
+        end
+
+        # solid_cable gem 추가
+        if gemfile.include?("solid_queue")
+          # solid_queue 다음에 추가
+          gemfile.gsub!(/^gem ["']solid_queue["'].*$/) do |match|
+            "#{match}\ngem \"solid_cable\""
+          end
+        elsif gemfile.match?(/^gem ["']rails["']/)
+          # rails gem 다음에 추가
+          gemfile.gsub!(/^gem ["']rails["'].*$/) do |match|
+            "#{match}\n\n# Solid Cable - SQLite 기반 Action Cable 어댑터\ngem \"solid_cable\""
+          end
+        else
+          # 파일 끝에 추가
+          gemfile += "\n# Solid Cable - SQLite 기반 Action Cable 어댑터\ngem \"solid_cable\"\n"
+        end
+
+        File.write("Gemfile", gemfile)
+        puts "   ✅ Gemfile에 solid_cable을 추가했습니다.".colorize(:green)
+      end
+
+      def update_database_yml
+        puts "🗄️  database.yml을 업데이트합니다...".colorize(:yellow)
+
+        database_yml_path = "config/database.yml"
+        content = File.read(database_yml_path)
+
+        # 이미 cable 설정이 있는지 확인
+        if content.include?("cable:") || content.include?("cable_production:")
+          puts "   ℹ️  cable 데이터베이스가 이미 설정되어 있습니다.".colorize(:yellow)
+          return
+        end
+
+        # 기존 database.yml 파싱
+        # production 설정에 cable DB 추가
+        new_content = generate_database_yml(content)
+
+        File.write(database_yml_path, new_content)
+        puts "   ✅ database.yml에 cable 데이터베이스를 추가했습니다.".colorize(:green)
+      end
+
+      def generate_database_yml(original_content)
+        # 기존 내용 유지하면서 cable DB 추가
+        lines = original_content.lines
+
+        # production 섹션 찾기
+        production_index = lines.find_index { |line| line.match?(/^production:/) }
+
+        if production_index
+          # production 섹션 끝 찾기
+          next_section_index = lines[(production_index + 1)..].find_index { |line| line.match?(/^\w+:/) }
+          insert_index = next_section_index ? production_index + 1 + next_section_index : lines.length
+
+          cable_config = <<~YAML
+
+            # Solid Cable용 별도 데이터베이스 (WAL 모드 최적화)
+            cable_production:
+              <<: *default
+              database: storage/db/cable_production.sqlite3
+              migrations_paths: db/cable_migrate
+          YAML
+
+          lines.insert(insert_index, cable_config)
+        end
+
+        # development/test에도 추가
+        dev_index = lines.find_index { |line| line.match?(/^development:/) }
+        if dev_index
+          next_section_index = lines[(dev_index + 1)..].find_index { |line| line.match?(/^\w+:/) }
+          insert_index = next_section_index ? dev_index + 1 + next_section_index : lines.length
+
+          cable_config = <<~YAML
+
+            cable_development:
+              <<: *default
+              database: storage/db/cable_development.sqlite3
+              migrations_paths: db/cable_migrate
+          YAML
+
+          lines.insert(insert_index, cable_config)
+        end
+
+        test_index = lines.find_index { |line| line.match?(/^test:/) }
+        if test_index
+          next_section_index = lines[(test_index + 1)..].find_index { |line| line.match?(/^\w+:/) }
+          insert_index = next_section_index ? test_index + 1 + next_section_index : lines.length
+
+          cable_config = <<~YAML
+
+            cable_test:
+              <<: *default
+              database: storage/db/cable_test.sqlite3
+              migrations_paths: db/cable_migrate
+          YAML
+
+          lines.insert(insert_index, cable_config)
+        end
+
+        lines.join
+      end
+
+      def update_cable_yml
+        puts "📡 cable.yml을 업데이트합니다...".colorize(:yellow)
+
+        cable_yml_path = "config/cable.yml"
+
+        # Development는 async (단일 프로세스), Production은 solid_cable
+        cable_config = <<~YAML
+          # Solid Cable 설정 (SQLite 기반 Action Cable)
+          # Development: async 어댑터 (단일 프로세스, 콘솔 디버깅 용이)
+          # Production: solid_cable (polling_interval: 25ms, Redis 수준 RTT)
+
+          development:
+            adapter: async
+
+          test:
+            adapter: test
+
+          production:
+            adapter: solid_cable
+            connects_to:
+              database:
+                writing: cable
+            polling_interval: 0.025.seconds
+            message_retention: 1.hour
+        YAML
+
+        # 기존 파일 백업
+        if File.exist?(cable_yml_path)
+          backup_path = "#{cable_yml_path}.backup"
+          FileUtils.cp(cable_yml_path, backup_path)
+          puts "   📋 기존 cable.yml을 #{backup_path}로 백업했습니다.".colorize(:gray)
+        end
+
+        File.write(cable_yml_path, cable_config)
+        puts "   ✅ cable.yml을 Solid Cable 설정으로 업데이트했습니다.".colorize(:green)
+      end
+
+      def create_sqlite_initializer
+        puts "⚡ SQLite 최적화 initializer를 생성합니다...".colorize(:yellow)
+
+        initializer_path = "config/initializers/solid_cable_sqlite.rb"
+
+        if File.exist?(initializer_path)
+          puts "   ℹ️  initializer가 이미 존재합니다.".colorize(:yellow)
+          return
+        end
+
+        initializer_content = <<~RUBY
+          # frozen_string_literal: true
+
+          # Solid Cable SQLite 최적화 설정
+          # - WAL 모드: 읽기/쓰기 동시성 향상 (폴링과 브로드캐스트 동시 처리)
+          # - synchronous=NORMAL: 쓰기 성능 향상 (약간의 안정성 트레이드오프)
+
+          Rails.application.config.after_initialize do
+            # Cable 데이터베이스에 WAL 모드 설정
+            if defined?(SolidCable) && ActiveRecord::Base.configurations.configs_for(name: "cable")
+              ActiveRecord::Base.connected_to(role: :writing, shard: :cable) do
+                connection = ActiveRecord::Base.connection
+
+                # WAL 모드 활성화 - 읽기/쓰기 동시 처리 가능
+                connection.execute("PRAGMA journal_mode=WAL")
+
+                # synchronous=NORMAL - fsync 횟수 감소로 쓰기 성능 향상
+                connection.execute("PRAGMA synchronous=NORMAL")
+
+                # 캐시 크기 증가 (기본값의 2배)
+                connection.execute("PRAGMA cache_size=4000")
+
+                Rails.logger.info "[SolidCable] SQLite WAL 모드 최적화 적용됨"
+              rescue ActiveRecord::ConnectionNotEstablished
+                # 마이그레이션 전에는 연결이 없을 수 있음
+                Rails.logger.debug "[SolidCable] Cable 데이터베이스 연결 대기 중..."
+              end
+            end
+          end
+        RUBY
+
+        FileUtils.mkdir_p("config/initializers")
+        File.write(initializer_path, initializer_content)
+        puts "   ✅ config/initializers/solid_cable_sqlite.rb를 생성했습니다.".colorize(:green)
+      end
+
+      def run_bundle_install
+        puts "📦 bundle install을 실행합니다...".colorize(:yellow)
+
+        if system("bundle install")
+          puts "   ✅ bundle install 완료".colorize(:green)
+        else
+          puts "   ❌ bundle install 실패".colorize(:red)
+          puts "   수동으로 bundle install을 실행해주세요.".colorize(:yellow)
+          exit 1
+        end
+      end
+
+      def install_solid_cable
+        puts "🔌 Solid Cable을 설치합니다...".colorize(:yellow)
+
+        # solid_cable:install 태스크가 있는지 확인
+        if system("bin/rails solid_cable:install")
+          puts "   ✅ Solid Cable 설치 완료".colorize(:green)
+        else
+          puts "   ⚠️  solid_cable:install 태스크를 찾을 수 없습니다.".colorize(:yellow)
+          puts "   마이그레이션 파일을 직접 생성합니다...".colorize(:yellow)
+          create_cable_migration
+        end
+      end
+
+      def create_cable_migration
+        # db/cable_migrate 디렉토리 생성
+        FileUtils.mkdir_p("db/cable_migrate")
+
+        timestamp = Time.now.strftime("%Y%m%d%H%M%S")
+        migration_path = "db/cable_migrate/#{timestamp}_create_solid_cable_messages.rb"
+
+        migration_content = <<~RUBY
+          class CreateSolidCableMessages < ActiveRecord::Migration[7.2]
+            def change
+              create_table :solid_cable_messages do |t|
+                t.binary :channel, null: false, limit: 1024
+                t.binary :payload, null: false, limit: 536870912
+                t.datetime :created_at, null: false
+                t.integer :channel_hash, null: false, limit: 8
+
+                t.index :channel
+                t.index :channel_hash
+                t.index :created_at
+              end
+            end
+          end
+        RUBY
+
+        File.write(migration_path, migration_content)
+        puts "   ✅ 마이그레이션 파일 생성: #{migration_path}".colorize(:green)
+      end
+
+      def run_migrations
+        puts "🗄️  데이터베이스를 준비합니다...".colorize(:yellow)
+
+        # storage 디렉토리 생성
+        FileUtils.mkdir_p("storage")
+
+        # db:prepare는 마이그레이션 + 스키마 로드를 모두 처리
+        if system("bin/rails db:prepare")
+          puts "   ✅ 데이터베이스 준비 완료".colorize(:green)
+        else
+          puts "   ⚠️  데이터베이스 준비 실패".colorize(:yellow)
+          puts "   수동으로 bin/rails db:prepare를 실행해주세요.".colorize(:yellow)
+        end
+      end
+
+      def create_documentation
+        puts "📄 설정 문서를 생성합니다...".colorize(:yellow)
+
+        FileUtils.mkdir_p("docs")
+        doc_path = "docs/solid-cable-sqlite-setup.md"
+
+        if File.exist?(doc_path)
+          puts "   ℹ️  문서가 이미 존재합니다.".colorize(:yellow)
+          return
+        end
+
+        # 템플릿 파일에서 문서 내용 읽기
+        template_path = File.expand_path("../../templates/solid-cable-sqlite-setup.md", __FILE__)
+        doc_content = File.read(template_path)
+
+        File.write(doc_path, doc_content)
+        puts "   ✅ docs/solid-cable-sqlite-setup.md를 생성했습니다.".colorize(:green)
+      end
+    end
+  end
+end

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.2.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tayo
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - 이원섭wonsup Lee/Alfonso
@@ -92,6 +92,7 @@ files:
 - CHANGELOG.md
 - README.md
 - Rakefile
+- docs/2025-11-29-cf-command-refactor.md
 - exe/tayo
 - lib/tayo.rb
 - lib/tayo/cli.rb
@@ -99,12 +100,14 @@ files:
 - 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