Hospedando uma API .NET no Fly.io — Passo a Passo

# Listar todas as regiões disponíveis
fly platform regions

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

var builder = WebApplication.CreateBuilder(args);
 
// Fly.io define PORT em tempo de execução; fallback para 8080 no desenvolvimento 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 o arquivo de projeto primeiro para que o cache do Docker sobreviva a mudanças de código-fonte
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
 
# Criar um usuário não-root; as micro VMs do Fly.io isolam no nível da VM,
# mas executar como não-root é defesa em profundidade
RUN addgroup --system appgroup && adduser --system --ingroup appgroup appuser
 
COPY --from=build /app/publish .
 
# Mudar para usuário não-root antes do 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

# O nome da app deve corresponder ao que você criou com fly launch
app = "myapi-prod"
 
# Fly.io constrói a partir do Dockerfile no diretório atual por padrão
[build]
  dockerfile = "Dockerfile"
 
# Região primária — onde a primeira instância vive
primary_region = "iad"
 
# Variáveis de ambiente que NÃO são segredos
# Segredos (strings de conexão, API keys) vão em fly secrets, não aqui
[env]
  ASPNETCORE_ENVIRONMENT = "Production"
  DOTNET_SYSTEM_GLOBALIZATION_INVARIANT = "false"
 
# Configuração do serviço HTTP; o Fly.io termina TLS na borda e encaminha HTTP
[http_service]
  internal_port = 8080          # Deve corresponder ao EXPOSE no seu Dockerfile
  force_https = true            # Redirecionar HTTP → HTTPS automaticamente
  auto_stop_machines = true     # Parar máquinas ociosas para economizar custos
  auto_start_machines = true    # Iniciar uma máquina quando uma requisição chega
  min_machines_running = 0      # 0 = scale-to-zero completo; 1 = sempre ativo
 
  [http_service.concurrency]
    type = "requests"
    hard_limit = 250
    soft_limit = 200
 
[[vm]]
  cpu_kind = "shared"
  cpus = 1
  memory_mb = 256

// Health check mínimo — sem dependências, apenas confirma que o processo 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"   # Tempo de espera antes do primeiro check após o início
    interval = "15s"
    method = "GET"
    path = "/health"
    timeout = "5s"

# O ciclo padrão de deploy
fly deploy
 
# Acompanhar o progresso do deploy
fly status --watch
 
# Acompanhar logs após o deploy
fly logs

# Definir um segredo (criptografado em repouso, injetado como variável de ambiente em runtime)
fly secrets set DATABASE_URL="postgresql://user:pass@hostname/db"
 
# Definir vários de uma vez
fly secrets set \
  JWT_SECRET="seu-segredo-jwt-aqui" \
  SENDGRID_API_KEY="SG.xxxx"
 
# Listar nomes de segredos (valores nunca são mostrados)
fly secrets list
 
# Remover um segredo
fly secrets unset SENDGRID_API_KEY

// appsettings.json tem a chave; o valor é sobrescrito pela variável de ambiente em runtime
builder.Services.AddDbContext<AppDbContext>(options =>
    options.UseNpgsql(
        // Variável de ambiente DATABASE_URL definida via fly secrets
        builder.Configuration.GetConnectionString("Default")
        ?? Environment.GetEnvironmentVariable("DATABASE_URL")
        ?? throw new InvalidOperationException("DATABASE_URL não está configurado")
    )
);

# Cria um cluster Postgres HA de 2 nós chamado "myapi-db" na região iad
fly postgres create \
  --name myapi-db \
  --region iad \
  --vm-size shared-cpu-1x \
  --volume-size 10
 
# A saída inclui a string de conexão — salve-a, não será mostrada novamente
# postgres://myapi_db:SENHA@myapi-db.flycast:5432/myapi_db

# Anexa o cluster Postgres à sua app e define DATABASE_URL automaticamente
fly postgres attach --app myapi-prod myapi-db

fly secrets list
# NOME          DIGEST    CRIADO EM
# DATABASE_URL  abc123    2025-02-21T10:00:00Z

// Parsear DATABASE_URL do formato do 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,    // A rede interna do Fly já é criptografada via WireGuard
    }.ToString();
 
    builder.Services.AddDbContext<AppDbContext>(options =>
        options.UseNpgsql(connectionString));
}

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

// Verificar args da CLI antes de construir a app completa
if (args.Contains("migrate"))
{
    // Construir um host mínimo apenas para migração
    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("Migrações aplicadas com sucesso.");
    return;
}
 
// Inicialização normal da app continua abaixo...

# Executar 3 máquinas na região primária (iad)
fly scale count 3
 
# Verificar
fly status

# Adicionar máquinas em Frankfurt e Tóquio
fly scale count 1 --region fra
fly scale count 1 --region nrt
 
# Verificar a distribuição
fly status

# Manter pelo menos uma máquina em cada região o tempo todo
[[regions]]
  code = "iad"
  count = 2
 
[[regions]]
  code = "lhr"
  count = 1

# Adicionar um domínio personalizado (você deve ser o proprietário)
fly certs add api.seudominio.com
 
# Verificar status do certificado
fly certs show api.seudominio.com

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

[http_service]
  auto_stop_machines = true
  auto_start_machines = true
  min_machines_running = 1   # Manter sempre uma máquina aquecida

<!-- MyApi.csproj — habilita compilação Native AOT -->
<PropertyGroup>
  <PublishAot>true</PublishAot>
  <InvariantGlobalization>true</InvariantGlobalization>
</PropertyGroup>

# 1. Instalar flyctl e autenticar
curl -L https://fly.io/install.sh | sh
fly auth login
 
# 2. Criar a app (gera fly.toml)
fly launch --name myapi-prod --region iad --no-deploy
 
# 3. Definir segredos da aplicação
fly secrets set \
  JWT_SECRET="$(openssl rand -base64 32)" \
  ENVIRONMENT="Production"
 
# 4. Criar e anexar Postgres
fly postgres create --name myapi-db --region iad --vm-size shared-cpu-1x
fly postgres attach --app myapi-prod myapi-db
 
# 5. Fazer deploy
fly deploy
 
# 6. Verificar
fly status
fly logs
 
# 7. Abrir no navegador
fly open