在 CGP 上运行全节点

Last updated 2 years ago

在 CGP 上运行全节点

本教程介绍了如何配置和部署公共全节点以使用 Google Cloud (GCP) 连接到 Aptos 开发网。与在笔记本电脑上运行相比，在云中运行全节点通常可以提供更好的稳定性和可用性。如果您正在寻找部署生产级全节点，我们建议您将其部署在云上。

注意：如果您想要其他部署替代方案，请阅读运行全节点，使用云需要付费，具体取决于您的配置方式。

先决条件

您可以运行本指南中的命令，从您想要的任何机器上在 Google Kubernetes Engine 上部署您的完整节点。从、或您的个人计算机上的虚拟机。

Cloud Shell 预装了以下软件包。如果您选择使用 Cloud Shell，请务必查看有关。但是，如果您是从笔记本电脑或另一台机器上运行安装，则需要安装：

Terraform 1.1.7:
Kubernetes cli:
Google Cloud cli:

安装 gcloud CLI 后，使用 gcloud 登录 GCP

()

$ gcloud auth login --update-adc

如果您已经设置了 GCP 帐户，请直接跳至“”，如果还没有，请按照以下部分创建和配置您的 GCP 帐户。

GCP 设置

注册 90 天免费试用

创建一个新的 GCP 项目

启用计费/升级您的帐户

您仍然可以使用免费试用积分，但启用计费功能可以让您完全访问 GCP 的所有功能，并且不会遇到任何节点中断。

更多 GCP 资源

入门

为您的配置创建一个工作目录。
- 选择一个工作区名称，例如devnet。注意：这定义了 terraform 工作空间名称，该名称又用于形成资源名称。
```
$ export WORKSPACE=devnet
```
- 为工作区创建目录
```
$ mkdir -p ~/$WORKSPACE
```
创建一个存储桶，用于在 Google Cloud Storage 上存储 Terraform 状态。使用控制台或此 gcs 命令创建存储桶。存储桶的名称必须是唯一的。在此处查看 Google Cloud Storage 文档：
```
$ gsutil mb gs://BUCKET_NAME
# for example
$ gsutil mb gs://<project-name>-aptos-terraform-dev
```
在您的工作目录中创建名为 main.tf 的 Terraform 文件
```
$ cd ~/$WORKSPACE
$ touch main.tf
```

修改 main.tf文件以配置 Terraform，并从 Terraform 模块创建全节点。 main.tf 的示例内容

terraform {
  required_version = "~> 1.2.0"
  backend "gcs" {
    bucket = "BUCKET_NAME" # bucket name created in step 2
    prefix = "state/fullnode"
  }
}

module "fullnode" {
  # download Terraform module from aptos-labs/aptos-core repo
  source        = "github.com/aptos-labs/aptos-core.git//terraform/fullnode/gcp?ref=main"
  region        = "us-central1"  # Specify the region
  zone          = "c"            # Specify the zone suffix
  project       = "gcp-fullnode" # Specify your GCP project name
  era           = 1              # bump era number to wipe the chain
  image_tag     = "devnet"       # Specify the docker image tag to use, replace to `testnet` or other tag if needed

  fullnode_helm_values = {
    chain = {
    name = "devnet"              # replace with `ait3` or other values if connecting to different networks.
    }
  }
}

在 main.tf文件的同一目录中初始化 Terraform

$ terraform init

这应该会在 .terraform 文件夹中为您下载所有 terraform 依赖项。

创建一个新的 Terraform 工作区以隔离您的环境：

$ terraform workspace new $WORKSPACE
# This command will list all workspaces
$ terraform workspace list

应用配置。
```
$ terraform apply
```

这可能需要一段时间才能完成（10 - 20 分钟），Terraform 将在您的云帐户上创建所有资源。

验证

一旦 Terraform 应用完成，您可以按照此部分验证您的部署。

配置您的 Kubernetes 客户端以访问您刚刚部署的集群

$ gcloud container clusters get-credentials aptos-$WORKSPACE --zone <region_zone_name> --project <project_name>
# for example:
$ gcloud container clusters get-credentials aptos-devnet --zone us-central1-a --project aptos-fullnode

检查您的全节点 Pod 现在是否正在运行（这可能需要几分钟）：
```
$ kubectl get pods -n aptos
```

获得您全节点IP

$ kubectl get svc -o custom-columns=IP:status.loadBalancer.ingress -n aptos

检查 REST API，确保 ledge 版本正在增加。

$ curl http://<IP>/v1
# Example command syntax: curl <http://104.198.36.142/v1>

设置到 aptos-fullnode pod 的端口转发。使用 kubectl get pods -n aptos 获取 pod 的名称

$ kubectl port-forward -n aptos <pod-name> 9101:9101
# for example:
$ kubectl port-forward -n aptos devnet0-aptos-fullnode-0 9101:9101

打开一个新的 ssh 终端。执行以下 curl 调用以验证正确性

$ curl -v <http://0:9101/metrics> 2> /dev/null | grep "aptos_state_sync_version{type=\\"synced\\"}"

$ curl -v <http://0:9101/metrics> 2> /dev/null | grep "aptos_connections{direction=\\"outbound\\""

完成后通过在终端中输入 control-c 退出端口转发

使用新版本更新全节点

可能有两种类型的版本，一种带有数据擦除以启动区块链，一种只是软件更新。

使用数据擦除升级

您可以在 main.tf中增加era编号以触发新数据卷的创建，这将在新数据库上启动节点。
更新 main.tf中的 image_tag
更新全节点的 Terraform 模块，在 main.tf 文件的同一目录中运行它
```
$ terraform get -update
```
应用 Terraform 更改

$ terraform apply

升级无数据擦除

更新 main.tf中的image_tag
更新全节点的 Terraform 模块，在 main.tf文件的同一目录中运行它
```
$ terraform get -update
```
应用 Terraform 更改

$ terraform apply
# if you didn't update the image tag, terraform will show nothing to change, in this case, force helm update
$ terraform apply -var force_helm_update=true

配置身份和种子对等点

静态身份

修改 main.tf以在 fullnode_helm_values 中添加fullnode_identity，这将配置 fullnode 的键，例如：

module "fullnode" {
  # download Terraform module from aptos-labs/aptos-core repo
  source        = "github.com/aptos-labs/aptos-core.git//terraform/fullnode/gcp?ref=main"
  region        = "us-central1"  # Specify the region
  zone          = "c"            # Specify the zone suffix
  project       = "gcp-fullnode" # Specify your GCP project name
  era           = 1              # bump era number to wipe the chain
  image_tag     = "devnet"       # Specify the docker image tag to use

  fullnode_helm_values = {
    chain = {
      name = "devnet"
    }
    # create fullnode from this identity config, so it will always have same peer id and address
    fullnode_identity = {
      type = "from_config"
      key = "B8BD811A91D8E6E0C6DAC991009F189337378760B55F3AD05580235325615C74"
      peer_id = "ca3579457555c80fc7bb39964eb298c414fd60f81a2f8eedb0244ec07a26e575"
    }
  }
}

应用 Terraform 更改
```
$ terraform apply
```

添加上游种子节点

您可以添加上游种子对等点以允许您的节点状态从特定的全节点同步，这在全节点由于拥塞而无法连接到网络时很有帮助。

module "fullnode" {
    # download Terraform module from aptos-labs/aptos-core repo
    source        = "github.com/aptos-labs/aptos-core.git//terraform/fullnode/gcp?ref=main"
    region        = "us-central1"  # Specify the region
    zone          = "c"            # Specify the zone suffix
    project       = "gcp-fullnode" # Specify your GCP project name
    era           = 1              # bump era number to wipe the chain
    image_tag     = "dev_5b525691" # Specify the docker image tag to use

    fullnode_helm_values = {
      # add a list of peers as upstream
      aptos_chains = {
        devnet = {
          seeds = {
            "bb14af025d226288a3488b4433cf5cb54d6a710365a2d95ac6ffbd9b9198a86a" = {
            addresses = ["/dns4/pfn0.node.devnet.aptoslabs.com/tcp/6182/noise-ik/bb14af025d226288a3488b4433cf5cb54d6a710365a2d95ac6ffbd9b9198a86a/handshake/0"]
            role = "Upstream"
            },
            "7fe8523388084607cdf78ff40e3e717652173b436ae1809df4a5fcfc67f8fc61" = {
            addresses = ["/dns4/pfn1.node.devnet.aptoslabs.com/tcp/6182/noise-ik/7fe8523388084607cdf78ff40e3e717652173b436ae1809df4a5fcfc67f8fc61/handshake/0"]
            role = "Upstream"
            },
            "f6b135a59591677afc98168791551a0a476222516fdc55869d2b649c614d965b" = {
            addresses = ["/dns4/pfn2.node.devnet.aptoslabs.com/tcp/6182/noise-ik/f6b135a59591677afc98168791551a0a476222516fdc55869d2b649c614d965b/handshake/0"]
            role = "Upstream"
            }
          }
        }
      }
    }
  }

如果您要连接到其他网络，请确保将 aptos_chains.devnet 更新到相应的网络

应用 Terraform 更改

$ terraform apply

检查日志记录

要检查 pod 的日志，请使用以下命令

# Get a list of the pods
$ kubectl get pods -n aptos

# Get logs of the pod
$ kubectl logs <pod-name> -n aptos
# for example:
$ kubectl logs devnet0-aptos-fullnode-0 -n aptos

使用 GKE 时，集群和 pod 的日志会自动显示在 Google Cloud 控制台中。从控制台菜单中，选择 Kubernetes Engine。从侧面菜单中，选择Workloads。您将看到列出的集群中的所有 pod。

devnet0-aptos-fullnode 是运行 aptos fullnode 容器的 pod。单击吊舱以查看详细信息。您将看到有关 pod 的一些指标和其他详细信息。

单击 LOGS选项卡可直接从 pod 中查看日志。如果 pod 中有错误，您将在此处看到它们。

单击open in new window图标以在日志资源管理器中查看日志。此屏幕允许在日志中进行高级搜索。

日志仪表板中提供了其他日志记录见解

检查监控

谷歌云从集群中捕获许多指标，并让它们在控制台中轻松查看。从控制台菜单中，选择 Kubernetes Engine。单击 aptos 部署到的集群。点击右上角的Operations链接。单击“Metrics”子选项卡以查看特定的集群指标。

故障排除

常见的故障排除解决方案。

Terraform“连接被拒绝”错误消息

运行 terraform 时，命令出错，并显示连接被拒绝错误消息。

Error: Get "<http://localhost/api/v1/namespaces/aptos>": dial tcp 127.0.0.1:80: connect: connection refused

这可能意味着安装状态与存储桶中保存的 terraform 状态文件不同步。（在 terraform init语句期间配置）。如果集群或其他组件在 terraform 之外被删除，则可能会发生这种情况。或者如果 terraform 出现错误并且没有完成。使用以下命令检查状态。删除与错误消息相关的状态。您可能需要运行 terraform destroy、清理环境并再次运行 terraform 脚本。

terraform state list

terraform state rm <state>

全节点“NoAvailablePeers”错误消息

Previous全节点设置故障排除 Next本地测试网

Last updated 2 years ago