Primeiros Passos

↓ Baixar .md

Primeiros Passos

Bem-vindo ao PodCubo! Este guia vai te ajudar a fazer o deploy da sua primeira aplicação em minutos.

O que é o PodCubo?

PodCubo é uma PaaS (Platform as a Service) moderna para desenvolvedores. Faça deploy de apps, bancos de dados e sites estáticos sem gerenciar servidores. Se roda no seu localhost, roda no PodCubo.

Conceitos Principais

Antes de começar, esses são os conceitos principais:

  • Stack — Um grupo de serviços que pertencem juntos (ex: sua app + banco de dados + cache). Internamente, uma stack é um pod — todos os containers compartilham a mesma rede e se comunicam via localhost. Cada stack é isolada das demais.
  • App — Um serviço rodando dentro de uma stack. Pode ser uma aplicação web (do GitHub ou imagem Docker), um banco de dados ou um site estático.
  • Plano — Define os recursos (CPU, RAM, disco) disponíveis para sua stack.

Crie Sua Conta

  1. Acesse app.podcubo.com e crie sua conta
  2. Verifique seu email clicando no link que enviamos
  3. Pronto para fazer deploy!

Faça o Deploy da Sua Primeira App

Pelo GitHub

  1. Crie uma nova stack e escolha um plano
  2. Clique em New App e selecione App como tipo
  3. Escolha Git Repository como fonte
  4. Conecte sua conta do GitHub e selecione seu repositório
  5. Escolha a branch (ou release) para deploy
  6. Defina a porta que sua app escuta
  7. Clique em Create — o PodCubo vai clonar, buildar e fazer deploy automaticamente

Sua app precisa de um Dockerfile na raiz do repositório. Aqui está um exemplo para uma app Node.js:

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
EXPOSE 3000
CMD ["node", "index.js"]

A Partir de uma Imagem Docker

  1. Crie uma nova stack e escolha um plano
  2. Clique em New App e selecione App como tipo
  3. Escolha Container Image como fonte
  4. Digite o nome da imagem (ex: nginx:alpine)
  5. Defina a porta e clique em Create

Próximos Passos

Próximo →Deploy pelo GitHub