Orleans directorio de granos

Los granos tienen identidades lógicas estables. Pueden activarse (crearse una instancia) y desactivarse muchas veces durante la vida de la aplicación, pero en cualquier momento existe como mucho una activación de un grain. Cada vez que se activa un grano, puede colocarse en un silo diferente en el clúster. Cuando se activa un grano en el clúster, se registra en el directorio de granos. Esto garantiza que las invocaciones subsiguientes de ese grain se entreguen a esa activación e impide la creación de otras activaciones (instancias) de ese grain. El directorio de grains es responsable de mantener una asignación entre una identidad de grain y la ubicación (qué silo) de su activación actual.

Orleans proporciona varias implementaciones del directorio de grains:

Directorio Package Description
Distribuido en clúster (valor predeterminado) Integrado Eventualmente coherente, particionado entre silos mediante una tabla hash distribuida. Permite activaciones duplicadas ocasionales durante la inestabilidad del clúster.
Fuertemente Consistente en el Clúster Integrado Tabla hash distribuida con consistencia fuerte y bloqueos de rango por versiones. Evita las activaciones duplicadas, pero requiere más coordinación.
ADO.NET Microsoft.Orleans.GrainDirectory.AdoNet Directorio respaldado por base de datos que admite SQL Server, PostgreSQL, MySQL y Oracle.
Azure Table Storage (almacenamiento en tablas de Azure) Microsoft.Orleans.GrainDirectory.AzureStorage Directorio respaldado por Azure Table para ubicaciones persistentes de grains.
Redis Microsoft.Orleans.GrainDirectory.Redis Directorio respaldado por Redis para búsquedas persistentes de alto rendimiento.

De forma predeterminada, Orleans utiliza un directorio integrado distribuido dentro del clúster. Este directorio es finalmente coherente y particionado en todos los silos del clúster en forma de una tabla hash distribuida.

A partir de la versión 3.2.0, Orleans también admite implementaciones de directorios de grano conectables.

En la versión 3.2.0 se incluyen dos complementos de este tipo:

Puede configurar qué implementación de directorio de granos se va a usar por tipo de grano, e incluso puede inyectar su implementación.

Directorio de granos que se debe usar

Se recomienda comenzar siempre con el directorio predeterminado (el directorio integrado distribuido en clúster). Aunque es coherente con el tiempo y permite activaciones duplicadas ocasionales cuando el clúster es inestable, el directorio integrado es autoadministrable, no tiene dependencias externas, no requiere ninguna configuración y se ha usado correctamente en producción desde el principio.

Si tiene alguna experiencia con Orleans y tiene un caso de uso que requiere una garantía de activación única más fuerte, o si desea minimizar el número de granos desactivados cuando se cierra un silo, considere la posibilidad de usar una implementación de directorio de granos basada en almacenamiento, como la implementación de Redis. Pruebe a usarlo primero para uno o algunos tipos de granos, empezando por aquellos que son de larga duración, tengan un estado significativo o tengan un proceso de inicialización costoso.

Directorio fuertemente consistente en clúster

Importante

Esta característica está disponible a partir Orleans de la versión 10.0. Actualmente está en versión preliminar y puede cambiar en futuras versiones.

Orleans también proporciona un directorio de grano fuertemente coherente mediante una tabla hash distribuida con nodos virtuales (similar a Amazon Dynamo y Apache Cassandra). A diferencia del directorio predeterminado eventualmente consistente, esta implementación evita las activaciones duplicadas de grain incluso cuando hay inestabilidad en el clúster.

Características clave

  • Coherencia fuerte: utiliza bloqueos de rango versionados en los cambios de vista para garantizar la coherencia.
  • Nodos virtuales: cada silo administra 30 nodos virtuales (particiones) en el anillo hash para una mejor distribución
  • Recuperación automática: se recupera automáticamente cuando los silos fallan sin completar la transferencia
  • Operación en dos fases: funciona en fase normal y fase de cambio de vista para transiciones de pertenencia seguras

Configuración

Para usar el directorio fuertemente coherente, agréguelo explícitamente mediante AddDistributedGrainDirectory:

// Use as the default grain directory
builder.AddDistributedGrainDirectory();

// Or add as a named directory
builder.AddDistributedGrainDirectory("MyDistributedDirectory");

Cuándo usar

Use el directorio fuertemente consistente cuando necesite impedir las activaciones duplicadas de grains durante los cambios de pertenencia al clúster. El directorio predeterminado coherente con el tiempo es adecuado para la mayoría de los escenarios en los que se admiten activaciones duplicadas ocasionales.

Considere los directorios con respaldo de almacenamiento externo (Redis, Azure Table, ADO.NET) cuando:

  • Necesita que los registros de granos persistan en los reinicios completos del clúster.
  • Tiene clústeres muy grandes en los que el uso de memoria es un problema

directorio de granos de ADO.NET

El directorio de granos basado en ADO.NET almacena ubicaciones de granos en una base de datos relacional. Esto proporciona almacenamiento persistente de la ubicación de grano que sobrevive a los reinicios del clúster.

Bases de datos admitidas

  • SQL Server
  • PostgreSQL
  • MySQL/MariaDB
  • Oracle

Installation

Instale el paquete NuGet:

dotnet add package Microsoft.Orleans.GrainDirectory.AdoNet

Para SQL Server, instale también el Microsoft.Data.SqlClient paquete NuGet:

dotnet add package Microsoft.Data.SqlClient

Configuración

Configure el directorio de granos de ADO.NET como predeterminado o como un directorio nombrado.

// Use as the default grain directory
builder.UseAdoNetGrainDirectoryAsDefault(options =>
{
    options.Invariant = "Microsoft.Data.SqlClient"; // or "Npgsql", "MySql.Data.MySqlClient"
    options.ConnectionString = "Server=localhost;Database=Orleans;...";
});

// Or add as a named directory
builder.AddAdoNetGrainDirectory("MyAdoNetDirectory", options =>
{
    options.Invariant = "Npgsql";
    options.ConnectionString = "Host=localhost;Database=Orleans;...";
});

AdoNetGrainDirectoryOptions

Opción Tipo Description
Invariant string Obligatorio. Nombre invariable del proveedor ADO.NET (por ejemplo, Microsoft.Data.SqlClient, Npgsqlo MySql.Data.MySqlClient).
ConnectionString string Obligatorio. Cadena de conexión de base de datos. Este valor se redacta en los registros.

Configuración de la base de datos

Antes de usar el directorio de grain de ADO.NET, debe crear las tablas de base de datos requeridas. Ejecute el script SQL adecuado para la base de datos:

Configuración

De forma predeterminada, no es necesario hacer nada; Orleans usa automáticamente el directorio de granos dentro del clúster y lo particiona en todo el clúster. Si desea usar una configuración de directorio específico no predeterminada, debe especificar el nombre del complemento de directorio que se va a usar. Puede hacerlo a través de un atributo en la clase de grano y configurando el complemento de directorio con ese nombre mediante la inserción de dependencias durante la configuración del silo.

Configuración del grano

Especifique el nombre del plugin de directorio de grano usando GrainDirectoryAttribute:

[GrainDirectory(GrainDirectoryName = "my-grain-directory")]
public class MyGrain : Grain, IMyGrain
{
    // ...
}

Configuración del silo

Aquí se muestra cómo configurar la implementación del directorio de granos de Redis:

siloBuilder.AddRedisGrainDirectory(
    "my-grain-directory",
    options => options.ConfigurationOptions = redisConfiguration);

Configura el directorio de granos de Azure así:

siloBuilder.AddAzureTableGrainDirectory(
    "my-grain-directory",
    options => options.ConnectionString = azureConnectionString);

Puede configurar varios directorios con nombres diferentes para su uso con diferentes clases de grano:

siloBuilder
    .AddRedisGrainDirectory(
        "redis-directory-1",
        options => options.ConfigurationOptions = redisConfiguration1)
    .AddRedisGrainDirectory(
        "redis-directory-2",
        options => options.ConfigurationOptions = redisConfiguration2)
    .AddAzureTableGrainDirectory(
        "azure-directory",
        options => options.ConnectionString = azureConnectionString);