Dapr-Actor構建塊

chaney1992發表於2021-11-21

前言：

　前篇-繫結文章對Dapr的繫結構建塊進行了解，本篇繼續對 Actor 構建塊進行了解學習。

一、Actor簡介：

　Actors 為最低階別的“計算單元”。換句話說，您將程式碼寫入獨立單元 ( 稱為actor) ，該單元接收訊息並一次處理訊息，而不進行任何型別的並行或執行緒處理。

　當程式碼處理一條訊息時，它可以向其他參與者傳送一條或多條訊息，或者建立新的 Actors。底層執行時將管理每個 actor 的執行方式，時機和位置，並在 Actors 之間傳遞訊息。

　大量 Actors 可以同時執行，而 Actors 可以相互獨立執行。

　Dapr 包含專門實現 virtual actors 模式的執行時。通過 Dapr 的實現，您可以根據 Actors 模型編寫 Dapr Actor，而 Dapr 利用底層平臺提供的可擴充套件性和可靠性保證。

　應用場景：

您的問題空間涉及大量(數千或更多) 的獨立和孤立的小單位和邏輯。
您想要處理單執行緒物件，這些物件不需要外部元件的大量互動，例如在一組 Actors 之間查詢狀態。
您的 actor 例項不會通過發出I/O操作來阻塞呼叫方。

　生命週期：

　　Dapr Actors 是虛擬的，意思是他們的生命週期與他們的 in - memory 表現不相關。因此，它們不需要顯式建立或銷燬。 Dapr Actors 執行時在第一次接收到該 actor ID 的請求時自動啟用 actor。如果 actor 在一段時間內未被使用，那麼 Dapr Actors 執行時將回收記憶體物件。如果以後需要重新啟動，它還將保持對 actor 的一切原有資料。

　　呼叫 actor 方法和 reminders 將重置空閒時間，例如，reminders 觸發將使 actor 保持活動狀態。不論 actor 是否處於活動狀態或不活動狀態 Actor reminders 都會觸發，對不活動 actor ，那麼會首先啟用 actor。 Actor timers 不會重置空閒時間，因此 timer 觸發不會使參與者保持活動狀態。 Timer 僅在 actor 活躍時被觸發。

　　空閒超時和掃描時間間隔 Dapr 執行時用於檢視是否可以對 actor 進行垃圾收集。當 Dapr 執行時呼叫 actor 服務以獲取受支援的 actor 型別時，可以傳遞此資訊。

　　Virtual actors 生命週期抽象會將一些警告作為 virtual actors 模型的結果，而事實上， Dapr Actors 實施有時會偏離此模型。

　　在第一次將訊息傳送到其 actor 標識時，將自動啟用 actor ( 導致構造 actor 物件) 。在一段時間後，actor 物件將被垃圾回收。以後，再次使用 actor ID 訪問，將構造新的 actor。 Actor 的狀態比物件的生命週期更久，因為狀態儲存在 Dapr 執行時的配置狀態提供程式中（也就是說Actor即使不在活躍狀態，仍然可以讀取它的狀態）。

二、工作原理：

　Dapr Sidecar 提供了用於呼叫執行元件的 HTTP/gRPC API。這是 HTTP API 的URL格式：　

http://localhost:<daprPort>/v1.0/actors/<actorType>/<actorId>/

<daprPort>： Dapr 偵聽的 HTTP 埠。
<actorType>：執行元件型別。
<actorId>：要呼叫的特定參與者的 ID。

　a）Actor元件放置服務流程：

啟動時，Sidecar 呼叫執行元件服務以獲取註冊的執行元件型別和執行元件的配置設定。
Sidecar 將註冊的執行元件型別的列表傳送到放置服務。
放置服務會將更新的分割槽資訊廣播到所有執行元件服務例項。每個例項都將保留分割槽資訊的快取副本，並使用它來呼叫執行元件。

　b）呼叫Actor元件方法流程：

服務在Sidecar 上呼叫執行元件 API。請求正文中的 JSON 有效負載包含要傳送到執行元件的資料。
Sidecar 使用位置服務中的本地快取的分割槽資訊來確定哪個執行元件服務例項 (分割槽) 負責託管 ID 為的執行元件 3 。在此示例中，它是 pod 2 中的服務例項。呼叫將轉發到相應的Sidecar 。
Pod 2 中的Sidecar 例項呼叫服務例項以呼叫執行元件。服務例項啟用actor（如果它還沒有啟用）並執行actor 方法。

三、Actor timers(定時器) 和 reminders(提醒)

　可以使用計時器和提醒來計劃自身的呼叫。這兩個概念都支援配置截止時間。不同之處在於回撥註冊的生存期：

只要啟用執行元件，計時器就會保持活動狀態。計時器不會重置空閒計時器，因此它們不能使執行元件處於活動狀態。
提醒長於執行元件啟用。如果停用了某個執行元件，則會重新啟用該執行元件。提醒將重置空閒計時器。

　1、Timers定時器：

　　Dapr Actor 執行時確保回撥方法被順序呼叫，而非併發呼叫。這意味著，在此回撥完成執行之前，不會有其他Actor方法或timer/remider回撥被執行。

　　Timer的下一個週期在回撥完成執行後開始計算。這意味著 timer 在回撥執行時停止，並在回撥完成時啟動。

　　Dapr Actor 執行時在回撥完成時儲存對actor的狀態所作的更改。如果在儲存狀態時發生錯誤，那麼將取消啟用該actor物件，並且將啟用新例項。

　　當actor作為垃圾回收(GC)的一部分被停用時，所有 timer 都會停止。在此之後，將不會再呼叫 timer 的回撥。此外， Dapr Actors 執行時不會保留有關在失活之前執行的 timer 的任何資訊。也就是說，重新啟動 actor 後將會啟用的 timer 完全取決於註冊時登記的 timer。

　　a) 建立定時器：

POST/PUT http://localhost:3500/v1.0/actors/<actorType>/<actorId>/timers/<name>

　　Timer 的 duetime 和回撥函式可以在請求主體中指定。到期時間（due time）表示註冊後 timer 將首次觸發的時間。 period 表示timer在此之後觸發的頻率。到期時間為0表示立即執行。負 due times 和負 periods 都是無效。

　　以下請求體配置了一個 timer, dueTime 9秒, period 3秒。這意味著它將在9秒後首次觸發，然後每3秒觸發一次。

{
  "dueTime":"0h0m9s0ms",
  "period":"0h0m3s0ms"
}

　　b) 刪除定時器：

DELETE http://localhost:3500/v1.0/actors/<actorType>/<actorId>/timers/<name>

　2、Reminders 提醒：

　　Reminders 是一種在指定時間內觸發 persistent 回撥的機制。它們的功能類似於 timer。但與 timer 不同，在所有情況下 reminders 都會觸發，直到 actor 顯式取消註冊 reminders 或刪除 actor 。具體而言， reminders 會在所有 actor 失活和故障時也會觸發觸發，因為Dapr Actors 執行時會將 reminders 資訊持久化到 Dapr Actors 狀態提供者中。

　　a) 建立Reminders 　　

POST/PUT http://localhost:3500/v1.0/actors/<actorType>/<actorId>/reminders/<name>

　　Reminders 的 duetime 和回撥函式可以在請求主體中指定。到期時間（due time）表示註冊後 reminders將首次觸發的時間。 period 表示在此之後 reminders 將觸發的頻率。到期時間為0表示立即執行。負 due times 和負 periods 都是無效。若要註冊僅觸發一次的 reminders ，請將 period 設定為空字串。

　　以下請求體配置了一個 reminders, dueTime 9秒, period 3秒。這意味著它將在9秒後首次觸發，然後每3秒觸發一次。

{
  "dueTime":"0h0m9s0ms",
  "period":"0h0m3s0ms"
}

　　b) 獲取Reminders

GET http://localhost:3500/v1.0/actors/<actorType>/<actorId>/reminders/<name>

　　c) 刪除Reminders

DELETE http://localhost:3500/v1.0/actors/<actorType>/<actorId>/reminders/<name>

四、資料持久化：

　　使用 Dapr 狀態管理構建塊儲存執行元件狀態。由於執行元件可以一輪執行多個狀態操作，因此狀態儲存元件必須支援多項事務。

　　當前狀態管理元件支援事務/Actors支援情況：

Name	CRUD	事務	ETag	Actors	狀態	元件版本	自從
Aerospike	✅	❌	✅	❌	Alpha	v1	1.0
Apache Cassandra	✅	❌	❌	❌	Alpha	v1	1.0
Cloudstate	✅	❌	✅	❌	Alpha	v1	1.0
Couchbase	✅	❌	✅	❌	Alpha	v1	1.0
Hashicorp Consul	✅	❌	❌	❌	Alpha	v1	1.0
Hazelcast	✅	❌	❌	❌	Alpha	v1	1.0
Memcached	✅	❌	❌	❌	Alpha	v1	1.0
MongoDB	✅	✅	✅	✅	GA	v1	1.0
MySQL	✅	✅	✅	✅	Alpha	v1	1.0
PostgreSQL	✅	✅	✅	✅	Alpha	v1	1.0
Redis	✅	✅	✅	✅	GA	v1	1.0
RethinkDB	✅	✅	✅	✅	Alpha	v1	1.0
Zookeeper	✅	❌	✅	❌	Alpha	v1	1.0

　需要支援Actor狀態儲存需新增以下內容：

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: statestore
spec:
  type: state.redis
  version: v1
  metadata:
  - name: redisHost
    value: localhost:6379
  - name: redisPassword
    value: ""
  - name: actorStateStore
    value: "true"

五、.NET Core 例項：

　1、新增nuget包引用：Dapr.Actors和Dapr.Actors.AspNetCore。

　 2、定義IOrderStatusActor介面，需要繼承自IActor

public interface IOrderStatusActor : IActor
{
    Task<string> Paid(string orderId);
    Task<string> GetStatus(string orderId);
}

　　執行元件方法的返回型別必須為 Task 或 Task<T> 。此外，執行元件方法最多隻能有一個引數。返回型別和引數都必須可 System.Text.Json 序列化。

　3、定義OrderStatusActor實現IOrderStatusActor，並繼承自Actor

public class OrderStatusActor : Actor, IOrderStatusActor
{
    public OrderStatusActor(ActorHost host) : base(host)
    {
    }
    public async Task<string> Paid(string orderId)
    {
        // change order status to paid
        await StateManager.AddOrUpdateStateAsync(orderId, "init", (key, currentStatus) => "paid");
        return orderId;
    }
    public async Task<string> GetStatus(string orderId)
    {
        return await StateManager.GetStateAsync<string>(orderId);
    }
}

　4、修改Statup.cs檔案

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers();
    //註冊Actor
    services.AddActors(option =>
    {
        option.Actors.RegisterActor<OrderStatusActor>();
    });
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
    app.UseRouting();
    app.UseAuthorization();
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
        //
        endpoints.MapActorsHandlers();
    });
}

　5、新增ActorController操作Actor

[Route("api/[controller]")]
[ApiController]
public class ActorController : ControllerBase
{
    private readonly IActorProxyFactory _actorProxyFactory;

    public ActorController(IActorProxyFactory actorProxyFactory)
    {
        _actorProxyFactory = actorProxyFactory;
    }

    /// <summary>
    /// 方式一：ActorProxy.Create方式
    /// </summary>
    /// <param name="orderId"></param>
    /// <returns></returns>
    [HttpGet("paid/{orderId}")]
    public async Task<ActionResult> PaidAsync(string orderId)
    {
        var actorId = new ActorId("myid-" + orderId);
        var proxy = ActorProxy.Create<IOrderStatusActor>(actorId, "OrderStatusActor");
        var result = await proxy.Paid(orderId);
        return Ok(result);
    }

    /// <summary>
    /// 方式二：依賴注入方式
    /// </summary>
    /// <param name="orderId"></param>
    /// <returns></returns>
    [HttpGet("get/{orderId}")]
    public async Task<ActionResult> GetAsync(string orderId)
    {
        var proxy = _actorProxyFactory.CreateActorProxy<IOrderStatusActor>(
            new ActorId("myid-" + orderId), "OrderStatusActor");

        return Ok(await proxy.GetStatus(orderId));
    }
}

　6、Timer應用：使用Actor基類的 RegisterTimerAsync 方法註冊計時器：在OrderStatusActor類中新增方法

#region Timer操作

/// <summary>
/// 啟動Timer定時器
/// </summary>
/// <param name="name">定時器名稱</param>
/// <param name="text">定時器引數</param>
/// <returns></returns>
public Task StartTimerAsync(string name, string text)
{
    //註冊立即執行的間隔3s執行的定時器
    return RegisterTimerAsync(
        name,
        nameof(TimerCallbackAsync),
        Encoding.UTF8.GetBytes(text),
        TimeSpan.Zero,
        TimeSpan.FromSeconds(3));
}

/// <summary>
/// 定時器回撥
/// </summary>
/// <param name="state"></param>
/// <returns></returns>
public Task TimerCallbackAsync(byte[] state)
{
    var text = Encoding.UTF8.GetString(state);

    Console.WriteLine($"Timer fired: {text}");

    return Task.CompletedTask;

}

/// <summary>
/// 停止定時器
/// </summary>
/// <param name="name"></param>
/// <returns></returns>
public Task StopTimerAsync(string name)
{
    //停止計時器 UnregisterTimerAsync
    return UnregisterTimerAsync(name);
}

#endregion

　7、Reminder操作：使用Actor基類的 RegisterReminderAsync 方法計劃計時器。在OrderStatusActor類中新增方法

#region Reminder 操作

public Task SetReminderAsync(string text)
{
    return RegisterReminderAsync(
        "test-reminder",
        Encoding.UTF8.GetBytes(text),
        TimeSpan.Zero,
        TimeSpan.FromSeconds(1));
}

/// <summary>
/// Reminder觸發處理（實現IRemindable介面處理觸發）
/// </summary>
/// <param name="reminderName"></param>
/// <param name="state"></param>
/// <param name="dueTime"></param>
/// <param name="period"></param>
/// <returns></returns>
public Task ReceiveReminderAsync(string reminderName, byte[] state, TimeSpan dueTime, TimeSpan period)
{
    if (reminderName == "test-reminder")
    {
        var text = Encoding.UTF8.GetString(state);
        Console.WriteLine($"reminder fired: {text}");
    }
    return Task.CompletedTask;
}
#endregion

　8、啟動定時器：

public class OrderStatusActor : Actor, IOrderStatusActor, IRemindable
{
    public OrderStatusActor(ActorHost host) : base(host)
    {
        //註冊Timer
        StartTimerAsync("test-timer", "this is a test timer").ConfigureAwait(false).GetAwaiter().GetResult();

        //設定Reminder
        SetReminderAsync("this is a test reminder").ConfigureAwait(false).GetAwaiter().GetResult();
    }
    //其他處理邏輯    
}

總結：

　Dapr 執行元件構建基塊可以更輕鬆地編寫正確的併發系統。執行元件是狀態和邏輯的小單元。它們使用基於輪次的訪問模型，無需使用鎖定機制編寫執行緒安全程式碼。執行元件是隱式建立的，在未執行任何操作時以無提示方式從記憶體中解除安裝。重新啟用執行元件時，自動持久儲存並載入執行元件中儲存的任何狀態。執行元件模型實現通常是為特定語言或平臺建立的。但是，藉助 Dapr 執行元件構建基塊，可以從任何語言或平臺利用執行元件模型。

　Actor元件支援計時器和提醒來計劃將來的工作。計時器不會重置空閒計時器，並且允許執行元件在未執行其他操作時停用。提醒會重置空閒計時器，並且也會自動保留。計時器和提醒都遵守基於輪次的訪問模型，確保在處理計時器/提醒事件時無法執行任何其他操作。

　使用 Dapr 狀態管理構建基塊持久儲存執行元件狀態。支援多項事務的任何狀態儲存都可用於儲存執行元件狀態。

Dapr Workflow構建塊的.NET Demo
2023-02-18
Java中靜態程式碼塊、構造程式碼塊、建構函式、普通程式碼塊
2020-09-26
Java函式
構建 EOS 區塊鏈瀏覽器
2018-07-15
區塊鏈瀏覽器
構建 EOS 區塊鏈瀏覽器 API
2019-02-13
區塊鏈瀏覽器API
初識區塊鏈 - 用JS構建你自己的區塊鏈
2018-12-04
區塊鏈JS
區塊鏈構建資料可信流通體系
2023-04-19
區塊鏈
區塊鏈將構建完美的契約世界
2018-09-14
區塊鏈
用Go構建區塊鏈——6.交易2
2018-06-26
Go區塊鏈
谷歌要構建自己的區塊鏈技術
2018-03-25
谷歌區塊鏈
static程式碼塊、構造程式碼塊、建構函式以及Java類初始化順序
2018-11-07
C程式函式Java
使用 Swift 和 Vapor 構建區塊鏈伺服器
2019-03-04
SwiftVapor區塊鏈伺服器
用 Python 構建一個極小的區塊鏈
2018-03-17
Python區塊鏈
FISCO BCOS | 構建第一個區塊鏈應用程式
2023-10-12
區塊鏈
61行程式碼構建最簡單區塊鏈
2022-07-19
行程區塊鏈
[譯] 教你如何用 Flutter 的 GestureDetector 構建自定義滑塊
2018-07-09
Flutter
想學習區塊鏈？那就用 Python 構建一個
2018-07-30
區塊鏈Python
基於Java語言構建區塊鏈（四）—— 交易（UTXO）
2018-03-22
Java區塊鏈
嬰兒的出生為你解惑建構函式和構造程式碼塊
2019-04-05
函式
Java中建構函式、靜態程式碼塊、程式碼塊的執行順序
2022-11-12
Java函式
區塊鏈之--2小時構建以太坊智慧合約
2020-04-04
區塊鏈
在Go中構建區塊鏈第5部分：地址
2019-02-19
Go區塊鏈
基於Java語言構建區塊鏈（六）—— 交易（Merkle Tree）
2018-04-16
Java區塊鏈
基於Java語言構建區塊鏈（五）—— 地址（錢包）
2018-03-25
Java區塊鏈
基於Java語言構建區塊鏈（一）—— 基本原型
2018-03-22
Java區塊鏈原型
static變數，static程式碼塊，建構函式，程式碼塊等的載入順序
2018-11-15
變數C程式函式
在Go中構建區塊鏈第6部分：交易2
2019-02-22
Go區塊鏈
在Go中構建區塊鏈第7部分：網路
2019-02-26
Go區塊鏈
使用Go構建區塊鏈第1部分：基本原型
2019-01-21
Go區塊鏈原型
在Go中構建區塊鏈第4部分：交易1
2019-02-17
Go區塊鏈
使用Go構建區塊鏈第3部分：持久化和cli
2019-01-27
Go區塊鏈持久化
Python 從零開始構建自己的比特幣區塊鏈系統
2019-03-03
Python比特幣區塊鏈
基於Java語言構建區塊鏈（二）—— 工作量證明
2018-03-22
Java區塊鏈
使用Go構建區塊鏈第2部分：工作量證明
2019-01-23
Go區塊鏈
利用IPFS構建短視訊區塊鏈應用開發經歷（十）
2019-01-29
區塊鏈
構建之法
2024-11-27
docker構建
2024-08-20
Docker
AOSP構建
2024-05-24
構建框架
2018-03-14
框架

Dapr-Actor構建塊

前言：

一、Actor簡介：

應用場景：

生命週期：

二、工作原理：

三、Actor timers(定時器) 和 reminders(提醒)

四、資料持久化：

五、.NET Core 例項：

總結：

相關文章

　應用場景：

　生命週期：