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

# Comandos e configurações da extensão do VS Code

> Todos os comandos da extensão da Square Cloud para VS Code, as configurações e soluções para problemas comuns.

## Comandos

Abra a paleta de comandos (`Ctrl+Shift+P` / `Cmd+Shift+P`) e digite **Square Cloud**.

| Comando | Onde mais aparece |
| - | - |
| `Square Cloud: Conectar conta` | Tela de login, barra de status sem conta conectada |
| `Square Cloud: Primeiros passos` | Tela de login, menu `...` da barra lateral |
| `Square Cloud: Atualizar` | Barra de título da barra lateral, barra de status |
| `Square Cloud: Enviar nova aplicação` | Barra de título da barra lateral, seção Aplicações vazia |
| `Square Cloud: Exibir status do serviço` | Rodapé da barra lateral, com uma conta conectada |
| `Square Cloud: Criar banco de dados` | Menu `...` da barra lateral, seção Bancos de dados vazia |
| `Square Cloud: Criar workspace` | Menu `...` da barra lateral, seção Workspaces vazia |
| `Square Cloud: Copiar meu código de convite` | Menu `...` da barra lateral |
| `Square Cloud: Desconectar conta` | Menu `...` da barra lateral |

Com uma conta conectada, a paleta também executa as ações de aplicações e de bancos de dados. Cada uma pergunta qual aplicação ou banco de dados usar e lista só aqueles aos quais ela se aplica: Iniciar oferece as aplicações que não estão rodando, Parar e Reiniciar as que não estão paradas, as ferramentas da edge só sites e as métricas só aplicações com 512 MB ou mais.

| Grupo | Comandos |
| - | - |
| Ciclo de vida | Iniciar aplicação..., Parar aplicação..., Reiniciar aplicação... |
| Logs e métricas | Exibir logs da aplicação..., Alternar stream em tempo real da aplicação..., Exibir métricas de 24h da aplicação... |
| Deploy | Enviar arquivos para a aplicação (commit)..., Baixar snapshot da aplicação..., Restaurar snapshot da aplicação... |
| Configuração | Editar variáveis de ambiente da aplicação..., Vincular aplicação a um repositório do GitHub..., Desvincular aplicação do repositório do GitHub... |
| Edge (sites) | Exibir logs da edge..., Exibir erros da edge..., Exibir desempenho da edge..., Limpar cache da edge... |
| Outros | Abrir aplicação no painel web..., Copiar ID da aplicação..., Excluir aplicação... |
| Bancos de dados | Iniciar banco de dados..., Parar banco de dados..., Baixar certificado TLS do banco de dados..., Excluir banco de dados... |

As mesmas ações estão no menu de cada cartão da barra lateral: clique com o botão direito em uma aplicação, banco de dados ou workspace, ou use o botão ⋯ dele.

## Configurações

| Configuração | Padrão | Descrição |
| - | - | - |
| `squarecloud.favApps` | `[]` | IDs das suas aplicações favoritas, exibidas no topo da lista. A estrela de cada cartão gerencia essa lista, então raramente você precisa editá-la à mão. |

## Ativação e atualização

A extensão só é ativada quando necessário: quando o workspace tem um arquivo `squarecloud.app` ou `squarecloud.config`, ou quando você abre a barra lateral da Square Cloud, executa um dos comandos dela ou abre um arquivo de configuração. Até lá, ela não tem nenhuma atividade em segundo plano.

Depois de ativa, ela atualiza sua conta a cada **60 segundos**. As consultas ficam pausadas enquanto a janela do VS Code está sem foco, e a extensão atualiza assim que você volta, então um editor ocioso não gasta sua cota da API. Quando um rate limit é atingido, as consultas em segundo plano pausam por alguns minutos e a barra lateral mantém o que já está na tela.

## Solução de problemas

<AccordionGroup>
  <Accordion title="Nada aparece na barra lateral">
    Confira se há uma conta conectada: sem uma, a barra lateral mostra a tela de login. Se não for possível acessar a Square Cloud, ou se ela estiver pausando requisições ou em manutenção, a barra lateral diz qual é o caso, com os botões **Tentar novamente** e **Status do serviço**.
  </Accordion>

  <Accordion title="Sua autorização expirou ou foi revogada">
    As autorizações duram 90 dias e não podem ser renovadas em segundo plano. Execute `Square Cloud: Conectar conta` de novo. Você pode revogar uma autorização a qualquer momento em **Minha Conta → Autenticação** no [dashboard](https://squarecloud.app/pt-br/account/security).
  </Accordion>

  <Accordion title="Alguém enviou um código ou link para você aprovar">
    Não digite o código. Aprovar o código de outra pessoa conecta o editor dela à sua conta. Se a página recusar o código que você colou, comece de novo pelo VS Code.
  </Accordion>

  <Accordion title="O upload falha com um erro de configuração ausente">
    A pasta escolhida precisa de um arquivo `squarecloud.app` ou `squarecloud.config` na raiz. Veja o [guia do arquivo de configuração](/pt-br/getting-started/config-file).
  </Accordion>

  <Accordion title="O upload falha porque o zip é grande demais">
    Os zips são limitados a 100 MB. Adicione a saída de build, os caches e as pastas de dependências ao [`squarecloud.ignore`](/pt-br/getting-started/squarecloud-ignore). `node_modules` e `.git` já ficam de fora, e as dependências são instaladas na plataforma a partir do seu manifesto.
  </Accordion>

  <Accordion title="Um comando falhou com uma mensagem de rate limit">
    Espere antes de tentar de novo. As consultas em segundo plano já diminuem o ritmo sozinhas, e tentar várias vezes seguidas só mantém o limite ativo.
  </Accordion>

  <Accordion title="Diagnosticar qualquer outro problema">
    Abra **Exibir → Saída** e escolha o canal **Square Cloud** para ver um log de todas as chamadas à API, e inclua esse log quando reportar um bug no [GitHub](https://github.com/squarecloudofc/vscode-extension).
  </Accordion>

  <Accordion title="Os dados parecem desatualizados">
    Clique no item da barra de status ou no ícone de atualizar na barra de título da barra lateral. Lembre-se de que as consultas ficam pausadas enquanto a janela está sem foco.
  </Accordion>
</AccordionGroup>
