Skip to content

πŸš€ Laravel Cloud - Deploy & Cache Issues ​

πŸ” PROBLEMA IDENTIFICATO ​

Locale vs Stage differenti:

  • Locale (saasykit-tenancy.test): Mostra menu aggiornato βœ…
  • Stage (blade.laravel.cloud): Mostra menu vecchio ❌

Causa: Codice pushato su GitHub ma Laravel Cloud non ha deployato o cache non pulita.


βœ… SOLUZIONI ​

1. Triggera Deploy Manuale ​

Se Laravel Cloud ha auto-deploy disabilitato:

  1. Vai su Laravel Cloud Dashboard
  2. Trova il tuo progetto "blade"
  3. Tab "Deployments"
  4. Click "Deploy Now" / "Trigger Deployment"
  5. Aspetta completion (~2-5 min)

2. Pulisci Cache dopo Deploy ​

Laravel Cloud NON pulisce automaticamente tutte le cache dopo deploy.

SSH nel container:

bash
# Dalla dashboard Laravel Cloud, apri "SSH" terminal
# Oppure usa CLI:
# laravel-cloud ssh blade

# Una volta dentro:
php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear
php artisan filament:cache-components

Oppure via API/Webhook (se configurato):

bash
curl -X POST https://blade.laravel.cloud/api/clear-cache \
  -H "Authorization: Bearer YOUR_TOKEN"

3. Verifica Git Branch ​

Assicurati che Laravel Cloud stia deployando dal branch corretto:

Dashboard Laravel Cloud:

  • Settings β†’ Deployment
  • Verifica "Branch" = main (o il tuo branch)
  • Verifica "Auto Deploy" = ON
  • Verifica ultimo deploy commit = 720e066

4. Force Clear Browser Cache ​

A volte Γ¨ cache browser:

Chrome:

Cmd/Ctrl + Shift + R (hard refresh)

Safari:

Cmd + Option + E (empty cache)
Cmd + R (refresh)

Firefox:

Cmd/Ctrl + Shift + Delete β†’ Clear cache

5. Verifica Asset Compilation ​

Se hai modificato file Filament/Livewire:

Laravel Cloud auto-compila assets, ma verifica:

bash
# SSH nel container
npm run build
php artisan optimize:clear

πŸ” DEBUG: Verifica Versione Deploy ​

Aggiungi temporary check in locale:

  1. Aggiungi in CalendarSettings.php:
php
// Top del file
dd('Version: 720e066 - Latest');
  1. Push commit
  2. Triggera deploy
  3. Apri stage β†’ Dovrebbe mostrare dd() con versione
  4. Se mostra versione vecchia β†’ Deploy non completato

πŸ“‹ CHECKLIST DEPLOY LARAVEL CLOUD ​

  • [ ] Commit pushato su GitHub (git push origin main)
  • [ ] Deploy triggerato (auto o manuale)
  • [ ] Deploy completato (check dashboard)
  • [ ] Cache pulita post-deploy
  • [ ] Browser cache cleared
  • [ ] Verifica commit hash in produzione

🎯 QUICK FIX ​

Approccio piΓΉ veloce:

  1. Vai su Laravel Cloud Dashboard
  2. Click "Settings" β†’ "Environment"
  3. Aggiungi variabile temporanea (es. CLEAR_CACHE=true)
  4. Save (triggera auto-redeploy)
  5. Aspetta deploy completion
  6. Apri stage β†’ Dovrebbe essere aggiornato

πŸ”„ WORKFLOW CORRETTO ​

LOCAL:
  git add -A
  git commit -m "fix"
  git push origin main
  ↓
GITHUB:
  Commit ricevuto
  ↓
LARAVEL CLOUD:
  Webhook GitHub triggered (se auto-deploy ON)
  ↓
  1. Pull latest code
  2. composer install
  3. npm run build (se assets changed)
  4. php artisan migrate --force
  5. php artisan optimize
  ↓
  ⚠️ MANCA (manuale):
  6. php artisan cache:clear
  7. php artisan filament:cache-components
  ↓
BROWSER:
  Hard refresh (Cmd+Shift+R)

πŸ’‘ NOTA IMPORTANTE ​

Laravel Cloud a volte mantiene:

  • Config cache
  • Route cache
  • View cache
  • Filament component cache

Anche dopo deploy. Sempre pulire cache manualmente dopo deploy con modifiche strutturali (nuove routes, resources, pages).


🚨 SE ANCORA NON FUNZIONA ​

Verifica che il deploy sia effettivamente completato:

bash
# SSH in Laravel Cloud
cd /var/www/html
git log --oneline -1

# Dovrebbe mostrare: 720e066 fix: SPA URL exceptions...

Se mostra commit vecchio β†’ Deploy non triggerato o fallito.


Prova queste soluzioni e fammi sapere! πŸš€

Realizzato con ❀️ da DScom