Hosting de una API .NET en Fly.io — Paso a Paso

# Listar todas las regiones disponibles
fly platform regions

dotnet new webapi -n MyApi --use-controllers
cd MyApi

var builder = WebApplication.CreateBuilder(args);
 
// Fly.io establece PORT en tiempo de ejecución; fallback a 8080 para desarrollo local
var port = Environment.GetEnvironmentVariable("PORT") ?? "8080";
builder.WebHost.UseUrls($"http://0.0.0.0:{port}");
 
builder.Services.AddControllers();
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
 
var app = builder.Build();
 
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}
 
app.UseAuthorization();
app.MapControllers();
app.Run();

# syntax=docker/dockerfile:1
 
# ── Etapa de build ───────────────────────────────────────────────────────────
FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
WORKDIR /src
 
# Copiar el archivo de proyecto primero para que la caché de Docker sobreviva cambios de código fuente
COPY MyApi.csproj ./
RUN dotnet restore
 
COPY . .
RUN dotnet publish -c Release -o /app/publish \
    --no-restore \
    /p:UseAppHost=false
 
# ── Etapa de runtime ─────────────────────────────────────────────────────────
FROM mcr.microsoft.com/dotnet/aspnet:10.0 AS runtime
WORKDIR /app
 
# Crear un usuario no-root; las micro VMs de Fly.io aíslan a nivel VM,
# pero ejecutar como no-root es defensa en profundidad
RUN addgroup --system appgroup && adduser --system --ingroup appgroup appuser
 
COPY --from=build /app/publish .
 
# Cambiar a usuario no-root antes del CMD final
USER appuser
 
ENV ASPNETCORE_ENVIRONMENT=Production
EXPOSE 8080
 
ENTRYPOINT ["dotnet", "MyApi.dll"]

docker build -t myapi:local .
docker run --rm -p 8080:8080 -e ASPNETCORE_ENVIRONMENT=Development myapi:local

# macOS / Linux
curl -L https://fly.io/install.sh | sh
 
# Windows (PowerShell)
iwr https://fly.io/install.ps1 -useb | iex
 
# Homebrew
brew install flyctl

fly auth login

fly launch

# El nombre de la app debe coincidir con lo que creaste con fly launch
app = "myapi-prod"
 
# Fly.io construye desde el Dockerfile en el directorio actual por defecto
[build]
  dockerfile = "Dockerfile"
 
# Región primaria — donde vive la primera instancia
primary_region = "iad"
 
# Variables de entorno que NO son secretos
# Los secretos (cadenas de conexión, API keys) van en fly secrets, no aquí
[env]
  ASPNETCORE_ENVIRONMENT = "Production"
  DOTNET_SYSTEM_GLOBALIZATION_INVARIANT = "false"
 
# Configuración del servicio HTTP; Fly.io termina TLS en el edge y reenvía HTTP
[http_service]
  internal_port = 8080          # Debe coincidir con EXPOSE en tu Dockerfile
  force_https = true            # Redirigir HTTP → HTTPS automáticamente
  auto_stop_machines = true     # Detener máquinas inactivas para ahorrar costos
  auto_start_machines = true    # Iniciar una máquina cuando llega una solicitud
  min_machines_running = 0      # 0 = scale-to-zero completo; 1 = siempre activo
 
  [http_service.concurrency]
    type = "requests"
    hard_limit = 250
    soft_limit = 200
 
[[vm]]
  cpu_kind = "shared"
  cpus = 1
  memory_mb = 256

// Health check mínimo — sin dependencias, solo confirma que el proceso está vivo
app.MapGet("/health", () => Results.Ok(new { status = "healthy", timestamp = DateTime.UtcNow }))
   .WithName("HealthCheck")
   .AllowAnonymous();

[http_service]
  internal_port = 8080
  force_https = true
 
  [[http_service.checks]]
    grace_period = "10s"   # Tiempo de espera antes del primer check después del inicio
    interval = "15s"
    method = "GET"
    path = "/health"
    timeout = "5s"

# El ciclo estándar de despliegue
fly deploy
 
# Observar el progreso del despliegue
fly status --watch
 
# Seguir logs después del despliegue
fly logs

# Establecer un secreto (encriptado en reposo, inyectado como variable de entorno en runtime)
fly secrets set DATABASE_URL="postgresql://user:pass@hostname/db"
 
# Establecer varios a la vez
fly secrets set \
  JWT_SECRET="tu-secreto-jwt-aqui" \
  SENDGRID_API_KEY="SG.xxxx"
 
# Listar nombres de secretos (los valores nunca se muestran)
fly secrets list
 
# Eliminar un secreto
fly secrets unset SENDGRID_API_KEY

// appsettings.json tiene la clave; el valor es sobreescrito por la variable de entorno en runtime
builder.Services.AddDbContext<AppDbContext>(options =>
    options.UseNpgsql(
        // Variable de entorno DATABASE_URL establecida via fly secrets
        builder.Configuration.GetConnectionString("Default")
        ?? Environment.GetEnvironmentVariable("DATABASE_URL")
        ?? throw new InvalidOperationException("DATABASE_URL no está configurado")
    )
);

# Crea un clúster Postgres HA de 2 nodos llamado "myapi-db" en la región iad
fly postgres create \
  --name myapi-db \
  --region iad \
  --vm-size shared-cpu-1x \
  --volume-size 10
 
# La salida incluye la cadena de conexión — guárdala, no se mostrará de nuevo
# postgres://myapi_db:CONTRASEÑA@myapi-db.flycast:5432/myapi_db

# Adjunta el clúster Postgres a tu app y establece DATABASE_URL automáticamente
fly postgres attach --app myapi-prod myapi-db

fly secrets list
# NOMBRE        DIGEST    CREADO EN
# DATABASE_URL  abc123    2025-02-21T10:00:00Z

// Parsear DATABASE_URL del formato de Fly.io: postgres://user:pass@host:port/db
var rawUrl = builder.Configuration["DATABASE_URL"]
    ?? Environment.GetEnvironmentVariable("DATABASE_URL");
 
if (!string.IsNullOrEmpty(rawUrl))
{
    var uri = new Uri(rawUrl);
    var userInfo = uri.UserInfo.Split(':');
    var connectionString = new NpgsqlConnectionStringBuilder
    {
        Host = uri.Host,
        Port = uri.Port == -1 ? 5432 : uri.Port,
        Database = uri.AbsolutePath.TrimStart('/'),
        Username = userInfo[0],
        Password = userInfo.Length > 1 ? userInfo[1] : null,
        SslMode = SslMode.Prefer,    // La red interna de Fly ya está encriptada via WireGuard
    }.ToString();
 
    builder.Services.AddDbContext<AppDbContext>(options =>
        options.UseNpgsql(connectionString));
}

[deploy]
  release_command = "dotnet MyApi.dll migrate"

// Verificar args de CLI antes de construir la app completa
if (args.Contains("migrate"))
{
    // Construir un host mínimo solo para migración
    var host = Host.CreateDefaultBuilder(args)
        .ConfigureServices((ctx, services) =>
        {
            services.AddDbContext<AppDbContext>(options =>
                options.UseNpgsql(ctx.Configuration["DATABASE_URL"]));
        })
        .Build();
 
    using var scope = host.Services.CreateScope();
    var db = scope.ServiceProvider.GetRequiredService<AppDbContext>();
    await db.Database.MigrateAsync();
    Console.WriteLine("Migraciones aplicadas exitosamente.");
    return;
}
 
// El inicio normal de la app continúa abajo...

# Ejecutar 3 máquinas en la región primaria (iad)
fly scale count 3
 
# Verificar
fly status

# Agregar máquinas en Frankfurt y Tokio
fly scale count 1 --region fra
fly scale count 1 --region nrt
 
# Verificar la distribución
fly status

# Mantener al menos una máquina en cada región en todo momento
[[regions]]
  code = "iad"
  count = 2
 
[[regions]]
  code = "lhr"
  count = 1

# Agregar un dominio personalizado (debes ser propietario)
fly certs add api.tudominio.com
 
# Verificar estado del certificado
fly certs show api.tudominio.com

Tipo  Host                    Valor
A     api.tudominio.com       66.241.124.x
AAAA  api.tudominio.com       2a09:8280:1::...

[http_service]
  auto_stop_machines = true
  auto_start_machines = true
  min_machines_running = 1   # Mantener siempre una máquina caliente

<!-- MyApi.csproj — habilita compilación Native AOT -->
<PropertyGroup>
  <PublishAot>true</PublishAot>
  <InvariantGlobalization>true</InvariantGlobalization>
</PropertyGroup>

# 1. Instalar flyctl y autenticarse
curl -L https://fly.io/install.sh | sh
fly auth login
 
# 2. Crear la app (genera fly.toml)
fly launch --name myapi-prod --region iad --no-deploy
 
# 3. Establecer secretos de la aplicación
fly secrets set \
  JWT_SECRET="$(openssl rand -base64 32)" \
  ENVIRONMENT="Production"
 
# 4. Crear y adjuntar Postgres
fly postgres create --name myapi-db --region iad --vm-size shared-cpu-1x
fly postgres attach --app myapi-prod myapi-db
 
# 5. Desplegar
fly deploy
 
# 6. Verificar
fly status
fly logs
 
# 7. Abrir en el navegador
fly open