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/.envna serwerze ma poprawneAPP_KEY,APP_URL, bazę danych, pocztę, cache i kolejkę (WordPress:shared/wp-config.php). - Debug wyłączony:
APP_ENV=productioniAPP_DEBUG=false(WordPress:WP_DEBUGustawione nafalse). - 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');dodeploy.phpalbo uruchomphp artisan horizon:terminate, jeśli używasz Horizon. - Harmonogram: dodaj raz
* * * * * cd /var/www/myapp/current && php artisan schedule:run >> /dev/null 2>&1do crontaba użytkownika wdrożeń (WordPress: prawdziwe zadanie cron wywołującewp-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 productionwraca 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-laraveli ustawiaSENTRY_LARAVEL_DSNw.env. Sprawdź to poleceniemphp artisan sentry:test. - WordPress: wypisuje kroki dla wtyczki WP Sentry i linię do dodania w
wp-config.php. - Inne języki: ustawia
SENTRY_DSNw.env. Dodaj SDK Sentry dla swojego języka, które czytaSENTRY_DSN; upewnij się, że aplikacja wczytuje.env, albo wyeksportuj zmienną. PHP:composer require sentry/sentry; Node.js:npm install @sentry/node, następnieSentry.init({ dsn: process.env.SENTRY_DSN }); Python:pip install sentry-sdk, następniesentry_sdk.init(); Ruby:bundle add sentry-ruby, następnieSentry.init; Go:go get github.com/getsentry/sentry-go, następniesentry.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-laraveli ustawiaSENTRY_LARAVEL_DSNw.env. Sprawdź to poleceniemphp artisan sentry:test. - WordPress: wypisuje kroki dla wtyczki WP Sentry i linię do dodania w
wp-config.php. - Inne projekty: ustawia
SENTRY_DSNw.envdla SDK Sentry Twojego języka.