在 AWS 上运行

这是在 AWS 上安装 Aptos 节点的分步指南。这些步骤将在不同的机器上配置一个验证者节点和一个全节点。

在继续之前

确保在继续之前完成这些先决条件步骤：

  1. 设置您的 AWS 账户。

  2. 确保在您的本地计算机上安装了以下内容：

安装

  1. 为您的节点配置工作创建一个工作目录

    • 选择一个工作空间的名字，例如： 测试网**注意：**这决定了 Terraform 工作空间名称，该名称也用于形成资源名称。

    export WORKSPACE=testnet

    • 为工作区创建一个目录。

      mkdir -p ~/$WORKSPACE

    • 为您的节点选择一个用户名，例如：alice.

      export USERNAME=alice

  2. 创建一个 S3 桶式存储器，用于在 AWS 上存储 Terraform 状态。您可以在 AWS UI 上或通过以下命令执行此操作：

    aws s3 mb s3://<bucket name> --region <region name>

  3. 创建一个名为 Terraform 的文件 main.tf 在您的工作目录中：

    cd ~/$WORKSPACE
vi main.tf

  4. 修改 main.tf文件以配置 Terraform 并从 Terraform 模块创建 Aptos 全节点。请参阅下面的 main.tf 示例内容：

    terraform {
  required_version = "~> 1.2.0"
  backend "s3" {
    bucket = "terraform.aptos-node"
    key    = "state/aptos-node"
    region = <aws region>
  }
}

provider "aws" {
  region = <aws region>
}

module "aptos-node" {
  # Download Terraform module from aptos-labs/aptos-core repo
  source        = "github.com/aptos-labs/aptos-core.git//terraform/aptos-node/aws?ref=testnet"
  region        = <aws region>  # Specify the region
  # zone_id     = "<Route53 zone id>"  # zone id for Route53 if you want to use DNS
  era           = 1              # bump era number to wipe the chain
  chain_id      = 43
  image_tag     = "testnet" # Specify the image tag to use
  validator_name = "<Name of your Validator>"
}

    有关完整的自定义选项，请参阅：

  5. 在您创建 main.tf 文件的 $WORKSPACE 目录中初始化 Terraform。

    terraform init

    这会将所有 Terraform 依赖项下载到当前工作目录中的 .terraform 文件夹中。

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

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

  7. 应用配置。

    terraform apply

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

  8. 在 terraform apply 完成后，您可以检查这些资源是否已创建：

    • aws eks update-kubeconfig --name aptos-$WORKSPACE：为您的 k8s 集群配置访问权限。

    • kubectl get pods：这应该有 haproxy、验证者和全节点，以及验证器和 fullnode pod pending（需要在后面的步骤中进一步操作）。

    • kubectl get svc：这应该有 validator-lb 和 fullnode-lb，您可以稍后共享一个外部 IP 以进行连接。

  9. 将您的节点 IP 信息整合进您的环境中：

    export VALIDATOR_ADDRESS="$(kubectl get svc ${WORKSPACE}-aptos-node-0-validator-lb --output jsonpath='{.status.loadBalancer.ingress[0].hostname}')"

export FULLNODE_ADDRESS="$(kubectl get svc ${WORKSPACE}-aptos-node-0-fullnode-lb --output jsonpath='{.status.loadBalancer.ingress[0].hostname}')"

  10. 在您的工作目录中生成密钥对（节点所有者、投票者、操作员密钥、共识密钥和网络密钥）。

    aptos genesis generate-keys --output-dir ~/$WORKSPACE/keys

    这将在 ~/$WORKSPACE/keys 目录下创建 4 个密钥文件：

    • public-keys.yaml

    • private-keys.yaml

    • validator-identity.yaml，和

    • validator-full-node-identity.yaml.

      重要

      将您的私钥文件备份到安全的地方。这些关键文件对于您建立节点的所有权很重要。永远不要与任何人共享私钥。

  11. 配置验证器信息。这是您稍后在 Aptos 社区网站上注册所需的所有信息。

    aptos genesis set-validator-configuration \\
  --local-repository-dir ~/$WORKSPACE \\
  --username $USERNAME \\
  --owner-public-identity-file ~/$WORKSPACE/keys/public-keys.yaml \\
  --validator-host $VALIDATOR_ADDRESS:6180 \\
  --full-node-host $FULLNODE_ADDRESS:6182 \\
  --stake-amount 100000000000000

    这将在 ~/$WORKSPACE/$USERNAME 目录中创建两个 YAML 文件：owner.yaml 和 operator.yaml。

  12. 创建一个布局模板文件，该文件用于定义 Aptos validatorSet 中的节点。

    aptos genesis generate-layout-template --output-file ~/$WORKSPACE/layout.yaml

    编辑layout.yaml，添加 root_key、验证点节点用户名和 chain_id：

    root_key: "D04470F43AB6AEAA4EB616B72128881EEF77346F2075FFE68E14BA7DEBD8095E"
users: ["<username you specified from previous step>"]
chain_id: 43
allow_new_validators: false
epoch_duration_secs: 7200
is_test: true
min_stake: 100000000000000
min_voting_threshold: 100000000000000
max_stake: 100000000000000000
recurring_lockup_duration_secs: 86400
required_proposer_stake: 100000000000000
rewards_apy_percentage: 10
voting_duration_secs: 43200
voting_power_increase_limit: 20

    请确保您使用与示例中所示相同的根公钥和链 ID，这些配置将在注册期间用于验证您的节点。

  13. 将 AptosFramework Move 包下载到 ~/$WORKSPACE 目录中作为 framework.mrb

    wget <https://github.com/aptos-labs/aptos-core/releases/download/aptos-framework-v0.3.0/framework.mrb> -P ~/$WORKSPACE

  14. Compile the genesis blob and waypoint.编译创世和航路点。

    aptos genesis generate-genesis --local-repository-dir ~/$WORKSPACE --output-dir ~/$WORKSPACE

    这将在您的工作目录中创建两个文件：genesis.blob 和 waypoint.txt。

  15. 总而言之，在您的工作目录中，您应该有一个文件列表：

    • main.tf：用于安装 aptos-node 模块的 Terraform 文件（来自步骤 3 和 4）。

    • keys 文件夹，其中包括：

      • public-keys.yaml：用于所有者帐户、共识、网络的公钥（从第 10 步开始）。

      • private-keys.yaml：用于所有者帐户、共识、网络的私钥（从第 10 步开始）。

      • validator-identity.yaml：用于设置验证者身份的私钥（从第 10 步开始）。

      • validator-full-node-identity.yaml：用于设置验证者完整节点身份的私钥（从第 10 步开始）。

    • username 文件夹，其中包括：

      • owner.yaml：定义所有者、操作员和选民映射。它们在测试模式下都是同一个帐户（从第 11 步开始）。

      • operator.yaml：将用于验证者和全节点的节点信息（来自第 11 步）。

    • layout.yaml：包含根键、验证器用户和链 ID 的键值的布局文件（来自第 12 步）。

    • framework.mrb：AptosFramework Move 包（从第 13 步开始）。

    • waypoint.txt：创世交易的航点（来自第 14 步）。

    • genesis.blob 包含有关框架、validatorSet 等所有信息的 genesis 二进制文件（来自第 14 步）。

  16. 将genesis.blob、waypoint.txt和身份文件作为插件k8s。

kubectl create secret generic ${WORKSPACE}-aptos-node-0-genesis-e1 \\
    --from-file=genesis.blob=genesis.blob \\
    --from-file=waypoint.txt=waypoint.txt \\
    --from-file=validator-identity.yaml=keys/validator-identity.yaml \\
    --from-file=validator-full-node-identity.yaml=keys/validator-full-node-identity.yaml

💡 注意

e1 后缀是时代编号。如果您更改了时代编号，请确保在创建密钥时将它匹配。

  1. 检查所有 pod 是否都在运行。

    kubectl get pods

NAME                                        READY   STATUS    RESTARTS   AGE
node1-aptos-node-0-fullnode-e9-0              1/1     Running   0          4h31m
node1-aptos-node-0-haproxy-7cc4c5f74c-l4l6n   1/1     Running   0          4h40m
node1-aptos-node-0-validator-0                1/1     Running   0          4h30m

现在您已成功完成在测试模式下设置节点。您现在可以前往 Aptos 社区平台网站进行注册。

PreviousValidatorsNext在 Azure 上运行

Last updated