Pular para o conteúdo

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.

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.

  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.

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.

Janela do terminal
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}:

Janela do terminal
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 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.
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).