devpersonalsite/dotnet9-devpersonal-site

🚀 Entorno de Desarrollo Completo .NET 9.0

*** Docker lista para producción y desarrollo con .NET 9.0, Node.js, herramientas esenciales y Cloudflare Tunnel integrado para conexiones seguras a SQL Server.

---

✨ Características

Tecnologías Principales

• 🎯 .NET SDK 9.0 - Última versión estable de .NET
• 🌐 Node.js 20 LTS + npm - Para desarrollo full-stack
• 🔧 Herramientas de desarrollo completas - Git, Vim, Nano, htop, tree, jq, y más

Herramientas Globales de .NET Preinstaladas

• dotnet-ef - Migraciones con Entity Framework Core
• dotnet-aspnet-codegenerator - Scaffolding de ASP.NET
• dotnet-dev-certs - Gestión de certificados HTTPS
• dotnet-counters - Monitoreo de rendimiento
• dotnet-trace - Trazado de diagnóstico
• dotnet-dump - Análisis de dumps de memoria

Funcionalidades Inteligentes

• 📦 Auto-reload para apps de consola usando dotnet watch run
• 🔐 Cloudflare Tunnel preconfigurado para SQL Server
• 🎨 Comandos personalizados para desarrollo rápido
• 📋 Plantillas de proyectos extendidas
• ⚡ Optimizado para desarrollo con soporte hot-reload

---

🚀 Inicio Rápido

1. Crear contenedor desde Docker Hub

Si ya descargaste la ***:

bash
docker pull devpersonalsite/dotnet9-devpersonal-site:latest

Crear el contenedor con todos los volúmenes y puertos necesarios:

bash
docker run -d --name dotnet9-dev \
  -p 5000:5000 \
  -p 5001:5001 \
  -p 8080:8080 \
  -p 8081:8081 \
  -p 3000:3000 \
  -p 3001:3001 \
  -p 11433:11433 \
  -p 13306:13306 \
  -p 16379:16379 \
  -p 15432:15432 \
  -v $(pwd)/src:/app/src \
  -v $(pwd)/projects:/app/projects \
  -v $(pwd)/workspace:/app/workspace \
  -v $(pwd)/templates:/app/templates \
  -v $(pwd)/docs:/app/docs \
  -v nuget-cache:/root/.nuget/packages \
  -v dotnet-tools:/root/.dotnet/tools \
  -v cloudflare-secrets:/etc/cloudflared \
  -v ~/.gitconfig:/root/.gitconfig:ro \
  -v ~/.ssh:/root/.ssh:ro \
  --tty --stdin-open \
  devpersonalsite/dotnet9-devpersonal-site:latest

Entrar al contenedor:

bash
docker exec -it dotnet9-dev bash

Usar los comandos internos:

bash
show-dotnet-info
show-templates
create-dotnet-project MiAPI webapi
setup-sql-tunnel.sh

---

2. Uso Básico con Docker Compose

yaml
services:
  dotnet:
    image: devpersonalsite/dotnet9-devpersonal-site:latest
    container_name: dotnet9-dev
    ports:
      - "5000:5000"
      - "5001:5001"
      - "3000:3000"
    volumes:
      - ./src:/app/src
      - nuget-cache:/root/.nuget/packages
    tty: true
    stdin_open: true

volumes:
  nuget-cache:

---

📦 Contenido del Contenedor

Paquetes del Sistema

• curl, wget, git, vim, nano
• unzip, zip, tree, htop, jq
• inotify-tools (para watch de archivos)
• ca-certificates, gnupg

Entorno de Desarrollo

• Directorio de trabajo: /app
• Carpetas de proyectos: /app/src, /app/projects, /app/workspace
• Cache NuGet: /root/.nuget/packages
• Herramientas Globales: /root/.dotnet/tools

---

🎯 Comandos Personalizados

---

🔌 Puertos Expuestos

---

💾 Volúmenes Recomendados

bash
# Código fuente persistente
-v ./src:/app/src

# Cache de paquetes NuGet (construcciones más rápidas)
-v nuget-cache:/root/.nuget/packages

# Mantener herramientas globales
-v dotnet-tools:/root/.dotnet/tools

# Configuración de Git
-v ~/.gitconfig:/root/.gitconfig:ro
-v ~/.ssh:/root/.ssh:ro

---

🛡️ Túnel Cloudflare para SQL Server

Conexiones seguras a SQL Server mediante Cloudflare Zero Trust:

bash
# Primera ejecución pedirá credenciales del Service Token
# Las siguientes cargas usan /app/.env.sql automáticamente

# Dentro del contenedor
setup-sql-tunnel.sh

# Conectar la app a: localhost,11433

---

📚 Flujos de Trabajo Comunes

Crear y ejecutar un Web API

bash
docker exec -it dotnet9-dev bash
cd /app/src
create-dotnet-project MyAPI webapi
cd MyAPI
dotnet run

Crear una app de consola con auto-reload

bash
docker exec -it dotnet9-dev bash
cd /app/src
create-dotnet-project MyConsole console
cd MyConsole
dotnet watch run

Agregar Entity Framework

bash
cd /app/src/MyAPI
dotnet add package Microsoft.EntityFrameworkCore.SqlServer
dotnet ef migrations add InitialCreate
dotnet ef database update

---

🏷️ Tags Disponibles

---

📄 Licencia

MIT License - uso libre personal y comercial

---

🤝 Contribuciones

Se aceptan PRs y reportes de issues en GitHub

---

💬 Soporte

• GitHub Issues:https://github.com/devpersonalsite/

---

---

Construido con ❤️ para desarrolladores .NET Última actualización: diciembre 2025

---