スタートアップサービスの作成

Dingo

Dingoは、Go言語で書かれたCardanoブロックチェーンデータノードであり、Ouroboros Network Node-to-Nodeミニプロトコルファミリーを使用して、Cardanoブロックチェーン上のネットワーク通信に積極的に参加します。

⚠️ これは開発中のプロジェクトであり、現在活発に開発が進められています

このガイドでは、systemdサービスの設定方法について説明します。systemdサービスを使用してDingoノードを実行すると、コンピューターが再起動したときにDingoノードを自動的に再起動することで、稼働時間を最大化できます。以下の手順に従って始めましょう。

✅ このガイドは一般的なLinux環境を前提としています。必要に応じてコマンドとパスを調整してください。

ステップ1 - Dingoとdingo.yamlファイルの移動

ベストプラクティス: Dingoを起動するためにsystemdを使用するため、Dingoバイナリを/usr/local/bin/に、dingo.yamlを/etc/dingo/ディレクトリに移動します。以下を実行してください：

⚠️ 以下のパスを調整してください。パスはクイックスタートガイドとUSER=testに基づいています。

💡 ヒント: Dingoバイナリへのパスを見つけるには、Dingoバイナリディレクトリに移動し、realpath dingoコマンドを実行します。

sudo mv /home/test/dingo/dingo /usr/local/bin/

✅ which dingoを実行して、Dingoバイナリが移動されたことを確認できます

次に、/etc/dingo/ディレクトリを作成します：

sudo mkdir /etc/dingo/

その後、dingo.yamlファイルを/etc/dingo/に移動します：

sudo mv /home/test/dingo/dingo.yaml /etc/dingo/

ステップ2 - dingo.yamlファイルのパスを編集

次に、dingo.yamlファイルを編集して、yamlを/etc/dingo/に移動したため、以下のパスを更新します。

以下のパスを編集する必要があります：cardanoConfig:、databasePath:、socketPath:、topology:。

✅ ユーザー名とディレクトリに一致する正しいパスに必要に応じて調整してください。

# Example config file for dingo
# The values shown below correspond to the in-code defaults

# Public bind address for the Dingo server
bindAddr: "0.0.0.0"

# Path to the Cardano node configuration file
#
# Can be overridden with the config environment variable
cardanoConfig: "/home/test/dingo/config/cardano/preview/config.json"

# A directory which contains the ledger database files
databasePath: "/home/test/dingo/dingo"

# Path to the UNIX domain socket file used by the server
socketPath: "/home/test/dingo.socket"

# Name of the Cardano network
network: "preview"

# TLS certificate file path (for HTTPS)
#
# Can be overridden with the TLS_CERT_FILE_PATH environment variable
tlsCertFilePath: ""

# TLS key file path (for HTTPS)
#
# Can be overridden with the TLS_KEY_FILE_PATH environment variable
tlsKeyFilePath: ""

# Path to the topology configuration file for Cardano node
topology: "/home/test/dingo/config/cardano/preview/topology.json"

# TCP port to bind for Prometheus metrics endpoint
metricsPort: 12798

# Internal/private address to bind for listening for Ouroboros NtC
privateBindAddr: "127.0.0.1"

# TCP port to bind for listening for Ouroboros NtC
privatePort: 3002

# TCP port to bind for listening for Ouroboros NtN
#
# Can be overridden with the port environment variable
relayPort: 3001

# TCP port to bind for listening for UTxO RPC
utxorpcPort: 9090

# Ignore prior chain history and start from current tip (default: false)
# This is experimental and may break — use with caution
intersectTip: false

# Maximum cache size in bytes used by BadgerDB for block/index cache
# Default: 1073741824 (1 GB)
badgerCacheSize: 1073741824

# Maximum total size (in bytes) of all transactions allowed in the mempool.
# Transactions exceeding this limit will be rejected.
# Default: 1048576 (1 MB)
mempoolCapacity: 1048576

ステップ3 - dingo.serviceユニット設定ファイルの作成

次に、systemdによって実行されるdingo.serviceユニット設定ファイル（「サービス」ファイル）を作成します。

⚠️ 以下のUser=行を調整してください。クイックスタートガイドではユーザーtestを使用しました。これをあなたのユーザー名に調整してください。

💡 ヒント: echo $USERコマンドを実行してユーザー名を確認できます。

cat <<'ENDFILE' >> /tmp/dingo.service
[Unit]
Description=Dingo Node
After=network-online.target

[Service]
Type=simple
Restart=on-failure
RestartSec=10
User=test
ExecStart=/usr/local/bin/dingo
SyslogIdentifier=dingo
TimeoutStopSec=3

[Install]
WantedBy=multi-user.target
ENDFILE

ステップ4 - dingo.serviceの移動

dingo.serviceを/etc/systemd/system/に移動して、systemd経由で操作できるようにします：

sudo mv /tmp/dingo.service /etc/systemd/system/

ステップ5 - サービスの有効化と開始

次に、起動時にサービスが実行されるように有効化し、サービスを開始します：

sudo systemctl enable dingo.service

次に：

sudo systemctl start dingo.service

ステップ6 - ステータスの確認

以下を実行して、dingo.serviceがアクティブであることを確認できます：

sudo systemctl status dingo.service

エラーが発生した場合は、以下のコマンドを使用してエラーログを確認できます：

journalctl -u dingo.service