# 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

| Template (`id`) | Banco | Volume do app | Porta | Parâmetros |
|---|---|---|---|---|
| `wordpress` ([guia](/guia/wordpress/)) | 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](/guia/n8n/)) | **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

1. Abra o projeto e vá na aba **Templates** (ou use **Novo projeto** para criar o projeto junto).
2. Escolha o template e preencha os parâmetros, se houver.
3. Confirme. A criação é **tudo ou nada**: se algo falhar, nada fica criado.
4. Acompanhe o deploy do `web`. Ele só fica no ar depois que o banco está provisionado.

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

```bash
curl -sS "$NEBULAR_API/v1/templates" \
  -H "Authorization: Bearer $NEBULAR_TOKEN"
```
```json
{"items": [{"id": "wordpress", "name": "WordPress", "version": 1, "params": []}], "next_cursor": null, "has_more": false}
```

Instancie com `POST /v1/projects/{p}/templates/{t}`:

```bash
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_"}}'
```
```json
{"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 `web` que 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_error` diz por quê e os serviços continuam criados.
- Acompanhe o deploy por [polling](/operacao/deploys-e-status/).

| 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](/operacao/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)](/referencia/templates/).
