Solusoft.SQLSidecarSDK 1.1.1

SQL Sidecar SDK

Cliente de la herramienta sql-sidecar desarrollado en c sharp cuyo propósito es servir de apoyo en las tareas de actualizaciones de versiones de bases de datos SQl.

Source code

La implementación se realiza en C Sharp (Net Standard). El código fuente se encuentra en la carpeta src.

Puesta en marcha

Configuración

El servicio recibe una configuración de la siguiente forma:

SQLSidecarSettings

{
  "Host": "http://localhost:8080",
  "Version": "1.0.0",
  "Timeout": 300
}

Host: URL de acceso al API de sql-sidecar.
Version: Versión destino a la que se quiere migrar la base de datos.
Timeout: Timeout a utilizar en llamadas HTTP, en segundos.

Código

Startup.cs

public void ConfigureServices(IServiceCollection services)
{
  //...
  //Configuramos dependencias de SQL Sidecar SDK
  //configuración
  services.Configure<SQLSidecarSettings>(Configuration.GetSection("SQLSidecarSettings")); 
  //dependencia para update worker           
  services.AddSingleton<IUpdateWorker, UpdateWorker>();
  //dependencia para realizar los health checks
  services.AddSingleton<DbUpdateHealthCheck>();
  //servicio hospedado para la actualización de versiones
  services.AddHostedService<DatabaseUpdateHostedService>();

  //configuramos healthcheck
  services
      .AddHealthChecks()
      .AddCheck<DbUpdateHealthCheck>(
          "Update",
          tags: new[] { "ready" }
      );
  //...
}

public void Configure(IApplicationBuilder app, IHostingEnvironment env, IConfiguration configuration)
{
  //...
  //configuramos endpoints para healthcheck
  app.UseHealthChecks("/health/ready", new HealthCheckOptions()
  {
      Predicate = (check) => check.Tags.Contains("ready"),
  });
  //...
}

El servicio dispone de un health check que permite consultar el estado de la actualización. En el ejemplo mostrado se ha configurado un endpoint GET /health/ready que al consultarlo devuelve un código 503 hasta que el proceso de actualización se haya finalizado, momento a partir del cual devuelve un código 200.

Contributing & License

solusoft

Todos los derechos reservados. Consultar www.solusoft.es