Skip to content

DEPLOY.md

Latest commit

 

History

History
217 lines (150 loc) · 4.59 KB

DEPLOY.md

File metadata and controls

217 lines (150 loc) · 4.59 KB

🚀 Guia de Deploy - Vercel

Este documento contém instruções para fazer deploy da aplicação Guia do Servidor Facilitador no Vercel.

📋 Pré-requisitos

🔧 Opção 1: Deploy Automatizado com Python (Recomendado)

Passo 1: Preparar o Token do Vercel

  1. Acesse https://vercel.com/account/tokens
  2. Clique em "Create Token"
  3. Dê um nome ao token (ex: storybook-deploy)
  4. Copie o token gerado

Passo 2: Executar o Script de Deploy

# Tornar o script executável
chmod +x deploy.py

# Executar o script
python3 deploy.py

O script irá:

  • ✓ Verificar dependências (Node.js, pnpm, Vercel CLI)
  • ✓ Instalar dependências do projeto
  • ✓ Compilar o projeto
  • ✓ Solicitar seu token do Vercel
  • ✓ Fazer o deploy (produção ou preview)

Passo 3: Escolher Tipo de Deploy

Quando solicitado, escolha:

  • Opção 1: Deploy em PRODUÇÃO (URL permanente)
  • Opção 2: Deploy em PREVIEW (URL temporária para testes)

🔧 Opção 2: Deploy Automatizado com Bash

# Tornar o script executável
chmod +x deploy-vercel.sh

# Executar o script
./deploy-vercel.sh

🔧 Opção 3: Deploy Manual com Vercel CLI

Passo 1: Instalar Vercel CLI

npm install -g vercel

Passo 2: Fazer Login no Vercel

vercel login

Passo 3: Fazer Deploy

Para PRODUÇÃO:

vercel --prod

Para PREVIEW:

vercel

🔧 Opção 4: Deploy via GitHub (Recomendado para CI/CD)

Passo 1: Conectar Repositório ao Vercel

  1. Acesse https://vercel.com/new
  2. Clique em "Import Git Repository"
  3. Selecione narcisolcf/FERRAMENTASENSINOPMM
  4. Clique em "Import"

Passo 2: Configurar Projeto

  1. Project Name: storybook-mombach (ou seu nome preferido)
  2. Framework: Vite
  3. Build Command: pnpm run build
  4. Output Directory: dist

Passo 3: Variáveis de Ambiente (Opcional)

Adicione se necessário:

VITE_APP_TITLE=Guia do Servidor Facilitador
VITE_APP_LOGO=/logo-mombach.png

Passo 4: Deploy

Clique em "Deploy" e aguarde a conclusão.

📊 Verificar Deploy

Após o deploy, você receberá uma URL como:

https://storybook-mombach.vercel.app

Acesse a URL para verificar se tudo está funcionando corretamente.

🌐 Configurar Domínio Customizado

Passo 1: Acessar Configurações do Projeto

  1. Acesse https://vercel.com/dashboard
  2. Selecione seu projeto storybook-mombach
  3. Clique em "Settings"

Passo 2: Adicionar Domínio

  1. Clique em "Domains"
  2. Clique em "Add"
  3. Digite seu domínio (ex: storybook.mombach.ce.gov.br)
  4. Siga as instruções para configurar o DNS

🔄 Atualizar Deploy

Sempre que você fizer alterações no código:

Opção 1: Via Git (Automático)

git add .
git commit -m "Descrição das alterações"
git push origin main

O Vercel fará o deploy automaticamente.

Opção 2: Via CLI (Manual)

python3 deploy.py
# ou
./deploy-vercel.sh

📝 Variáveis de Ambiente

Se precisar adicionar variáveis de ambiente:

  1. Acesse https://vercel.com/dashboard
  2. Selecione seu projeto
  3. Clique em "Settings" → "Environment Variables"
  4. Adicione as variáveis necessárias

🐛 Troubleshooting

Erro: "Vercel CLI not found"

npm install -g vercel

Erro: "pnpm not found"

npm install -g pnpm

Erro: "Build failed"

Verifique se:

  • Todas as dependências estão instaladas: pnpm install
  • O comando de build funciona localmente: pnpm run build
  • Não há erros de TypeScript: pnpm run type-check

Erro: "Token inválido"

  1. Gere um novo token em https://vercel.com/account/tokens
  2. Defina a variável de ambiente: 
    export VERCEL_TOKEN='seu-novo-token'

📚 Recursos Úteis

💡 Dicas

  1. Sempre faça teste em preview antes de produção
  2. Use variáveis de ambiente para dados sensíveis
  3. Monitore os logs de deploy para erros
  4. Configure alertas de erro no Vercel
  5. Faça backup do seu repositório GitHub

📞 Suporte

Para dúvidas ou problemas:

Última atualização: Novembro 2025 Projeto: Guia do Servidor Facilitador - Storybook Prefeitura: Mombaça, Ceará