如果您已经注册了一个不错的ENS名称,并希望通过IPFS和以太坊名称服务使您的站点/dapp可用。要使其成为部署脚本的无缝部分,需要执行几个步骤。
在我们开始之前。..
在本指南中,我假设您已经了解如何使用IPFS和ENS托管网站的基础知识。重点在于部署自动化和调整CI工作流程。 如果您不熟悉ENS和IPFS,可能会出现一些问号:)
Node.js 版本:在编写本文时,不能将ens-upda te r安装在12.x或更高版本的节点上,因为某些依赖项需要脚本模块,该脚本模块无法构建。 在https://github.com/TripleSpeeder/ens-updater/issues/44中跟踪了此问题。 在问题解决之前,请使用节点版本10或更低版本。
要完成的任务
部署分布式的站点需要两个步骤:
1. 将内容发布到IPFS,获取新的CID。
2. 将ENS名称的IPFS记录设置为指向新的CID。
对于这两个步骤,都可以使用命令行工具。 首先我们将详细研究每个步骤,然后创建一个Travis配置,该配置将完全自动化部署。
第1步-发布到IPFS
对于此任务,我们将使用CLI工具ipfs-deploy。 通过npm全局安装:
》 npm install -g ipfs-deploy
这个工具真的很简单。 您只需要提供要部署的构建文件夹,然后选择要使用的IPFS固定服务即可。
假设应用的生产版本位于文件夹版本中,则可以运行以下命令以通过公用的infura ipfs节点进行部署:
》 ipfs-deploy build -p infura
注意ipfs-deploy提供的CID 字符 串Qm…。 这是构建的唯一标识符,需要将其添加到ENS名称中。
Ipfs部署支持许多不同的IPFS pi nning服务,其中一些需要身份验证。
这就是第一步的全部内容-您的构建现已发布!
步骤2 —设置您的ENS名称的contenthash记录
对于此步骤,我们将使用cli工具ens-updater。通过npm全局安装:
》 npm install -g @triplespeeder/ens-updater
ens-updater支持许多不同的命令来管理您的ENS名称。对于本教程,我们只希望设置名称的contenthash条目,使其指向您在步骤1中获得的CID。请检查ens-updater --help的输出,以获取受支持命令的概述以及github页面的内容。
由于我们需要与ENS智能合约进行交互以更新contenthash条目,因此我们需要做两件事:
1. 访问以太坊节点以与智能合约进行交互。
2. 控制ENS名称的帐户的私钥。
您可以直接或通过助记符字符串(和可选的帐户索引)间接提供私钥。对于这两个选项,您都需要将信息放入.env文件中或设置环境变量。
对于本教程,我们将私钥保存在.env文件中。 打开您选择的文本编辑器,并在工作目录中创建文件.env:
PRIVATE_KEY=《private key here, without le adi ng 0x》
为确保所有设置均正确,请使用--dry-run选项调用ens-updater。 设置此选项后,将不会执行任何实际交易,但将报告潜在的配置或设置问题。
示例:在空运行模式下,将ENS名称mysite.eth的内容哈希记录设置为ipfs CID Qmd2yEHMTswLppDkWNjEMH4WwAgeuFXYeMHSn4VcJMcvKy的完整命令:
》 ens-updater setContenthash mysite.eth ipfs-ns
Qmd2yEHMTswLppDkWNjEMH4WwAgeuFXYeMHSn4VcJMcvKy --web3
http://localhost:8545 --verbose --dry-run
检查结果输出以查看是否报告了任何错误。否则,您最好不用— dry-run继续!
现在将浏览器指向http://mysite.eth。假设您的系统设置正确,可以与.eth域一起使用,那么您应该会看到您的网站正在运行!
这就是第2步的全部操作-现在可以通过您的ENS名称访问您的网站!继续阅读以设置Travis进行自动部署。
将它们放在一起进行全自动部署
要使用Travis自动执行上述步骤,我们需要:
1. 创建一个结合了ipfs-deploy和ens-updater的部署脚本,由Travis在部署阶段执行。
2. 设置Travis以执行部署脚本。
3. 为Travis设置环境变量,以便ens-updater可以访问私钥。
部署脚本
由于ipfs-deploy通过stdout提供了CID,并且可以将ens-updater设置为从stdin中读取CID,因此我们可以将这两个命令用pipe连接在一个小型shell脚本中,如下所示:
#!/bin/bash
ipfs-deploy build -p $1 -C -O |
ens-updater setContenthash mysite.eth ipfs-ns stdin -v --web3 $2
该脚本希望将pinner服务用于部署作为第一个参数,并将web3连接字符串用作第二个参数。 另外,请注意,通过将特殊字符串“ stdin”指定为ens-updater的CID,它知道从stdin中读取CID。
将此脚本添加到您的项目中,使其成为 存储 库的一部分并可供Travis使用。
Travis配置
现在编辑travis.yaml以在部署阶段执行脚本。这是一个真实项目中的(精简后的)样本配置,其中强调了重要的部分:
os: linux
language: node_js
node_js: 10
jobs:
include:
- name: “IPFS”
install:
- npm ci
- npm install -g ipfs-deploy
- npm install -g @triplespeeder/ens-updater
script: npm run build
deploy:
provider: script
script: bash scripts/deploy_ipfs.sh pinata https://m ai nnet.infura.io/v3/$INFURA_ID
skip_cleanup: true
安装阶段包含用于安装工具ipfs-deploy和ens-updater的其他命令。
部署阶段使用ipfs pinner服务“ pinata”和来自infura的web3实例执行我们刚刚创建的部署脚本。 不要忘记skip_cleanup选项-否则,Travis将在开始部署之前清除build文件夹。..
最后缺少的部分是提供ENS名称控制器帐户的私钥。让我们进行设置!
1. 转到Travis中的项目页面
2. 打开设置页面
3. 转到“Environment Variables”部分
添加一个名称为“ PRIVATE_KEY”的新环境变量,并将您的私钥粘贴到VALUE字段中。将BRANCH字段设置为您的master分支,因为部署将仅从master分支运行。确保不要选中“DISPLAY VALUE IN BUILD LOG”-否则任何人都可以在构建日志中看到您的私钥。
就我而言,我还为pinata IPFS服务和Infura web3服务添加了环境变量,并为可选部署到Github页面添加了GitHub令牌。 这是完整设置的屏幕截图:
在这些更改就位后,触发新的生成。如果一切顺利,您的构建日志将像这样结束:
就是这样!每当您将更新推送到主分支时,所做的更改都将部署到IPFS,并且ENS名称的contenthash记录也将更新。
责任编辑:ct