Máquinas de Desenvolvimento

Ambientes de desenvolvimento isolados para criar e testar aplicações. Ambientes Linux completos com tecnologia Proyecta Cloud.

O Proyecta provisiona uma máquina de desenvolvimento (runtime) dedicada para cada projeto. Trata-se de um container isolado com um ambiente Linux completo onde sua aplicação roda durante o desenvolvimento.

Como funcionam as máquinas de desenvolvimento?

Quando você abre um projeto, o Proyecta:

1. Cria um container isolado (pod) na nuvem
2. Clona seu código do GitHub
3. Instala as dependências e configura o ambiente
4. Inicia o servidor de desenvolvimento da sua aplicação
5. Exibe um preview ao vivo no builder

Você pode acompanhar o progresso do provisionamento na Runtime Status Bar abaixo da barra de ferramentas.

Etapas de Provisionamento

A barra de status exibe estas etapas durante a inicialização:

Etapa	Descrição
Creating pod	Iniciando o container isolado
Health check	Verificando se o container está em execução
Git init	Clonando seu repositório
Environment setup	Instalando dependências (npm, pip, etc.)
Starting services	Iniciando sua aplicação e a infraestrutura
Ready	Sua máquina de desenvolvimento está totalmente online

Minha máquina de desenvolvimento está com problemas. Como resolver?

Se o preview não estiver carregando ou a máquina parecer travada:

1. Verifique a Runtime Status Bar em busca de mensagens de erro
2. Tente usar o Terminal para inspecionar os logs
3. Se nada funcionar, peça à IA que ajude a depurar o problema

Serviços de Infraestrutura

Sua máquina de desenvolvimento pode incluir containers sidecar para bancos de dados e serviços:

• PostgreSQL — Banco de dados relacional (porta 5432)
• PostGIS — PostgreSQL com extensões geoespaciais (porta 5432)
• Redis — Cache em memória (porta 6379)
• MongoDB — Banco de dados de documentos (porta 27017)
• MySQL — Banco de dados relacional (porta 3306)
• MailHog — Servidor de testes de e-mail com interface web (porta SMTP 1025, porta da UI 8025)

Veja os serviços em execução e seus status no painel Services.

Estados do Ciclo de Vida

As máquinas de desenvolvimento passam pelos seguintes estados do ciclo de vida:

Estado	Descrição
Pending	Aguardando criação
Initializing	Configurando o ambiente
Running	Ativa e saudável
Suspended	Pausada para economizar recursos (retoma rapidamente)
Archived	Armazenada em cold storage (leva mais tempo para restaurar)
Restoring	Sendo restaurada do armazenamento arquivado
Failed	Falha no provisionamento ou na operação — a máquina pode ser reprovisionada
Terminated	Encerrada permanentemente

As máquinas são suspensas automaticamente após 60 minutos de inatividade e arquivadas após 24 horas de suspensão.

Perguntas Frequentes

Se a máquina de desenvolvimento ficar offline, o que acontece com minha aplicação publicada?

O backend da sua aplicação (funções serverless e banco de dados do Convex) roda na própria infraestrutura de nuvem do Convex e permanece disponível independentemente do estado da sua máquina de desenvolvimento. No entanto, os arquivos do frontend da sua aplicação são servidos a partir da máquina de desenvolvimento — se ela estiver suspensa ou arquivada, os visitantes verão um erro 503 até que a máquina seja retomada. Leve isso em consideração para aplicações que você deseja manter acessíveis publicamente; retomar a máquina restaura o site.

Posso obter uma máquina de desenvolvimento mais rápida?

Todas as máquinas de desenvolvimento atualmente rodam com a mesma alocação de recursos. Se precisar de mais capacidade para um projeto grande, entre em contato com o suporte.

Posso acessar a máquina de desenvolvimento diretamente?

Sim. Use o Terminal integrado para ter acesso completo via shell ao seu ambiente de desenvolvimento.