Templates de 1 clique
Um template cria, de uma vez, o banco gerenciado, o app e o volume de uma aplicação conhecida, já ligados entre si por referências. Você não escreve Dockerfile nem variáveis de conexão.
Catálogo
Seção intitulada “Catálogo”Template (id) |
Banco | Volume do app | Porta | Parâmetros |
|---|---|---|---|---|
wordpress (guia) |
MariaDB (db, 1024 MB) |
5 GB em /var/www/html/wp-content |
8080 | table_prefix (padrão wp_) |
ghost |
MariaDB (db, 1024 MB) |
5 GB em /var/lib/ghost/content |
2368 | nenhum |
prestashop |
MariaDB (db, 1024 MB) |
5 GB em /var/www/html |
80 | db_prefix (padrão ps_) |
n8n (guia) |
Postgres (db, 1024 MB) |
5 GB em /home/node/.n8n |
5678 | nenhum |
Todo template cria dois serviços de nomes fixos: db (banco) e web (app público). As imagens vêm fixadas por digest, e o app roda sem privilégios. A lista atual, com versões e parâmetros, vem de GET /v1/templates.
Pelo painel
Seção intitulada “Pelo painel”- Abra o projeto e vá na aba Templates (ou use Novo projeto para criar o projeto junto).
- Escolha o template e preencha os parâmetros, se houver.
- Confirme. A criação é tudo ou nada: se algo falhar, nada fica criado.
- Acompanhe o deploy do
web. Ele só fica no ar depois que o banco está provisionado.
Pela API
Seção intitulada “Pela API”Escopos: templates:deploy mais os do que o template cria (projects:write, env:write, databases:write e volumes:write). Faltando algum, a resposta é 403 forbidden com a lista na mensagem.
curl -sS "$NEBULAR_API/v1/templates" \ -H "Authorization: Bearer $NEBULAR_TOKEN"{"items": [{"id": "wordpress", "name": "WordPress", "version": 1, "params": []}], "next_cursor": null, "has_more": false}Instancie com POST /v1/projects/{p}/templates/{t}:
NAME="tpl-$(date +%s)-$RANDOM"H="Authorization: Bearer $NEBULAR_TOKEN"P=$(curl -sS -X POST "$NEBULAR_API/v1/projects" -H "$H" -H "Content-Type: application/json" \ -d "{\"name\": \"$NAME\"}" | jq -r .id)
curl -sS -X POST "$NEBULAR_API/v1/projects/$P/templates/wordpress" \ -H "$H" -H "Content-Type: application/json" \ -H "Idempotency-Key: $NAME-wordpress" \ -d '{"params": {"table_prefix": "wp_"}}'{"template_id": "wordpress", "version": 1, "project_id": "01j9zkk07fhzv5zsmn996cdwpb", "services": [{"id": "01j9zkff8y1dmcwa49fanx9qak", "name": "db", "kind": "database"}, {"id": "01j9zkwf4q15w38y0taf680jvv", "name": "web", "kind": "app"}], "deploy_started": true}- A instanciação é atômica e idempotente pela
Idempotency-Key. - O
webque todo projeto traz é adotado pelo template se ainda estiver virgem (sem deploy, variáveis, domínio ou volume). - Se o deploy não pôde iniciar,
deploy_errordiz por quê e os serviços continuam criados. - Acompanhe o deploy por polling.
| Resposta | O que fazer |
|---|---|
403 forbidden |
Faltam escopos; a mensagem lista quais. |
404 not_found |
Projeto ou template inexistente, ou de outro time. |
409 name_taken |
O projeto já tem um serviço db, ou o web já foi usado. Use um projeto novo. |
422 quota_exceeded |
Cota do time (serviços, banco, volume). Nada é criado. Veja Limites e cotas. |
503 |
Sem bancos ou volumes habilitados na instalação, ou nó de banco indisponível. Repita com backoff. |
Referência completa: Templates (referência).