Wpisz co najmniej dwie litery, aby przeszukać każdą stronę dokumentacji.

↑ ↓ aby nawigować ↵ aby otworzyć esc aby zamknąć

Korzystanie z rdev

Wdrażanie i śledzenie błędów

W planach Pro i Team rdev pomaga wdrożyć projekt na produkcję i widzieć jego błędy.

Wdrażanie z Deployerem

rdev używa Deployera, standardowego narzędzia do wdrożeń w PHP. W projekcie Laravel lub WordPress uruchom:

rdev deploy init myapp

Zapisuje deploy.php z szablonu rdev i dodaje Deployera do zależności deweloperskich projektu. Uzupełnij repozytorium, host produkcyjny, użytkownika SSH i ścieżkę, a potem wdrażaj poleceniem vendor/bin/dep deploy production. Serwer produkcyjny potrzebuje PHP, Composera i serwera WWW; produkcyjny .env (lub wp-config.php) znajduje się na tym serwerze i nigdy nie jest stąd wdrażany.

Twój agent zna ten przepływ: poproś go o skonfigurowanie wdrażania, a uzupełni deploy.php razem z Tobą przed pierwszym wdrożeniem.

Lista kontrolna przed wdrożeniem

Przepis Laravel w deploy.php instaluje zależności Composera, podlinkowuje storage i współdzielony .env, uruchamia php artisan storage:link, cache'uje konfigurację, trasy, widoki i zdarzenia, uruchamia php artisan migrate --force i trzyma 5 ostatnich wydań. Przepis WordPress współdzieli wp-config.php i wp-content/uploads. Reszta należy do Ciebie; przejdź tę listę przed pierwszym wdrożeniem i przed dużymi:

  • Ustawienia produkcyjne: shared/.env na serwerze ma poprawne APP_KEY, APP_URL, bazę danych, pocztę, cache i kolejkę (WordPress: shared/wp-config.php).
  • Debug wyłączony: APP_ENV=production i APP_DEBUG=false (WordPress: WP_DEBUG ustawione na false).
  • Kopie zapasowe: zrób kopię produkcyjnej bazy tuż przed wdrożeniem, które uruchamia migracje.
  • Migracje: przeczytaj nowe migracje; uruchamiają się same podczas wdrożenia.
  • Workery kolejki: restartuj je po każdym wdrożeniu, by wczytały nowy kod. Dodaj after('deploy:success', 'artisan:queue:restart'); do deploy.php albo uruchom php artisan horizon:terminate, jeśli używasz Horizon.
  • Harmonogram: dodaj raz * * * * * cd /var/www/myapp/current && php artisan schedule:run >> /dev/null 2>&1 do crontaba użytkownika wdrożeń (WordPress: prawdziwe zadanie cron wywołujące wp-cron.php).
  • HTTPS: serwer WWW serwuje current/public (WordPress: current) przez HTTPS z ważnym certyfikatem.
  • Śledzenie błędów: podłącz projekt przez rdev errors connect (niżej), żeby błędy z produkcji do Ciebie docierały.
  • Test dymny: po wdrożeniu otwórz stronę główną, zaloguj się, sprawdź główną ścieżkę i poszukaj nowych błędów w logu. Jeśli coś jest nie tak, vendor/bin/dep rollback production wraca do poprzedniego wydania.

Zatwierdzanie wdrożeń w planie Team

W planie Team wdrażaj poleceniem rdev deploy run production, zamiast wywoływać Deployera samodzielnie. rdev najpierw prosi o zatwierdzenie: właściciel i administratorzy widzą prośbę na stronie Twój zespół i zatwierdzają ją lub odrzucają, a wdrożenie rusza, gdy tylko ktoś zatwierdzi. Prośba, o której nikt nie zdecyduje, wygasa po godzinie.

Lokalne śledzenie błędów

W planach Pro i Team możesz uruchomić na własnym serwerze GlitchTip, open source'owe narzędzie do śledzenia błędów zgodne z SDK Sentry. Pozostaje prywatne w Twoim tailnecie pod adresem https://rdev-errors.dev.test.

Konfiguracja: połącz się z serwerem jako root (lub użytkownik sudo) i uruchom sudo rdev host errors setup. To instaluje GlitchTip obok Twojego środowiska. Uruchamia własną małą bazę PostgreSQL, korzysta z Redisa Twojego środowiska, potrzebuje około 0,7 GB pamięci (limit 1 GB) i około 1 GB dysku oraz przechowuje zdarzenia przez 30 dni. Po zakończeniu wypisuje e-mail i hasło administratora. Uruchom rdev errors password w dowolnym momencie, by zobaczyć je ponownie, albo uruchom polecenie konfiguracji jeszcze raz, by zaktualizować GlitchTip i dostać nowe hasło. Opcja --email [email protected] pozwala wybrać adres administratora. E-maile z alertami GlitchTip pojawiają się na Twojej stronie Mail (https://rdev-mail.dev.test). Rejestracja jest wyłączona, więc zalogować się możesz tylko Ty.

Podłączanie projektu: rdev errors connect my-shop tworzy projekt GlitchTip nazwany jak folder i zapisuje jego DSN w projekcie:

  • Laravel: instaluje sentry/sentry-laravel i ustawia SENTRY_LARAVEL_DSN w .env. Sprawdź to poleceniem php artisan sentry:test.
  • WordPress: wypisuje kroki dla wtyczki WP Sentry i linię do dodania w wp-config.php.
  • Inne języki: ustawia SENTRY_DSN w .env. Dodaj SDK Sentry dla swojego języka, które czyta SENTRY_DSN; upewnij się, że aplikacja wczytuje .env, albo wyeksportuj zmienną. PHP: composer require sentry/sentry; Node.js: npm install @sentry/node, następnie Sentry.init({ dsn: process.env.SENTRY_DSN }); Python: pip install sentry-sdk, następnie sentry_sdk.init(); Ruby: bundle add sentry-ruby, następnie Sentry.init; Go: go get github.com/getsentry/sentry-go, następnie sentry.Init(sentry.ClientOptions{}); .NET: dotnet add package Sentry; Java: io.sentry:sentry.

Aby wysyłać błędy do innego GlitchTip lub do Sentry, podaj jego DSN: rdev errors connect my-shop --dsn https://<key>@<host>/<id>.

Przeglądanie błędów: otwórz https://rdev-errors.dev.test lub użyj przycisku Errors w aplikacji na laptopa i zaloguj się e-mailem i hasłem administratora. Dopóki śledzenie błędów nie jest skonfigurowane, strona pokazuje, jak je zainstalować. Agenci kodujący mogą czytać nierozwiązane błędy projektu przez narzędzie MCP rdev_errors.

Śledzenie błędów

Wysyłaj błędy projektu do GlitchTip lub Sentry, własnego hostingu lub ich chmury. Skopiuj tam DSN swojego projektu, a potem uruchom:

rdev errors connect myapp --dsn https://<key>@<host>/<project-id>
  • Laravel: instaluje sentry/sentry-laravel i ustawia SENTRY_LARAVEL_DSN w .env. Sprawdź to poleceniem php artisan sentry:test.
  • WordPress: wypisuje kroki dla wtyczki WP Sentry i linię do dodania w wp-config.php.
  • Inne projekty: ustawia SENTRY_DSN w .env dla SDK Sentry Twojego języka.