Máquinas de Desenvolvimento
Ambientes de desenvolvimento isolados para construção e testes. Ambientes Linux completos, hospedados no 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 seu app é executado durante o desenvolvimento.
Como funcionam as máquinas de desenvolvimento?
Seção intitulada “Como funcionam as máquinas de desenvolvimento?”Quando você abre um projeto, o Proyecta:
- Cria um container isolado (pod) na nuvem
- Restaura o código do seu projeto nele
- Instala as dependências e configura o ambiente
- Inicia o servidor de desenvolvimento do seu app
- Exibe uma prévia ao vivo no builder
Você pode acompanhar o progresso do provisionamento na Barra de Status do Runtime, abaixo da barra de ferramentas.
Etapas de Provisionamento
Seção intitulada “Etapas de Provisionamento”A barra de status exibe as seguintes etapas durante a inicialização:
| Etapa | Descrição |
|---|---|
| Creating pod | Inicializando 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 seu app e a infraestrutura |
| Ready | Sua máquina de desenvolvimento está totalmente online |
Minha máquina de desenvolvimento está com problemas. Como resolver?
Seção intitulada “Minha máquina de desenvolvimento está com problemas. Como resolver?”Se a prévia não estiver carregando ou a máquina parecer travada:
- Verifique a Barra de Status do Runtime em busca de mensagens de erro
- Peça à IA para verificar os logs do serviço e depurar o problema — ela tem acesso completo à máquina
- Se nada funcionar, peça à IA para ajudar a depurar o problema
Serviços de Infraestrutura
Seção intitulada “Serviços de Infraestrutura”Sua máquina de desenvolvimento pode incluir containers auxiliares (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 teste de e-mail com interface web (SMTP porta 1025, UI porta 8025)
Visualize os serviços em execução e seus status no painel Services.
Estados do Ciclo de Vida
Seção intitulada “Estados do Ciclo de Vida”As máquinas de desenvolvimento passam pelos seguintes estados:
| 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 (demora mais 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ção intitulada “Perguntas Frequentes”Se a máquina de desenvolvimento ficar fora do ar, o que acontece com meu app publicado?
Os dados do seu app ficam na camada de dados da plataforma do Proyecta (o CMS), que é independente da sua máquina de desenvolvimento e permanece disponível. No entanto, os arquivos do frontend do seu app são servidos a partir da máquina de desenvolvimento — se ela for suspensa ou arquivada, os visitantes verão um erro 503 até que a máquina seja retomada. Leve isso em conta para apps que você deseja manter publicamente acessíveis; 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?
Não. Não há acesso a terminal ou shell no builder. A IA tem acesso completo à máquina em seu nome — peça a ela para executar comandos, verificar logs ou inspecionar arquivos, e ela retorna as informações no chat.