Generator skryptów Laravel Envoy — automatyzacja wdrożeń

Generuj skrypty Envoy.blade.php dla Laravel Envoy: deployment, migracje, rollback, restart kolejek. Pobierz gotowy plik.

Bezpieczne (SSL)

Przetwarzanie Lokalne

100% Darmowe

Przejdź do narzędzia

Instrukcja

1

Wprowadź dane
Wpisz treść, wklej tekst lub załaduj plik z dysku.
2

Kliknij przycisk
Narzędzie natychmiast przetworzy Twoje dane w przeglądarce.
3

Pobierz wynik
Skopiuj gotowy tekst lub zapisz plik na urządzeniu.

                                                function runTool() {

                                                  return "Wynik gotowy w 0.1s";

                                                }

Ustawienia

Projekt

Serwery

Uruchom na

Repozytorium

Ścieżka wdrożenia

Branch (gałąź)

Liczba przechowywanych wydań

Ścieżka do PHP

Ścieżka do Composera

Tryb konserwacji Opcja narzędzia

Migracje Opcja narzędzia

Budowanie zasobów (npm) Opcja narzędzia

Restart kolejki Opcja narzędzia

Własny fragment kodu

Wynik

Ustaw parametry i kliknij „Przetwórz”, aby zobaczyć wynik.

Oceń to narzędzie:

Powiązane narzędzia

Inne narzędzia, które mogą Ci się przydać

Laravel Envoy – prosta automatyzacja zadań wdrożeniowych (SSH deployment)

Proces wdrażania aplikacji (deployment) na serwer produkcyjny bywa skomplikowany i podatny na błędy, jeśli wykonywany jest ręcznie. Logowanie przez SSH, pobieranie najnowszej wersji kodu z repozytorium Git, instalacja zależności za pomocą Composera, uruchamianie migracji baz danych czy czyszczenie pamięci podręcznej – to powtarzalne kroki, które można zautomatyzować. Laravel Envoy to darmowe, minimalistyczne narzędzie uruchamiane z poziomu wiersza poleceń, które definiuje zadania wykonywane na zdalnych serwerach przy użyciu składni wzorowanej na silniku szablonów Blade. Dzięki temu pisanie skryptów wdrożeniowych staje się proste i czytelne nawet dla początkujących programistów.

Nasz generator skryptów Laravel Envoy online to darmowe narzędzie deweloperskie ułatwiające konfigurację automatycznego deploymentu. Wypełniając krótki formularz (podając adresy serwerów SSH, ścieżkę do projektu, dane repozytorium Git oraz wybierając opcje restartu kolejek czy kompilacji assetów), otrzymasz w pełni poprawny plik konfiguracyjny Envoy.blade.php gotowy do wdrożenia w projekcie.

Przykładowy szkielet pliku Envoy.blade.php i rola dyrektyw

Plik Envoy.blade.php łączy w sobie dyrektywy Blade z instrukcjami powłoki Bash. Poniższa tabela przedstawia kluczowe elementy konfiguracji:

Nazwa dyrektywy	Przeznaczenie i rola	Przykładowy zapis w kodzie	Miejsce w strukturze pliku
`@servers`	Definiuje serwery (wraz z użytkownikami SSH i portami), na których będą wykonywane zadania.	`@servers(['web' => '[email protected]'])`	Na samym początku pliku.
`@task`	Definiuje konkretne zadanie (zestaw komend Bash) do wykonania na określonym serwerze.	`@task('deploy', ['on' => 'web'])`	Główna sekcja pliku konfiguracyjnego.
`@story`	Pozwala na grupowanie kilku zadań w jedno większe makro (wykonywane sekwencyjnie).	`@story('deploy-all') deploy, restart-queue @endstory`	Dowolne miejsce w pliku (zalecane pod sekcją servers).
`@setup`	Sekcja kodu PHP służąca do definiowania zmiennych lokalnych (np. ścieżek, nazw gałęzi Git).	`@setup $branch = 'main'; @endsetup`	Przed sekcją definicji zadań task.

Kluczowe kroki standardowego procesu wdrożenia (Deployment Flow)

Bezpieczny proces wdrożenia na produkcji powinien składać się z kilku sekwencyjnych kroków:

Klonowanie/pobieranie repozytorium: Pobranie najnowszych zmian z Git za pomocą komendy git pull lub klonowanie do nowego folderu w przypadku tzw. Zero-Downtime Deployment.
Instalacja zależności Composer: Pobranie i aktualizacja bibliotek PHP bez instalowania zależności deweloperskich (composer install --no-dev --optimize-autoloader).
Migracje bazy danych: Aktualizacja schematu bazy danych w sposób bezpieczny (php artisan migrate --force).
Optymalizacja cache: Wyczyszczenie i przebudowanie cache konfiguracji, tras oraz widoków (php artisan optimize).
Restart usług i kolejek: Restart procesów pracujących w tle (np. php artisan queue:restart) oraz przeładowanie PHP-FPM, aby nowe pliki PHP zostały wczytane do pamięci OPcache.

Jak uruchomić i skonfigurować Laravel Envoy? Instrukcja

Aby zacząć korzystać z automatycznych wdrożeń za pomocą Envoy, wykonaj następujące kroki:

Zainstaluj Envoy globalnie: Uruchom w terminalu komendę composer global require laravel/envoy. Upewnij się, że katalog binarny Composera znajduje się w zmiennej środowiskowej PATH Twojego systemu.
Wygeneruj plik konfiguracyjny: Użyj naszego generatora online, aby stworzyć spersonalizowany kod Envoy.blade.php i zapisz go w głównym katalogu swojego projektu Laravel.
Skonfiguruj klucze SSH: Upewnij się, że Twój komputer lokalny ma dostęp bezhasłowy (klucze SSH) do serwera produkcyjnego. Bez tego Envoy nie będzie mógł się zalogować i wykonać zadań.
Uruchom wdrożenie: Wpisz w terminalu polecenie envoy run deploy. Narzędzie połączy się z serwerem i wyświetli statusy wykonywania poszczególnych komend w czasie rzeczywistym.

Często zadawane pytania (FAQ)

Czy Laravel Envoy wymaga Laravela do działania?

Nie. Choć Envoy powstał z myślą o ekosystemie Laravela i jest rozwijany przez jego twórców, jest samodzielnym narzędziem napisanym w PHP. Możesz go używać do automatyzacji wdrożeń dowolnych aplikacji – napisanych w czystym PHP, WordPressa, a nawet projektów w technologii Node.js czy Python.

Co to jest Zero-Downtime Deployment i czy Envoy go obsługuje?

To metoda wdrażania, która gwarantuje, że strona działa nieprzerwanie podczas wgrywania nowego kodu. Polega na klonowaniu nowej wersji projektu do osobnego folderu, przygotowaniu zależności, a na koniec błyskawicznej zmianie dowiązania symbolicznego (symlink) wskazującego na nowy folder. Envoy doskonale nadaje się do napisania takiego skryptu.

Jak wysłać powiadomienie na Slacka lub Discorda po udanym wdrożeniu?

Laravel Envoy posiada wbudowane dyrektywy @slack oraz @discord, które pozwalają na wysyłanie wiadomości na webhooka po zakończeniu zadania (np. @slack('webhook_url', '#channel', 'Wdrożenie udane!')).

Czy Envoy jest bezpieczny?

Tak. Envoy komunikuje się z serwerami wyłącznie za pośrednictwem protokołu SSH, który jest standardem bezpieczeństwa w administracji systemami. Narzędzie nie przechowuje haseł – autoryzacja odbywa się na podstawie bezpiecznych kluczy prywatnych/publicznych SSH użytkownika.

Czy mogę uruchamiać zadania lokalnie za pomocą Envoy?

Tak. Aby uruchomić zadanie na swoim lokalnym komputerze (bez logowania przez SSH), jako serwer w dyrektywie @servers podaj wartość localhost (np. @servers(['local' => '127.0.0.1'])).