> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Funzionalità dell'estensione per VS Code
> Fai il deploy, gestisci e monitora applicazioni, database e workspace di Square Cloud dalla barra laterale di VS Code.
## Deploy
### Carica una nuova applicazione
Esegui `Square Cloud: Carica nuova applicazione` dal riquadro comandi, dall'icona di caricamento nella barra del titolo della barra laterale, oppure da **Carica la tua prima applicazione** su un account vuoto.
Le cartelle aperte nel tuo workspace compaiono per prime; **Sfoglia...** permette di scegliere qualsiasi altra cartella.
La cartella deve contenere un file [`squarecloud.app` o `squarecloud.config`](/it/getting-started/config-file). Se manca, non viene caricato nulla e l'errore rimanda alla guida al file di configurazione.
Una finestra di dialogo chiede conferma prima che qualcosa lasci la tua macchina.
La cartella viene compressa in uno zip applicando le tue regole di esclusione, con un conteggio dei file in tempo reale, e puoi annullare finché il caricamento non inizia. Gli zip sono limitati a 100 MB.
La notifica mostra il runtime rilevato e offre **Apri dashboard** e **Copia ID**. Se il file di configurazione dichiara un `SUBDOMAIN`, l'applicazione risponde su `https://.squareweb.app` una volta avviata.
### Esegui il commit delle modifiche su un'applicazione esistente
Apri il menu delle azioni di un'applicazione (fai clic destro sulla sua scheda, oppure usa il suo pulsante ⋯) e scegli **Commit**. Scegli se riavviare l'applicazione al termine, poi seleziona uno o più file, oppure una cartella. Una cartella viene compressa con le stesse regole di esclusione e finisce dentro una cartella con lo stesso nome nell'applicazione.
Il *caricamento* crea una nuova applicazione, con un nuovo ID. Il *commit* invia file a un'applicazione che esiste già e ne mantiene ID, dominio e configurazione.
### Regole di esclusione
L'estensione e la [CLI di Square Cloud](/it/cli-reference/installation) leggono lo stesso file [`squarecloud.ignore`](/it/getting-started/squarecloud-ignore), con la stessa sintassi di `.gitignore` e gli stessi valori predefiniti: `node_modules`, `.git`, `.github`, `.vscode` e i lockfile vengono sempre esclusi, a meno che una regola `!` non li reincluda. Il tuo `.gitignore` non viene letto, perché spesso elenca file di cui l'applicazione ha bisogno per funzionare, come `.env`.
## Applicazioni
La barra laterale si apre con il tuo account: nome, piano e un indicatore della RAM del piano. Sotto, ogni applicazione è una scheda con un badge di stato in tempo reale (**Online**, **Offline**, **In verifica** mentre lo stato si carica, oppure color ambra mentre un'azione che hai avviato è in corso), la sua RAM e, mentre è in esecuzione, la sua CPU. Fai clic su una scheda per vederne ID, memoria, runtime, cluster, dominio e quando è stata avviata.
* Passando il puntatore su una scheda compaiono avvio o arresto, riavvio e log. La stella accanto al nome la segna come preferita e la mantiene in cima.
* **Fai clic destro su una scheda, o usa il suo pulsante ⋯, per il menu completo delle azioni**, raggruppate per scopo, con le azioni distruttive in fondo.
* Oltre le 10 applicazioni, l'elenco ne mostra 10 alla volta con le frecce per la pagina precedente e successiva, e un filtro per nome, dominio o ID ti permette di trovarne qualsiasi.
* Le azioni che non possono funzionare non vengono proposte: gli strumenti edge compaiono solo per le applicazioni con un dominio, e le metriche solo per le applicazioni con 512 MB o più.
| Azione | Cosa fa |
| - | - |
| **Avvia**, **Arresta**, **Riavvia** | Invia l'azione e segue lo stato finché non cambia. Avviare un'applicazione in esecuzione, o arrestarne una già ferma, viene mostrato come informazione, non come errore. |
| **Mostra log** | Recupera i log più recenti in un canale di output dedicato, mantenendo i colori. |
| **Attiva/disattiva stream in tempo reale** | Apre un feed live dell'applicazione in un canale di output; eseguilo di nuovo per fermarlo. Quando il server chiude la connessione, l'estensione si riconnette da sola. |
| **Mostra metriche delle ultime 24h** | Stampa le ultime 24 ore di CPU, RAM e rete in campioni da 5 minuti, più l'ultimo campione e le medie. Richiede 512 MB o più. |
| **Scarica snapshot** | Genera un nuovo snapshot e salva lo zip nella cartella che scegli. Per un'applicazione grande la generazione può richiedere un paio di minuti: l'estensione lo segnala, e a quel punto basta eseguire di nuovo il comando per salvarlo. |
| **Ripristina snapshot** | Elenca gli snapshot salvati, dal più recente, con la loro dimensione, e ripristina quello che scegli dopo una conferma. |
| **Variabili d'ambiente** | Elenca, aggiunge, modifica ed elimina le variabili, oppure le cancella tutte dopo una conferma. Le modifiche si applicano subito. |
| **Collega / Scollega repository GitHub** | Collega un repository e un branch tramite la [GitHub App di Square Cloud](/it/api-reference/endpoint/apps/deploy/github-app-link), così ogni push esegue il deploy dell'applicazione. |
| **Log / Errori / Prestazioni edge** | Per le applicazioni con un dominio: scegli un intervallo (1 ora, 6 ore, 24 ore o 7 giorni) e il report si apre in un canale di output. |
| **Svuota cache edge** | Svuota l'intera cache edge dell'applicazione dopo una conferma. |
| **Elimina** | Ti chiede di digitare il nome dell'applicazione, crea uno snapshot di recupero e poi la elimina. Se quello snapshot è ancora in fase di generazione, non viene eliminato nulla e ti viene chiesto di riprovare tra un paio di minuti. |
## Database
La sezione **Database** elenca i tuoi database gestiti con motore e memoria. Fai clic destro su uno di essi, o usa il suo pulsante ⋯, per le azioni **Avvia database**, **Arresta database**, **Scarica certificato TLS** ed **Elimina database** (digita il nome per confermare). Il certificato viene salvato come file `.pem` leggibile solo da te.
**Crea database** si trova nel menu `...` della barra laterale, nel riquadro comandi e nella sezione Database vuota. Assegnagli un nome, un motore (`mongo`, `mysql`, `redis` o `postgres`), la memoria in MB e una versione. Non appena il database esiste, il suo URL di connessione, password inclusa, viene copiato negli appunti, con un pulsante **Copia password**.
Square Cloud mostra le credenziali di un nuovo database una sola volta. Conservale in un posto sicuro.
## Workspace
La sezione **Spazi di lavoro** mostra ogni workspace di cui sei proprietario o membro, con il numero di membri e di applicazioni. Fai clic destro su uno di essi, o usa il suo pulsante ⋯, per le azioni **Esci dallo spazio di lavoro** ed **Elimina spazio di lavoro** (solo il proprietario può eliminarlo). **Crea spazio di lavoro** si trova nel menu `...` della barra laterale, nel riquadro comandi e nella sezione Spazi di lavoro vuota.
Per entrare nel workspace di qualcun altro, usa **Copia il mio codice di invito** nel menu `...` della barra laterale. Copia il tuo codice di invito personale: invialo al proprietario del workspace, che lo usa per aggiungerti.
## Stato e problemi
* Lo stato della piattaforma si trova nel piè di pagina della barra laterale. Quando Square Cloud segnala problemi, un banner in alto mostra il suo messaggio e un link alla [pagina di stato](https://status.squarecloud.app/).
* **Ogni problema ha il suo stato illustrato:** nessuna connessione, una pausa per rate limit con il conto alla rovescia fino al nuovo tentativo automatico, manutenzione, un'autorizzazione che richiede di connettersi di nuovo, un errore imprevisto e un account senza piano. Ognuno offre il pulsante che serve: **Riprova**, **Connetti account**, **Stato del servizio** o **Vedi i piani**.
* Se un aggiornamento non riesce mentre i tuoi dati sono sullo schermo, un piccolo banner lo segnala e mantiene gli ultimi dati caricati.
* L'**elemento della barra di stato** mostra se un account è connesso, quante applicazioni sono online e se Square Cloud è offline, sta mettendo in pausa le richieste o è degradato. Passaci sopra il puntatore per vedere account, piano e stato del servizio; fai clic per aggiornare.
## IntelliSense del file di configurazione
`squarecloud.app` e `squarecloud.config` hanno il supporto completo dell'editor, senza nient'altro da installare.
* **Validazione durante la digitazione:** chiavi obbligatorie mancanti e duplicate, lunghezza dei valori, un file `MAIN` che non esiste, una `MEMORY` sotto il minimo o oltre la memoria libera del tuo piano, caratteri non validi in `SUBDOMAIN` e valori sconosciuti di `RUNTIME` o `VERSION` vengono sottolineati come errori.
* **Completamento automatico:** ogni chiave su una riga vuota e, dopo `=`, i file sorgente per `MAIN`, i runtime per `RUNTIME`, `recommended` e `latest` per `VERSION`, `true` e `false` per `AUTORESTART` e le dimensioni di memoria per `MEMORY`.
* **Correzioni rapide:** la lampadina su una riga `AUTORESTART`, `VERSION` o `RUNTIME` imposta un valore valido con un clic.
* **Evidenziazione e icone** per `squarecloud.app`, `squarecloud.config` e `squarecloud.ignore`.
Consulta la [guida al file di configurazione](/it/getting-started/config-file) per tutte le chiavi.