Templates e remixes de app

Disponibilidade

Manifest e workflow de registro de app de template estão implementados. Pode listar manifests curados por operador, criar novo registro de app a partir de um, seed valores de ambiente não secretos quando store de ambiente está configurado e criar registro remix limpo a partir de app elegível.

Instantiation não faz deploy do app. Bancos, buckets e serviços de autenticação declarados não são provisionados automaticamente. Alguns serviços declarados são só stub; declaração em manifest não é evidência de que dependência existe.

Navegar manifests

GET /api/apps/templates?category=web&q=next
GET /api/apps/templates/{template_id}

Galeria é public-read. Manifest descreve URL Git de origem, branch, defaults de runtime, schema de variáveis de ambiente e serviços declarados. Revise repositório, revisão atual, licença, estado de manutenção e comandos de runtime antes de instantiation. Manifest é metadado de operador, não endosso de segurança.

Dois manifests seed built-in tornam API non-empty. Repositórios externos podem mudar ou desaparecer e ainda não há smoke test automatizado para todo seed.

Instanciar

POST /api/apps/templates/{template_id}/instantiate
Content-Type: application/json
 
{
  "name": "My app",
  "env": {
    "NEXT_PUBLIC_APP_NAME": "My app"
  }
}

Chamada cria registro de app privado e retorna app_id, informação de origem, tipo de runtime e serviços declarados. Só chaves declaradas pelo manifest são aceitas. Campos secret não são seeded por esta chamada.

Após instantiation:

1. inspecione origem e configurações de runtime do novo app;
2. forneça segredos via Variáveis de ambiente de app;
3. forneça dependências externas reais você mesmo salvo serviço explicitamente reportado ready;
4. chame endpoint de deployment; e
5. siga deployment por build, health check e activation.

Remix

POST /api/apps/{source_app_id}/remix
Content-Type: application/json
 
{
  "name": "My private remix"
}

Owners podem remixar próprio app. Outro usuário pode remixar só app público e marcado remixable. Novo app é privado.

Remix carrega URL de origem, branch, tipo de deployment, port e linhagem. Deliberadamente não copia valores de ambiente, segredos, referências de banco ou bucket, bindings de autenticação, checkpoints, estado IDE ou dados. Também não faz fork nem fixa repositório Git remoto. Se owner de origem mudar ou remover repositório depois, novo deployment pode diferir ou falhar.

Para remix durável, faça fork da origem em repositório que você controla, revise e fixe revisão, atualize origem do novo app e depois deploy.

Checklist de publicação para template

Antes de apresentar template como utilizável:

• confirme repositório e licença;
• fixe ou registre revisão testada;
• valide install, build, run, port e comportamento de health;
• teste campos de ambiente exigidos sem expor segredos;
• verifique que todo serviço declarado está de fato disponível; e
• instancie, deploy, smoke-test e remova em ambiente limpo.