문서의 모든 페이지를 검색하려면 두 글자 이상 입력하세요.

↑ ↓ 이동 ↵ 열기 esc 닫기

rdev 사용하기

배포 및 오류 추적

Pro와 Team 요금제에서 rdev는 프로젝트를 프로덕션에 배포하고 오류를 확인하는 것을 도와줍니다.

Deployer로 배포

rdev는 PHP의 표준 배포 도구인 Deployer를 사용합니다. Laravel 또는 WordPress 프로젝트에서 다음을 실행하세요.

rdev deploy init myapp

rdev의 템플릿으로 deploy.php를 작성하고 프로젝트의 개발 의존성에 Deployer를 추가합니다. 저장소, 프로덕션 호스트, SSH 사용자, 경로를 채운 다음 vendor/bin/dep deploy production으로 배포하세요. 프로덕션 서버에는 PHP, Composer, 웹 서버가 필요하며, 프로덕션 .env(또는 wp-config.php)는 해당 서버에 있고 여기서 배포되지 않습니다.

에이전트도 이 흐름을 알고 있습니다. 배포 설정을 요청하면 첫 배포 전에 사용자와 함께 deploy.php를 채웁니다.

배포 전 체크리스트

deploy.php의 Laravel 레시피는 Composer 의존성을 설치하고, storage와 공유 .env를 연결하고, php artisan storage:link를 실행하고, 설정·라우트·뷰·이벤트를 캐시하고, php artisan migrate --force를 실행하며, 최근 5개 릴리스를 보관합니다. WordPress 레시피는 wp-config.php와 wp-content/uploads를 공유합니다. 나머지는 직접 챙겨야 합니다. 첫 배포 전과 큰 배포 전에 이 목록을 확인하세요.

  • 운영 설정: 서버의 shared/.env에 올바른 APP_KEY, APP_URL, 데이터베이스, 메일, 캐시, 큐 값이 있습니다(WordPress: shared/wp-config.php).
  • 디버그 끄기: APP_ENV=production, APP_DEBUG=false(WordPress: WP_DEBUG가 false).
  • 백업: 마이그레이션을 실행하는 배포 직전에 운영 데이터베이스를 백업하세요.
  • 마이그레이션: 새 마이그레이션을 한 번 읽어 보세요. 배포 중에 자동으로 실행됩니다.
  • 큐 워커: 새 코드를 불러오도록 배포할 때마다 재시작하세요. deploy.php에 after('deploy:success', 'artisan:queue:restart');를 추가하거나, Horizon을 쓴다면 php artisan horizon:terminate를 실행하세요.
  • 스케줄러: 배포 사용자의 crontab에 * * * * * cd /var/www/myapp/current && php artisan schedule:run >> /dev/null 2>&1를 한 번 추가하세요(WordPress: wp-cron.php를 호출하는 실제 cron 작업).
  • HTTPS: 웹 서버가 current/public(WordPress: current)을 유효한 인증서와 함께 HTTPS로 제공합니다.
  • 오류 추적: 운영 오류를 받도록 rdev errors connect(아래)로 프로젝트를 연결하세요.
  • 스모크 테스트: 배포 후 홈페이지를 열고, 로그인하고, 주요 흐름을 시험하고, 로그에 새 오류가 있는지 확인하세요. 문제가 있으면 vendor/bin/dep rollback production으로 이전 릴리스로 돌아갑니다.

Team 요금제의 배포 승인

Team 요금제에서는 Deployer를 직접 호출하는 대신 rdev deploy run production으로 배포하세요. rdev가 먼저 승인을 요청합니다. 소유자와 관리자가 내 팀 페이지에서 요청을 확인하고 승인 또는 거부하며, 누군가 승인하면 배포가 바로 시작됩니다. 아무도 결정하지 않은 요청은 1시간 후 만료됩니다.

로컬 오류 추적

Pro와 Team 요금제에서는 Sentry SDK와 호환되는 오픈 소스 오류 추적기 GlitchTip을 자신의 서버에서 실행할 수 있습니다. tailnet 안에서만 접근 가능하며 https://rdev-errors.dev.test 에서 열립니다.

설정: root(또는 sudo 사용자)로 서버에 접속해 sudo rdev host errors setup을 실행합니다. 환경 옆에 GlitchTip이 설치됩니다. 자체 소형 PostgreSQL 데이터베이스를 실행하고 환경의 Redis를 사용하며, 메모리 약 0.7 GB(최대 1 GB)와 디스크 약 1 GB가 필요하며, 이벤트를 30일간 보관합니다. 완료되면 관리자 이메일과 비밀번호가 출력됩니다. rdev errors password로 언제든 다시 볼 수 있고, 설정 명령을 다시 실행하면 GlitchTip이 업데이트되고 새 비밀번호가 발급됩니다. --email [email protected]으로 관리자 주소를 정할 수 있습니다. GlitchTip의 알림 메일은 Mail 페이지(https://rdev-mail.dev.test)에 표시됩니다. 가입은 꺼져 있어 로그인할 수 있는 사람은 본인뿐입니다.

프로젝트 연결: rdev errors connect my-shop은 폴더 이름의 GlitchTip 프로젝트를 만들고 그 DSN을 프로젝트에 기록합니다.

  • Laravel: sentry/sentry-laravel을 설치하고 .env에 SENTRY_LARAVEL_DSN을 설정합니다. php artisan sentry:test로 확인하세요.
  • WordPress: WP Sentry 플러그인 단계와 wp-config.php에 추가할 줄을 출력합니다.
  • 다른 언어: .env에 SENTRY_DSN을 설정합니다. SENTRY_DSN을 읽는 해당 언어의 Sentry SDK를 추가하고, 앱이 .env를 불러오는지 확인하거나 변수를 export하세요. PHP: composer require sentry/sentry; Node.js: npm install @sentry/node, 그다음 Sentry.init({ dsn: process.env.SENTRY_DSN }); Python: pip install sentry-sdk, 그다음 sentry_sdk.init(); Ruby: bundle add sentry-ruby, 그다음 Sentry.init; Go: go get github.com/getsentry/sentry-go, 그다음 sentry.Init(sentry.ClientOptions{}); .NET: dotnet add package Sentry; Java: io.sentry:sentry.

오류를 다른 GlitchTip이나 Sentry로 보내려면 그 DSN을 전달합니다: rdev errors connect my-shop --dsn https://<key>@<host>/<id>.

오류 보기: https://rdev-errors.dev.test 를 열거나 노트북 앱의 Errors 버튼을 사용하고, 관리자 이메일과 비밀번호로 로그인합니다. 오류 추적이 설정되기 전에는 설치 방법이 페이지에 표시됩니다. 코딩 에이전트는 MCP 도구 rdev_errors로 프로젝트의 미해결 오류를 읽을 수 있습니다.

오류 추적

프로젝트의 오류를 자체 호스팅 또는 클라우드의 GlitchTip이나 Sentry로 보내세요. 해당 서비스의 프로젝트에서 DSN을 복사한 다음 실행하세요.

rdev errors connect myapp --dsn https://<key>@<host>/<project-id>
  • Laravel: sentry/sentry-laravel을 설치하고 .env에 SENTRY_LARAVEL_DSN을 설정합니다. php artisan sentry:test로 확인하세요.
  • WordPress: WP Sentry 플러그인 설정 단계와 wp-config.php에 추가할 줄을 출력합니다.
  • 기타 프로젝트: 사용하는 언어의 Sentry SDK용으로 .env에 SENTRY_DSN을 설정합니다.