# Diarkis サーバー

## 概要

Diarkis サーバー SDK は Go 言語（Golang）で開発されています。Go の強力な並列処理とネットワークスタックを最大限に活用しており、プロダクション環境において高いスケーラビリティと低レイテンシな通信を実現します。

Diarkis クラスターを構築・稼働させるためには、クラウドサービスの選定に加え、アプリケーションの要件（同時接続数、通信頻度など）に合わせたカスタマイズが必要です。

#### クラスターを構成するサーバータイプ

Diarkis クラスターは、主に以下の 4 種類の役割を持つサーバーで構成されます。

<table><thead><tr><th width="163">サーバー</th><th>説明</th></tr></thead><tbody><tr><td><strong>MARS</strong><a href="#references"><sup>[1]</sup></a></td><td>クラスター内の全ノードの状態管理</td></tr><tr><td><strong>HTTP</strong></td><td>認証連携や接続先エンドポイント（UDP/TCP）</td></tr><tr><td><strong>UDP/RUDP</strong></td><td>UDP または Reliable UDP を使用したリアルタイム通信</td></tr><tr><td><strong>TCP</strong></td><td>TCP を使用したリアルタイム通信を処理</td></tr></tbody></table>

また、以下の図は、Diarkis の基本的なアーキテクチャ構成のシンプルな例を示しています。

### Diarkis アーキテクチャ構成図の例

{% @mermaid/diagram content="architecture-beta
group Clients(internet)\[Clients]
service tcp\_cli(internet)\[Client Devices] in Clients
service udp\_cli(internet)\[Client Devices] in Clients

```
group Kubernetes(cloud)[Kubernetes]
    service lb(server)[Load Balancer] in Kubernetes

    group Diarkis(cloud)[Diarkis] in Kubernetes
        service udp(server)[UDP Servers] in Diarkis
        service http(server)[HTTP Servers] in Diarkis
        service tcp(server)[TCP Servers] in Diarkis
        service mars(server)[MARS] in Diarkis

group External(cloud)[external]
    service api(database)[API Servers] in External

lb:R -- L:http
lb:B -- T:api

tcp_cli:L -- R:tcp
udp_cli:L -- R:udp

%% tcp_cli:B -- R:api
%% udp_cli:B -- R:api

%% Internal cluster routing
udp:B -- T:http
http:B -- T:tcp" %}
```

これらのサーバー構成は [Diarkis サーバーテンプレート](https://help.diarkis.io/getting-started/diarkis-server-template)を利用することで簡単に始めることができます。

### ユーザーの接続フロー

Diarkis と通信するための接続を確立するには、HTTP API を介して接続エンドポイントとその他の必要なデータをクラスタから取得する必要があります。

以下の図は、ユーザーが Diarkis サーバークラスターとの接続を開始する際のフローを示しています。

{% @mermaid/diagram content="
sequenceDiagram
participant Client as Client Device
participant App as Application Server
box Cloud/Infrastructure
participant LB as Load Balancer
end
box "Diarkis Cluster"
participant D\_HTTP as Diarkis HTTP
participant D\_Net as Diarkis UDP/TCP
end

```
Note over Client, App: User Authentication
Client->>App: Authenticate
App->>LB: Endpoint Request
LB->>D_HTTP: Route Request
D_HTTP->>D_HTTP: User Creation
D_HTTP-->>LB: Return UDP/TCP Endpoint
LB-->>App: Return UDP/TCP Endpoint
App-->>Client: Return UDP/TCP Endpoint

Note over Client, D_Net: Direct Connection
Client->>D_Net: UDP/TCP Direct Connection" %}
```

***

#### References

* \[1]: プロダクション環境では、**MARS** がダウンした場合に備え、クラスター内の他のノードがその役割を継承する自動選出（Election）アルゴリズムが組み込まれています。