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

# Commandes et paramètres de l'extension VS Code

> Toutes les commandes de l'extension Square Cloud pour VS Code, ses paramètres et les solutions aux problèmes courants.

## Commandes

Ouvrez la palette de commandes (`Ctrl+Shift+P` / `Cmd+Shift+P`) et tapez **Square Cloud**.

| Commande | Où elle apparaît aussi |
| - | - |
| `Square Cloud: Connecter un compte` | Vue de connexion, barre d'état quand aucun compte n'est connecté |
| `Square Cloud: Premiers pas` | Vue de connexion, menu `...` de la barre latérale |
| `Square Cloud: Actualiser` | Barre de titre de la barre latérale, barre d'état |
| `Square Cloud: Téléverser une nouvelle application` | Barre de titre de la barre latérale, section Applications vide |
| `Square Cloud: Afficher le statut du service` | Pied de la barre latérale, avec un compte connecté |
| `Square Cloud: Créer une base de données` | Menu `...` de la barre latérale, section Bases de données vide |
| `Square Cloud: Créer un espace de travail` | Menu `...` de la barre latérale, section Espaces de travail vide |
| `Square Cloud: Copier mon code d'invitation` | Menu `...` de la barre latérale |
| `Square Cloud: Déconnecter le compte` | Menu `...` de la barre latérale |

Avec un compte connecté, la palette exécute aussi les actions sur les applications et les bases de données. Chacune demande quelle application ou base de données utiliser et ne liste que celles auxquelles elle s'applique : Démarrer propose les applications qui ne sont pas en cours d'exécution, Arrêter et Redémarrer celles qui ne sont pas arrêtées, les outils edge uniquement les sites web, et les métriques uniquement les applications de 512 MB ou plus.

| Groupe | Commandes |
| - | - |
| Cycle de vie | Démarrer une application..., Arrêter une application..., Redémarrer une application... |
| Logs et métriques | Afficher les logs d'une application..., Activer/désactiver le flux en temps réel d'une application..., Afficher les métriques d'une application sur 24 h... |
| Déploiement | Envoyer des fichiers à une application (commit)..., Télécharger le snapshot d'une application..., Restaurer le snapshot d'une application... |
| Configuration | Modifier les variables d'environnement d'une application..., Lier une application à un dépôt GitHub..., Dissocier une application de son dépôt GitHub... |
| Edge (sites web) | Afficher les logs edge..., Afficher les erreurs edge..., Afficher les performances edge..., Vider le cache edge... |
| Autres | Ouvrir une application dans le tableau de bord web..., Copier l'ID d'une application..., Supprimer une application... |
| Bases de données | Démarrer une base de données..., Arrêter une base de données..., Télécharger le certificat TLS d'une base de données..., Supprimer une base de données... |

Les mêmes actions se trouvent dans le menu de chaque carte de la barre latérale : faites un clic droit sur une application, une base de données ou un workspace, ou utilisez son bouton ⋯.

## Paramètres

| Paramètre | Valeur par défaut | Description |
| - | - | - |
| `squarecloud.favApps` | `[]` | IDs de vos applications favorites, affichées en haut de la liste. L'étoile de chaque carte gère ce paramètre : vous aurez donc rarement besoin de le modifier à la main. |

## Activation et actualisation

L'extension ne s'active qu'en cas de besoin : lorsque le workspace contient un fichier `squarecloud.app` ou `squarecloud.config`, ou lorsque vous ouvrez la barre latérale Square Cloud, exécutez l'une de ses commandes ou ouvrez un fichier de configuration. Jusque-là, elle n'a aucune activité en arrière-plan.

Une fois active, elle actualise votre compte toutes les **60 secondes**. L'interrogation se met en pause lorsque la fenêtre VS Code n'a pas le focus et l'extension actualise dès que vous revenez, afin qu'un éditeur inactif ne consomme pas votre quota d'API. Lorsqu'une limite de requêtes est atteinte, l'interrogation en arrière-plan se met en pause pendant quelques minutes et la barre latérale conserve ce qui est déjà affiché.

## Dépannage

<AccordionGroup>
  <Accordion title="Rien ne s'affiche dans la barre latérale">
    Vérifiez qu'un compte est connecté : sans compte, la barre latérale affiche l'écran de connexion. Si Square Cloud est injoignable, met les requêtes en pause ou est en maintenance, la barre latérale l'indique, avec les boutons **Réessayer** et **Statut du service**.
  </Accordion>

  <Accordion title="Votre autorisation a expiré ou a été révoquée">
    Les autorisations durent 90 jours et ne peuvent pas être renouvelées en silence. Exécutez à nouveau `Square Cloud: Connecter un compte`. Vous pouvez révoquer une autorisation à tout moment dans **Mon compte → Authentification** du [tableau de bord](https://squarecloud.app/fr/account/security).
  </Accordion>

  <Accordion title="Quelqu'un vous a envoyé un code ou un lien à approuver">
    Ne le saisissez pas. Approuver le code de quelqu'un d'autre connecte son éditeur à votre compte. Si la page refuse le code que vous avez collé, recommencez depuis VS Code.
  </Accordion>

  <Accordion title="Le téléversement échoue avec une erreur de configuration manquante">
    Le dossier choisi doit contenir un fichier `squarecloud.app` ou `squarecloud.config` à sa racine. Consultez le [guide du fichier de configuration](/fr/getting-started/config-file).
  </Accordion>

  <Accordion title="Le téléversement échoue car le zip est trop volumineux">
    Les archives zip sont limitées à 100 MB. Ajoutez les fichiers de build, les caches et les dossiers de dépendances à [`squarecloud.ignore`](/fr/getting-started/squarecloud-ignore). `node_modules` et `.git` sont déjà exclus, et les dépendances sont installées sur la plateforme à partir de votre manifeste.
  </Accordion>

  <Accordion title="Une commande a échoué avec un message de limite de requêtes">
    Patientez avant de réessayer. L'interrogation en arrière-plan ralentit déjà d'elle-même, et réessayer en boucle ne fait que maintenir la limite.
  </Accordion>

  <Accordion title="Diagnostiquer tout autre problème">
    Ouvrez **Affichage → Sortie** et choisissez le canal **Square Cloud** pour obtenir un journal de chaque appel à l'API, et joignez-le lorsque vous signalez un bug sur [GitHub](https://github.com/squarecloudofc/vscode-extension).
  </Accordion>

  <Accordion title="Les données semblent obsolètes">
    Cliquez sur l'élément de la barre d'état ou sur l'icône d'actualisation dans la barre de titre de la barre latérale. N'oubliez pas que l'interrogation se met en pause lorsque la fenêtre n'a pas le focus.
  </Accordion>
</AccordionGroup>
