> ## 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.

# Comandi e impostazioni dell'estensione per VS Code

> Tutti i comandi dell'estensione di Square Cloud per VS Code, le sue impostazioni e le soluzioni ai problemi comuni.

## Comandi

Apri il riquadro comandi (`Ctrl+Shift+P` / `Cmd+Shift+P`) e digita **Square Cloud**.

| Comando | Dove compare anche |
| - | - |
| `Square Cloud: Connetti account` | Schermata di accesso, barra di stato quando non sei connesso |
| `Square Cloud: Guida introduttiva` | Schermata di accesso, menu `...` della barra laterale |
| `Square Cloud: Aggiorna` | Barra del titolo della barra laterale, barra di stato |
| `Square Cloud: Carica nuova applicazione` | Barra del titolo della barra laterale, sezione Applicazioni vuota |
| `Square Cloud: Mostra stato del servizio` | Piè di pagina della barra laterale, con un account connesso |
| `Square Cloud: Crea database` | Menu `...` della barra laterale, sezione Database vuota |
| `Square Cloud: Crea spazio di lavoro` | Menu `...` della barra laterale, sezione Spazi di lavoro vuota |
| `Square Cloud: Copia il mio codice di invito` | Menu `...` della barra laterale |
| `Square Cloud: Disconnetti account` | Menu `...` della barra laterale |

Con un account connesso, il riquadro comandi esegue anche le azioni su applicazioni e database. Ognuna chiede quale applicazione o database usare ed elenca solo quelli a cui si applica: Avvia propone le applicazioni che non sono in esecuzione, Arresta e Riavvia quelle che non sono ferme, gli strumenti edge solo i siti web e le metriche solo le applicazioni con 512 MB o più.

| Gruppo | Comandi |
| - | - |
| Ciclo di vita | Avvia applicazione..., Arresta applicazione..., Riavvia applicazione... |
| Log e metriche | Mostra log dell'applicazione..., Attiva/disattiva stream in tempo reale dell'applicazione..., Mostra metriche dell'applicazione (ultime 24h)... |
| Deploy | Esegui commit dei file nell'applicazione..., Scarica snapshot dell'applicazione..., Ripristina snapshot dell'applicazione... |
| Configurazione | Modifica variabili d'ambiente dell'applicazione..., Collega applicazione a un repository GitHub..., Scollega applicazione dal repository GitHub... |
| Edge (siti web) | Mostra log edge..., Mostra errori edge..., Mostra prestazioni edge..., Svuota cache edge... |
| Altro | Apri applicazione nella dashboard web..., Copia ID dell'applicazione..., Elimina applicazione... |
| Database | Avvia database..., Arresta database..., Scarica certificato TLS del database..., Elimina database... |

Le stesse azioni si trovano nel menu di ogni scheda nella barra laterale: fai clic destro su un'applicazione, un database o un workspace, oppure usa il suo pulsante ⋯.

## Impostazioni

| Impostazione | Predefinito | Descrizione |
| - | - | - |
| `squarecloud.favApps` | `[]` | ID delle tue applicazioni preferite, mostrate in cima all'elenco. La stella su ogni scheda la gestisce, quindi raramente dovrai modificarla a mano. |

## Attivazione e aggiornamento

L'estensione si attiva solo quando serve: quando il workspace contiene un file `squarecloud.app` o `squarecloud.config`, oppure quando apri la barra laterale di Square Cloud, esegui uno dei suoi comandi o apri un file di configurazione. Fino ad allora, non ha alcuna attività in background.

Una volta attiva, aggiorna il tuo account ogni **60 secondi**. Il polling si mette in pausa mentre la finestra di VS Code non ha il focus e aggiorna non appena ci torni, così un editor inattivo non consuma la tua quota API. Quando viene raggiunto un rate limit, il polling in background si ferma per qualche minuto e la barra laterale mantiene ciò che è già sullo schermo.

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Nella barra laterale non compare nulla">
    Verifica che un account sia connesso: senza, la barra laterale mostra la schermata di accesso. Se Square Cloud non è raggiungibile, sta mettendo in pausa le richieste o è in manutenzione, la barra laterale indica quale di questi casi si è verificato, con i pulsanti **Riprova** e **Stato del servizio**.
  </Accordion>

  <Accordion title="La tua autorizzazione è scaduta o è stata revocata">
    Le autorizzazioni durano 90 giorni e non possono essere rinnovate in modo silenzioso. Esegui di nuovo `Square Cloud: Connetti account`. Puoi revocare un'autorizzazione in qualsiasi momento da **Il mio account → Autenticazione** nella [dashboard](https://squarecloud.app/it/account/security).
  </Accordion>

  <Accordion title="Qualcuno ti ha mandato un codice o un link da approvare">
    Non inserirlo. Approvare il codice di un'altra persona connette il suo editor al tuo account. Se la pagina rifiuta il codice che hai incollato, ricomincia da VS Code.
  </Accordion>

  <Accordion title="Il caricamento fallisce con un errore di configurazione mancante">
    La cartella scelta deve avere un file `squarecloud.app` o `squarecloud.config` nella radice. Consulta la [guida al file di configurazione](/it/getting-started/config-file).
  </Accordion>

  <Accordion title="Il caricamento fallisce perché lo zip è troppo grande">
    Gli zip sono limitati a 100 MB. Aggiungi l'output della build, le cache e le cartelle delle dipendenze a [`squarecloud.ignore`](/it/getting-started/squarecloud-ignore). `node_modules` e `.git` sono già esclusi, e le dipendenze vengono installate sulla piattaforma a partire dal tuo manifest.
  </Accordion>

  <Accordion title="Un comando è fallito con un messaggio di rate limit">
    Aspetta prima di riprovare. Il polling in background rallenta già da solo, e riprovare di continuo non fa che mantenere attivo il limite.
  </Accordion>

  <Accordion title="Diagnosticare qualsiasi altro problema">
    Apri **Visualizza → Output** e scegli il canale **Square Cloud** per un log di ogni chiamata API, e includilo quando segnali un bug su [GitHub](https://github.com/squarecloudofc/vscode-extension).
  </Accordion>

  <Accordion title="I dati sembrano non aggiornati">
    Fai clic sull'elemento della barra di stato o sull'icona di aggiornamento nella barra del titolo della barra laterale. Ricorda che il polling si mette in pausa mentre la finestra non ha il focus.
  </Accordion>
</AccordionGroup>