De pagina Commando's van een site voert één commando eenmalig uit in de live map van de site, zoals php artisan migrate --force, php artisan cache:clear of composer dump-autoload. Je hebt geen terminal of SSH nodig: je typt het commando, klikt op Uitvoeren en leest de output als het klaar is.
Elk commando dat je uitvoert blijft in het Verloop staan met zijn output en status, zodat je ziet wat er is uitgevoerd, door wie, en het opnieuw kunt uitvoeren.
Een commando uitvoeren
- Open de site en klik in de zijbalk op Commando's.
- Typ onder Een commando uitvoeren het commando. Bij Laravel- en Statamic-sites begint het veld met
php artisan. - Klik op Uitvoeren.
Het commando draait als achtergrondtaak, en het item gaat open in het Verloop eronder, met de output zodra die binnenkomt. Je kunt de pagina verlaten: het commando blijft op de server draaien, en je kunt het ook volgen op de pagina activiteit.
Waar en hoe draait een commando?
- In de live map: de release die nu live is,
current/in de map van de site, of de monorepo-rootmap daarin, bijvoorbeeld/home/vimonto/shop.example.com/current. De pagina toont het precieze pad onder het veld. Een site die nog nooit gedeployd is heeft nog geen live map; het commando mislukt dan met een melding daarover. - Als de gebruiker van de site: de systeemgebruiker van de server, of de eigen gebruiker van een geïsoleerde site. De beschrijving van de pagina noemt de gebruiker.
- Met de PHP-versie van de site: bij PHP-sites gebruiken
phpencomposerde PHP-versie die in de Instellingen van de site staat (de pagina toont welke), dusphp artisangebruikt dezelfde PHP als de site zelf. - Eén regel: een commando is één regel van maximaal 2.000 tekens. Wil je er meer uitvoeren, koppel ze dan met
&&, bijvoorbeeldphp artisan down && php artisan migrate --force && php artisan up.
Een commando dat met een fout eindigt, markeert zijn item als mislukt, met de fout boven de output.
Commando's zijn niet interactief: er kan niets getypt worden terwijl ze draaien. Een commando dat een vraag stelt, zoals php artisan migrate in productie zonder --force, blijft daar hangen. Voeg de optie toe die de vraag beantwoordt, of gebruik de terminal voor alles wat interactief is.
De output lezen en een commando opnieuw uitvoeren
Het Verloop toont de laatste 50 commando's van de site, nieuwste eerst, met wie ze uitvoerde, wanneer, en hun status (In de wachtrij, bezig, klaar of mislukt). Oudere commando's en hun output worden verwijderd.
- Klik op een commando om de output te tonen of te verbergen.
- Klik op Opnieuw gebruiken om het commando terug in het veld te zetten. Controleer of wijzig het en klik op Uitvoeren.
Wie kan commando's uitvoeren?
Elk lid kan het verloop en de output zien. Een commando uitvoeren en Opnieuw gebruiken vereisen het recht om sites te beheren (eigenaar, beheerder, manager en developer), en de site en haar server moeten actief zijn. Zie leden en rollen.
Elk uitgevoerd commando wordt vastgelegd in het auditlog, met wie het uitvoerde.
Een site op een load balancer heeft geen pagina Commando's: ze heeft geen eigen code. Voer commando's uit op de sites van haar app-servers.
Veelgestelde vragen
Hoe voer ik migraties uit na een deploy?
Zet voor elke deploy $VIMONTO_PHP artisan migrate --force in het deployscript. Voor een eenmalige migratie voer je hier php artisan migrate --force uit.
Kan ik een commando als root uitvoeren?
Nee. Commando's draaien als de gebruiker van de site. Voor werk als root gebruik je de terminal of een recept.
Kan ik iets uitvoeren dat blijft draaien, zoals een queue worker?
Niet hier: een commando hoort klaar te komen. Processen die blijven draaien horen onder wachtrijen en scheduler, waar ze draaiende gehouden en herstart worden.