Deploy: Publicação em Servidor Gratuito¶

Status: Guia de deployment ⏳

Opções de Servidor Gratuito para ASP.NET Core¶

1. Railway ⭐ Recomendado¶

Vantagens: - ✅ ASP.NET Core suportado - ✅ GitHub integration direto - ✅ Deploy automático em push - ✅ Tier gratuito generoso - ✅ Interface amigável - ✅ Plano free: $5/mês de crédito

Passos:

Criar conta
Ir em https://railway.app
Login com GitHub
Conectar repositório
"New Project" → "Deploy from GitHub"
Autorizar GitHub
Selecionar repositório
Configurar aplicação
Plataforma: ASP.NET Core
Service: Criar novo
Railway detecta automaticamente
Variáveis de ambiente
ASPNETCORE_ENVIRONMENT: Production
ASPNETCORE_URLS: http://*:8080 (Railway redireciona porta)
Deploy automático
Cada push para main gera novo deploy
Verifica status em Railway Dashboard
URL pública gerada automaticamente
Acessar aplicação
URL tipo: https://seu-projeto-production.railway.app
Aparece no Dashboard do Railway

2. Heroku (Alternativa)¶

Vantagens: - ✅ ASP.NET Core suportado - ✅ Buildpack automático - ❌ Tier free descontinuado (nov/2022) - ❌ Requer crédito no cartão agora

Não recomendado para esta atividade (usar Railway em vez disso)

3. Azure App Service (Alternativa)¶

Vantagens: - ✅ ASP.NET Core nativo - ✅ Tier gratuito: 1 app grátis - ✅ Integração GitHub Actions - ❌ Pode exigir verificação de cartão

Passos (resumido): 1. Criar conta Azure free 2. Criar "App Service" 3. Conectar GitHub repository 4. Configurar runtime: .NET 8 5. Deploy automático

URL: tipo seu-app.azurewebsites.net

4. Render¶

Vantagens: - ✅ ASP.NET Core suportado - ✅ Tier free com crédito - ✅ GitHub integration - ✅ PostgreSQL gratuito (em caso de usar DB depois)

Passos (resumido): 1. https://render.com 2. "New +" → "Web Service" 3. Conectar GitHub 4. Runtime: .NET 8 5. Deploy automático

Configurações Necessárias para Deploy¶

1. Program.cs - Configuração de Produção¶

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllersWithViews();
builder.Services.AddSingleton<RepositorioTarefas>();

var app = builder.Build();

// Em produção: Tratamento de erros
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/Error");
    app.UseHsts(); // HTTPS strict transport security
}

app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Tasks}/{action=Index}/{id?}");

app.Run();

2. appsettings.Production.json¶

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*"
}

3. Dockerfile (Opcional, mas recomendado)¶

# Build stage
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["TodoListMvc/TodoListMvc.csproj", "TodoListMvc/"]
RUN dotnet restore "TodoListMvc/TodoListMvc.csproj"
COPY . .
RUN dotnet build "TodoListMvc/TodoListMvc.csproj" -c Release -o /app/build

# Publish stage
FROM build AS publish
RUN dotnet publish "TodoListMvc/TodoListMvc.csproj" -c Release -o /app/publish

# Runtime stage
FROM mcr.microsoft.com/dotnet/aspnet:8.0
WORKDIR /app
COPY --from=publish /app/publish .
EXPOSE 8080
ENV ASPNETCORE_URLS=http://+:8080
ENTRYPOINT ["dotnet", "TodoListMvc.dll"]

4. .dockerignore¶

**/.classpath
**/.dockerignore
**/.env
**/.git
**/.gitignore
**/.project
**/.settings
**/.toolstarget
**/.vs
**/.vscode
**/*.*proj.user
**/*.dbmdl
**/*.jfm
**/azds.yaml
**/bin
**/charts
**/docker-compose*
**/Dockerfile*
**/node_modules
**/npm-debug.log
**/obj
**/secrets.dev.yaml
**/values.dev.yaml
LICENSE
README.md

Deployment via Railway - Passo a Passo¶

Pré-requisitos¶

Conta GitHub com repositório (público ou privado)
Código preparado em main branch
Conta Railway (login com GitHub)

1. Preparar Repositório¶

# Garantir que .gitignore tem as pastas certas
git add .
git commit -m "Pronto para deploy"
git push origin main

2. Deploy no Railway¶

Acessar https://railway.app
Fazer login com GitHub
Clicar "+ New Project"
Selecionar "Deploy from GitHub repo"
Autorizar Railway no GitHub
Selecionar seu repositório
Railway detecta ASP.NET Core automaticamente

3. Configurar Build¶

Railway executa na pasta do projeto .csproj. Se em subpasta:

Ir para "Settings"
"Build" → "Root Directory": TodoListMvc/
Salvar

4. Variáveis de Ambiente¶

Adicionar se necessário: - ASPNETCORE_ENVIRONMENT: Production - ASPNETCORE_URLS: http://*:8080

5. Validar Deploy¶

Ir a "Deployments"
Clicar no deploy mais recente
Esperar "Build" → "Deploy" → "Running"
Clicar em "View logs" para acompanhar

6. Obter URL Pública¶

Ir a "Settings"
Copiar "Public Domain"
Acessar em navegador

Verificação Pós-Deploy¶

✅ Checklist de Validação¶

Endereço URL¶

https://[seu-app]-production.railway.app

Exemplo:

https://todo-list-ifes-production.railway.app

Documentação MkDocs Online¶

Publicar em GitHub Pages¶

Instalar MkDocs
```
pip install mkdocs mkdocs-material
```

Build local (teste)

mkdocs serve
# Acessar http://localhost:8000

Deploy para GitHub Pages
```
mkdocs gh-deploy
```
Configurar GitHub Pages
Ir para repository Settings
Em "Pages", selecionar source: gh-pages branch
Salvar

Acessar documentação

https://seu-usuario.github.io/seu-repositorio

Monitoramento¶

Railway Dashboard¶

Monitorar CPU e memória
Ver logs em tempo real
Reverter deploy anterior se necessário
Métricas de requisições

Logs¶

Acessar em Railway: - Ir a aplicação - "Deployment" → View logs - Buscar por erros

Troubleshooting¶

Erro: Application startup exception¶

Solução: - Verificar appsettings.Production.json - Olhar logs completos em Railway - Testar localmente em modo Production: ASPNETCORE_ENVIRONMENT=Production dotnet run

Erro: Build failed¶

Solução: - Validar que .csproj compila: dotnet build - Verificar raiz do projeto em Railway Settings - Checar logs do build

Aplicação muito lenta¶

Solução: - Tier free Railway tem limite de recursos - Considerar upgrade se necessário - Otimizar queries (não aplicável, in-memory)

Dados desaparecem após restart¶

Solução: - Esperado! Armazenamento in-memory por requisito - Se quiser persistência depois, adicionar banco de dados

Links Finais¶

Após deployment bem-sucedido, atualizar o arquivo ENTREGA.md no repositório com: - Link GitHub: https://github.com/seu-usuario/seu-repositorio - Link Aplicação: https://[seu-app]-production.railway.app - Link Documentação: https://seu-usuario.github.io/seu-repositorio

Deployment Guide Completo ✅