tayo 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 29025c061dcf5f809269fcb2e1af0435a7d24ac28bf21062f4ab065b7b4a17ff
+  data.tar.gz: 6e6f64d2ec7345b8966256a75ead710ce3e479a3e2f05e3624a66936b6c9464f
+SHA512:
+  metadata.gz: d29bbf7c0b505c53d777bda3262ccaeb14f1ba195a2c21e65cac50e5875862edaf8cb323e16c59ca56f4801e23984a6c0680ec7a4f9c4a478bb941f5fd4bea59
+  data.tar.gz: 5b664d65d34f5b9e3b258025750e0ad863660dab0bc472447fad605db92c340af16d4a7e55817ccbd2703bf5563d00c75d620f37c9267b15af77b5be137877ee

data/README.md

@@ -0,0 +1,100 @@
+# Tayo
+
+Rails 애플리케이션을 홈서버에 배포하기 위한 도구입니다.
+
+## 설치
+
+시스템 와이드로 설치:
+
+```bash
+gem install tayo
+```
+
+## 사용법
+
+### 1. `tayo init` - Rails 프로젝트 초기화
+
+Rails 프로젝트를 홈서버 배포를 위해 준비합니다.
+
+```bash
+tayo init
+```
+
+이 명령어는 다음 작업들을 수행합니다:
+
+- **OrbStack 설치 확인**: Docker 컨테이너를 실행하기 위한 OrbStack이 설치되어 있는지 확인합니다
+- **Gemfile 수정**: development 그룹에 tayo gem을 추가합니다
+- **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'` 설정 추가
+- **Git 커밋**: 변경사항을 자동으로 커밋합니다
+- **Docker 캐시 정리**: 디스크 공간 확보를 위해 Docker 캐시를 정리합니다
+
+### 2. `tayo gh` - GitHub 저장소 및 Container Registry 설정
+
+GitHub 저장소를 생성하고 Container Registry를 설정합니다.
+
+```bash
+tayo gh
+```
+
+이 명령어는 다음 작업들을 수행합니다:
+
+- **GitHub CLI 설치 확인**: `gh` 명령어가 설치되어 있는지 확인합니다
+- **GitHub 인증 확인**: 
+  - GitHub에 로그인되어 있는지 확인
+  - 필요한 권한(repo, read:org, write:packages) 확인
+  - 권한이 없으면 브라우저에서 토큰 생성 페이지를 엽니다
+- **Git 저장소 초기화**: 아직 git 저장소가 아니면 초기화합니다
+- **GitHub 원격 저장소 설정**:
+  - 기존 원격 저장소가 있으면 사용
+  - 없으면 새 저장소 생성 (public/private 선택 가능)
+  - 코드를 GitHub에 푸시
+- **GitHub Container Registry 설정**:
+  - Registry URL 생성: `ghcr.io/username/repository-name`
+  - Docker로 자동 로그인 실행
+- **배포 설정 파일 생성**:
+  - `config/deploy.yml` 파일 생성 또는 업데이트
+  - 서버 IP, 도메인, 데이터베이스 등 설정 포함
+- **환경 변수 파일 준비**:
+  - `.env.production` 파일 생성
+  - `.gitignore`에 추가하여 보안 유지
+
+### 3. `tayo cf` - Cloudflare DNS 설정
+
+Cloudflare를 통해 도메인을 홈서버 IP에 연결합니다.
+
+```bash
+tayo cf
+```
+
+이 명령어는 다음 작업들을 수행합니다:
+
+- **설정 파일 확인**: `config/deploy.yml` 파일에서 서버 IP와 도메인 정보를 읽습니다
+- **Cloudflare 인증**:
+  - API 토큰 입력 요청 (처음 실행 시)
+  - 토큰을 안전하게 저장 (macOS Keychain 사용)
+- **도메인 Zone 확인**: 
+  - Cloudflare 계정에서 도메인을 찾습니다
+  - Zone ID를 자동으로 가져옵니다
+- **DNS 레코드 생성/업데이트**:
+  - A 레코드 생성: 도메인을 서버 IP에 연결
+  - 기존 레코드가 있으면 업데이트
+  - Proxied 설정 (Cloudflare CDN 사용)
+- **설정 완료 확인**:
+  - DNS 설정이 완료되면 성공 메시지 표시
+  - 도메인으로 접속 가능함을 안내
+
+각 명령어는 단계별로 진행 상황을 표시하며, 오류가 발생하면 친절한 안내 메시지를 제공합니다.
+
+rails new 로 프로젝트 생성 후 
+bundle exec tayo init
+bundle exec tayo gh
+bundle exec tayo cf
+
+순으로 진행 후
+bin/kamal setup 으로 배포 진행

data/Rakefile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+task default: %i[]

data/exe/tayo

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require "tayo"
+
+Tayo::CLI.start(ARGV)

data/lib/tayo/cli.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "thor"
+require "colorize"
+require_relative "commands/init"
+require_relative "commands/gh"
+require_relative "commands/cf"
+
+module Tayo
+  class CLI < Thor
+    desc "init", "Rails 프로젝트에 Tayo를 설정합니다"
+    def init
+      Commands::Init.new.execute
+    end
+
+    desc "gh", "GitHub 저장소와 컨테이너 레지스트리를 설정합니다"
+    def gh
+      Commands::Gh.new.execute
+    end
+
+    desc "cf", "Cloudflare DNS를 설정하여 홈서버에 도메인을 연결합니다"
+    def cf
+      Commands::Cf.new.execute
+    end
+
+    desc "version", "Tayo 버전을 표시합니다"
+    def version
+      puts "Tayo #{VERSION}"
+    end
+  end
+end

data/lib/tayo/commands/cf.rb

@@ -0,0 +1,390 @@
+# frozen_string_literal: true
+
+require "colorize"
+require "tty-prompt"
+require "net/http"
+require "json"
+require "uri"
+
+module Tayo
+  module Commands
+    class Cf
+      def execute
+        puts "☁️  Cloudflare DNS 설정을 시작합니다...".colorize(:green)
+
+        unless rails_project?
+          puts "❌ Rails 프로젝트가 아닙니다. Rails 프로젝트 루트에서 실행해주세요.".colorize(:red)
+          return
+        end
+
+        # 1. 도메인 입력받기
+        domain_info = get_domain_input
+        
+        # 2. Cloudflare 토큰 생성 페이지 열기 및 권한 안내
+        open_token_creation_page
+        
+        # 3. 토큰 입력받기
+        token = get_cloudflare_token
+        
+        # 4. Cloudflare API로 도메인 목록 조회 및 선택
+        selected_zone = select_cloudflare_zone(token)
+        
+        # 5. 루트 도메인 레코드 확인
+        existing_records = check_existing_records(token, selected_zone, domain_info)
+        
+        # 6. DNS 레코드 추가/수정
+        setup_dns_record(token, selected_zone, domain_info, existing_records)
+        
+        # 7. config/deploy.yml 업데이트
+        update_deploy_config(domain_info)
+
+        puts "\n🎉 Cloudflare DNS 설정이 완료되었습니다!".colorize(:green)
+      end
+
+      private
+
+      def rails_project?
+        File.exist?("Gemfile") && File.exist?("config/application.rb")
+      end
+
+      def get_domain_input
+        prompt = TTY::Prompt.new
+        
+        puts "\n📝 배포할 도메인을 설정합니다.".colorize(:yellow)
+        
+        domain = prompt.ask("배포할 도메인을 입력하세요 (예: myapp.com, api.example.com):") do |q|
+          q.validate(/\A[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}\z/, "올바른 도메인 형식을 입력해주세요 (예: myapp.com)")
+        end
+        
+        # 도메인이 루트인지 서브도메인인지 판단
+        parts = domain.split('.')
+        if parts.length == 2
+          { type: :root, domain: domain, zone: domain }
+        else
+          zone = parts[-2..-1].join('.')
+          { type: :subdomain, domain: domain, zone: zone, subdomain: parts[0..-3].join('.') }
+        end
+      end
+
+      def open_token_creation_page
+        puts "\n🔑 Cloudflare API 토큰이 필요합니다.".colorize(:yellow)
+        puts "토큰 생성 페이지를 엽니다...".colorize(:cyan)
+        
+        # Cloudflare API 토큰 생성 페이지 열기
+        system("open 'https://dash.cloudflare.com/profile/api-tokens'")
+        
+        puts "\n다음 권한으로 토큰을 생성해주세요:".colorize(:yellow)
+        puts ""
+        puts "한국어 화면:".colorize(:gray)
+        puts "• 영역 → DNS → 읽기".colorize(:white)
+        puts "• 영역 → DNS → 편집".colorize(:white)
+        puts "  (영역 리소스는 '모든 영역' 선택)".colorize(:gray)
+        puts ""
+        puts "English:".colorize(:gray)
+        puts "• Zone → DNS → Read".colorize(:white)
+        puts "• Zone → DNS → Edit".colorize(:white)
+        puts "  (Zone Resources: Select 'All zones')".colorize(:gray)
+        puts ""
+      end
+
+      def get_cloudflare_token
+        prompt = TTY::Prompt.new
+        
+        token = prompt.mask("생성된 Cloudflare API 토큰을 붙여넣으세요:")
+        
+        if token.nil? || token.strip.empty?
+          puts "❌ 토큰이 입력되지 않았습니다.".colorize(:red)
+          exit 1
+        end
+        
+        # 토큰 유효성 간단 확인
+        if test_cloudflare_token(token.strip)
+          puts "✅ 토큰이 확인되었습니다.".colorize(:green)
+          return token.strip
+        else
+          puts "❌ 토큰이 올바르지 않거나 권한이 부족합니다.".colorize(:red)
+          exit 1
+        end
+      end
+
+      def test_cloudflare_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)
+        return response.code == '200'
+      rescue
+        return false
+      end
+
+      def select_cloudflare_zone(token)
+        puts "\n🌐 Cloudflare 도메인 목록을 조회합니다...".colorize(:yellow)
+        
+        zones = get_cloudflare_zones(token)
+        
+        if zones.empty?
+          puts "❌ Cloudflare에 등록된 도메인이 없습니다.".colorize(:red)
+          puts "먼저 https://dash.cloudflare.com 에서 도메인을 추가해주세요.".colorize(:cyan)
+          exit 1
+        end
+        
+        prompt = TTY::Prompt.new
+        zone_choices = zones.map { |zone| "#{zone['name']} (#{zone['status']})" }
+        
+        selected = prompt.select("도메인을 선택하세요:", zone_choices)
+        zone_name = selected.split(' ').first
+        
+        selected_zone = zones.find { |zone| zone['name'] == zone_name }
+        puts "✅ 선택된 도메인: #{zone_name}".colorize(:green)
+        
+        return selected_zone
+      end
+
+      def get_cloudflare_zones(token)
+        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)
+          exit 1
+        end
+      rescue => e
+        puts "❌ API 요청 중 오류가 발생했습니다: #{e.message}".colorize(:red)
+        exit 1
+      end
+
+      def check_existing_records(token, zone, domain_info)
+        puts "\n🔍 기존 DNS 레코드를 확인합니다...".colorize(:yellow)
+        
+        zone_id = zone['id']
+        zone_name = zone['name']
+        
+        # 루트 도메인의 A/CNAME 레코드 확인
+        records = get_dns_records(token, zone_id, zone_name, ['A', 'CNAME'])
+        
+        puts "기존 레코드: #{records.length}개 발견".colorize(:gray)
+        
+        return records
+      end
+
+      def get_dns_records(token, 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
+        
+        return records
+      rescue => e
+        puts "❌ DNS 레코드 조회 중 오류: #{e.message}".colorize(:red)
+        return []
+      end
+
+      def setup_dns_record(token, zone, domain_info, existing_records)
+        puts "\n⚙️  DNS 레코드를 설정합니다...".colorize(:yellow)
+        
+        # 홈서버 IP/URL 입력받기
+        prompt = TTY::Prompt.new
+        
+        server_info = prompt.ask("홈서버 IP 또는 도메인을 입력하세요:") do |q|
+          q.validate(/\A.+\z/, "서버 정보를 입력해주세요")
+        end
+        
+        # SSH 사용자 계정 입력받기
+        ssh_user = prompt.ask("SSH 사용자 계정을 입력하세요:", default: "root")
+        
+        # IP인지 도메인인지 판단
+        is_ip = server_info.match?(/\A\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\z/)
+        record_type = is_ip ? 'A' : 'CNAME'
+        
+        zone_id = zone['id']
+        zone_name = zone['name']
+        
+        # 도메인 정보에 따라 레코드 설정
+        final_domain = determine_final_domain(domain_info, zone_name, existing_records)
+        
+        # 대상 도메인의 모든 A/CNAME 레코드 확인
+        all_records = get_dns_records(token, zone_id, final_domain[:name], ['A', 'CNAME'])
+        
+        if all_records.any?
+          existing_record = all_records.first
+          
+          # 동일한 타입이고 같은 값이면 건너뛰기
+          if existing_record['type'] == record_type && existing_record['content'] == server_info
+            puts "✅ DNS 레코드가 이미 올바르게 설정되어 있습니다.".colorize(:green)
+            puts "   #{final_domain[:full_domain]} → #{server_info} (#{record_type} 레코드)".colorize(:gray)
+          else
+            # 타입이 다르거나 값이 다른 경우 삭제 후 재생성
+            puts "⚠️  기존 레코드를 삭제하고 새로 생성합니다.".colorize(:yellow)
+            puts "   기존: #{existing_record['content']} (#{existing_record['type']}) → 새로운: #{server_info} (#{record_type})".colorize(:gray)
+            
+            # 기존 레코드 삭제
+            delete_dns_record(token, zone_id, existing_record['id'])
+            
+            # 새 레코드 생성
+            create_dns_record(token, zone_id, final_domain[:name], record_type, server_info)
+          end
+        else
+          # DNS 레코드 생성
+          create_dns_record(token, zone_id, final_domain[:name], record_type, server_info)
+        end
+        
+        # 최종 도메인 정보 저장
+        @final_domain = final_domain[:full_domain]
+        @server_info = server_info
+        @ssh_user = ssh_user
+      end
+
+      def determine_final_domain(domain_info, zone_name, existing_records)
+        case domain_info[:type]
+        when :root
+          if existing_records.any?
+            puts "⚠️  루트 도메인에 이미 레코드가 있습니다. app.#{zone_name}을 사용합니다.".colorize(:yellow)
+            { name: "app.#{zone_name}", full_domain: "app.#{zone_name}" }
+          else
+            { name: zone_name, full_domain: zone_name }
+          end
+        when :subdomain
+          { name: domain_info[:domain], full_domain: domain_info[:domain] }
+        end
+      end
+
+      def create_dns_record(token, 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
+        }
+        
+        request.body = data.to_json
+        response = http.request(request)
+        
+        if response.code == '200'
+          puts "✅ DNS 레코드가 생성되었습니다.".colorize(:green)
+          puts "   #{name} → #{content} (#{type} 레코드)".colorize(:gray)
+        else
+          puts "❌ DNS 레코드 생성에 실패했습니다: #{response.code}".colorize(:red)
+          puts response.body
+          exit 1
+        end
+      rescue => e
+        puts "❌ DNS 레코드 생성 중 오류: #{e.message}".colorize(:red)
+        exit 1
+      end
+
+      def delete_dns_record(token, zone_id, record_id)
+        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::Delete.new(uri)
+        request['Authorization'] = "Bearer #{token}"
+        request['Content-Type'] = 'application/json'
+        
+        response = http.request(request)
+        
+        if response.code == '200'
+          puts "✅ 기존 DNS 레코드가 삭제되었습니다.".colorize(:green)
+        else
+          puts "❌ DNS 레코드 삭제에 실패했습니다: #{response.code}".colorize(:red)
+          puts response.body
+          exit 1
+        end
+      rescue => e
+        puts "❌ DNS 레코드 삭제 중 오류: #{e.message}".colorize(:red)
+        exit 1
+      end
+
+      def update_deploy_config(domain_info)
+        puts "\n📝 배포 설정을 업데이트합니다...".colorize(:yellow)
+        
+        config_file = "config/deploy.yml"
+        
+        unless File.exist?(config_file)
+          puts "⚠️  config/deploy.yml 파일이 없습니다.".colorize(:yellow)
+          return
+        end
+        
+        content = File.read(config_file)
+        
+        # proxy.host 설정 업데이트
+        if content.include?("proxy:")
+          content.gsub!(/(\s+host:\s+).*$/, "\\1#{@final_domain}")
+        else
+          # proxy 섹션이 없으면 추가
+          proxy_config = "\n# Proxy configuration\nproxy:\n  ssl: true\n  host: #{@final_domain}\n"
+          content += proxy_config
+        end
+        
+        # servers 설정 업데이트
+        if content.match?(/servers:\s*\n\s*web:\s*\n\s*-\s*/)
+          content.gsub!(/(\s*servers:\s*\n\s*web:\s*\n\s*-\s*)[\d.]+/, "\\1#{@server_info}")
+        end
+        
+        # ssh user 설정 업데이트
+        if @ssh_user && @ssh_user != "root"
+          if content.match?(/^ssh:/)
+            # 기존 ssh 섹션 업데이트
+            content.gsub!(/^ssh:\s*\n\s*user:\s*\w+/, "ssh:\n  user: #{@ssh_user}")
+          else
+            # ssh 섹션 추가 (accessories 섹션 앞에 추가)
+            if content.match?(/^# Use accessory services/)
+              content.gsub!(/^# Use accessory services/, "# Use a different ssh user than root\nssh:\n  user: #{@ssh_user}\n\n# Use accessory services")
+            else
+              # 파일 끝에 추가
+              content += "\n# Use a different ssh user than root\nssh:\n  user: #{@ssh_user}\n"
+            end
+          end
+        end
+        
+        File.write(config_file, content)
+        puts "✅ config/deploy.yml이 업데이트되었습니다.".colorize(:green)
+        puts "   proxy.host: #{@final_domain}".colorize(:gray)
+        puts "   servers.web: #{@server_info}".colorize(:gray)
+        puts "   ssh.user: #{@ssh_user}".colorize(:gray) if @ssh_user && @ssh_user != "root"
+      end
+    end
+  end
+end