查看原文
其他

Mina Docs|区块生产者 Sidecar

为了维持各种赠款和基金会委托项目的资格,您必须使用守护进程运行一个 Sidecar 来报告节点正常运行时间。


如果一个授权或特定的程序要求您保持节点在线,您必须运行一个小的 Sidecar 程序,它将报告守护进程的正常运行时间。本教程将带领您完成 Sidecar 程序的安装、配置和运行过程。



安装


Sidecar 是一个可以单独安装在 Debian/Ubuntu 上的包,也可以与 Docker 解决方案一起运行。


Debian / Ubuntu


sudo apt-get install -y mina-bp-stats-sidecar=1.1.6-386c5ac

这将安装以下文件:

  1. /usr/local/bin/mina-bp-stats-sidecar  (mina Sidecar 程序)

  2. /etc/mina-sidecar.json (mina Sidecar 的配置文件)

  3. /etc/systemd/system/mina-bp-stats-sidecar.service (systemd 配置将其作为服务运行)

我们将需要用正确的参数更新配置文件。因此,请使用您喜欢的编辑器来替换 /etc/mina-sidecar.json 中如下内容:

{  "uploadURL": "https://us-central1-mina-mainnet-303900.cloudfunctions.net/block-producer-stats-ingest/?token=72941420a9595e1f4006e2f3565881b5",  "nodeURL": "http://127.0.0.1:3095"}


Docker


如果您正在使用 Docker,您可以拉取我们将在下一节中运行的最新映像。

docker pull minaprotocol/mina-bp-stats-sidecar:latest

接下来,我们将需要设置配置文件,在本教程中,我们将假设您使用的是 Linux 系统。


我们需要创建一个带有正确参数的配置文件。因此,请替换 ~/mina-sidecar-config.json 中如下内容:

{  "uploadURL": "https://us-central1-mina-mainnet-303900.cloudfunctions.net/block-producer-stats-ingest/?token=72941420a9595e1f4006e2f3565881b5",  "nodeURL": "http://mina:3095"}

我们将在下一步中把这个文件传递到 Docker 容器中。



使用


这个 Sidecar 将需要与正在运行的守护进程进行交互,所以您首先需要启动守护进程。您将需要使用 --limited-graphql-port 3095 参数去运行守护进程,以便 Sidecar 能够与守护进程交流。更多的说明可以在连接页面上找到。


Debian / Ubuntu


首先,确保守护进程运行在同一台机器上,参数是 --limited-graphql-port 3095


(可选) 在重启时启用 Sidecar 服务,您可以使用:

sudo systemctl enable mina-bp-stats-sidecar

然后手动启动 Sidecar 服务,使用以下命令:

sudo service mina-bp-stats-sidecar start

您可以检查它是否正在运行,并使用 service mina-bp-stats-sidecar status 查看最新的日志。


如果您想从 Sidecar 服务中获取日志,您可以使用 journalctl

journalctl -f -u mina-bp-stats-sidecar.service


Docker


首先,您需要为守护进程和 Sidecar 容器创建一个网络:

docker network create mina-network

接下来,您需要使用传递给 docker 的 --network mina-network 区开启守护进程以及将的一些新标记 --open-limited-graphql-port --limited-graphql-port 3095 传递给守护进程。


使用以下命令,启动 docker 容器:

docker run \--name mina-sidecar \--network mina-network \--restart=always -d \-v $(pwd)/mina-sidecar-config.json:/etc/mina-sidecar.json \minaprotocol/mina-bp-stats-sidecar:latest

可以使用 docker logs 命令查看日志:

docker logs -f mina-sidecar



故障排除


如果您在运行 sidecar 的时候得到了 400:

INFO:root:Fetching block 2136...INFO:root:Got block dataERROR:root:HTTP Error 400: Bad Request
-- TRACEBACK --
ERROR:root:Sleeping for 30s and trying again

这很可能意味着您将数据发送到了接收管道,而没有在您的 Mina 节点上配置任何区块生产者密钥-因为您的 BP 密钥是您的身份,所以我们不能接受节点数据,因为我们不知道谁提交了它!



全球最轻量区块链 人人皆可参与

公众号|Mina Protocol Official

微 博|Mina_Protocol







您可能也对以下帖子感兴趣

文章有问题?点此查看未经处理的缓存