SubQuery开发者指南丨发布SubQuery项目
用 SubQuery 托管你的项目的优势
我们将在一个高性能、可扩展和可管理的公共服务中为你运行你的 SubQuery 项目。
这项服务是免费提供给社区的。
你可以公开你的项目,这样它们就会在 SubQuery 浏览器:
https://explorer.subquery.network/
中列出,世界各地的任何人都可以查看它们。我们与 GitHub 集成,所以你的 GitHub 组织中的任何人都可以查看共享的组织项目。
创建你的第一个项目
登录到 SubQuery 项目。
在开始之前,请确保你的 SubQuery 项目在线于 GitHub 公共仓库中。而且,schema.graphql 文件必须在你的根目录。
要创建你的第一个项目,请前往:project.subquery.network。
你需要用你的 GitHub 账户进行认证才能登录。
在第一次登录时,你将被要求授权给 SubQuery。我们只需要你的电子邮件地址来识别你的账户,我们不会因为其他原因使用你的 GitHub 账户的任何其他数据。在这一步,你也可以申请或授予你的 GitHub 组织账户的权限,这样你就可以在 GitHub 组织下发布 SubQuery 项目,而不是你的个人账户。
SubQuery 项目是你管理所有上传到 SubQuery 平台的托管项目的地方。你可以创建、删除、甚至升级项目,所有这些都来自这个应用程序。
如果你有一个 GitHub 组织账户,你可以使用标题上的切换器在你的个人账户和GitHub 组织账户之间切换。在 GitHub 组织账户中创建的项目会在该 GitHub 组织的成员之间共享。要连接你的 GitHub 组织账户,你可以按照这里的步骤,访问网址:
http:/#add-github-organization-account-to-subquery-projects
创建你的第一个项目。
让我们从点击 "创建项目 "开始。你将会被带到 "新项目 "表格。请输入以下内容(你可以在将来改变这些内容)。
GitHub账户。如果你有一个以上的GitHub账户,请选择该项目将在哪个账户下创建。在GitHub组织账户中创建的项目将在该组织的成员之间共享。
项目名称
副标题
(描述性)说明
GitHub存储库的URL。这必须是一个有效的GitHub URL,它拥有你的SubQuery 项目的公共存储库。schema.graphql 文件必须在你的根目录(学习更多有关目录结构的内容:http:/#directory-structure)
隐藏项目。如果选择,这将从公共 SubQuery 浏览器中隐藏项目。如果你想与社区分享你的 SubQuery,请保持不选。
创建你的项目,你会在你的子查询项目的列表中看到它。我们就快成功了! 我们只需要部署它的一个新版本。
部署你的第一个版本
新版本的提交哈希值。从GitHub,复制你想要部署的 SubQuery 项目代码库版本的完整提交哈希。
索引器版本。这就是你想在上面运行 SubQuery 项目的 SubQuery 节点服务版,具体见@subql/node。
查询版本。这就是你想在上面运行SubQuery 项目的 SubQuery 查询服务版,具体见@subql/query)。
部署你的第一个项目。
如果部署成功,你会看到索引器开始工作,并报告当前链的索引进度。这个过程可能需要时间,直到它达到100%。
下一步,连接到你的项目
一旦你的部署成功完成,我们的节点已经从链上索引了你的数据,你就可以通过显示的 GraphQL 查询端点连接到你的项目。
或者,你可以点击你的项目标题旁边的三个点,并在 SubQuery Explorer上查看它。在那里你可以使用浏览器内的娱乐场来开始,阅读更多关于如何使用我们的浏览器,可访问:
https://doc.subquery.network/query/query/
添加 GitHub 组织账户到 SubQuery 项目
在你的 GitHub 组织账户下发布你的 SubQuery 项目,而不是你的个人 GitHub账户是很常见的。在任何时候,你可以使用账户切换器在 SubQuery 项目上改变你当前选择的账户。
如果你在切换器中看不到你的 GitHub 组织账户,你可能需要为你的 GitHub 组织授予 SubQuery 的权限(或向管理员申请)。要做到这一点,你首先需要撤销你的 GitHub 账户对 SubQuery 应用程序的权限。要做到这一点,登录到你的 GitHub 账户设置,进入应用程序,在授权 OAuth 应用程序标签下,撤销 SubQuery——你可以按照确切步骤,访问网址:
https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/reviewing-your-authorized-applications-oauth
不要担心,这不会删除你的 SubQuery 项目,你不会失去任何数据。
一旦你撤销了访问权,退出 SubQuery 项目并再次登录。你应该被重新定向到一个名为授权 SubQuery 的页面,你可以请求或授予 SubQuery 访问你的 GitHub 组织账户。如果你没有管理员的权限,你必须请求管理员为你启用。
一旦这个请求被管理员批准(或者如果你自己能够授予它),你将在账户切换器中看到正确的 GitHub 组织账户。
Website:
https://www.subquery.network/
Discord中文群:
https://discord.gg/subquery
Telegram中文群:
t.me/subquerychina
Mixin中文群:
https://subquery.mixinbots.com/join
往期精彩
《SubQuery开发者指南丨在本地运行 SubQuery》
《SubQuery开发者指南丨GraphQL 架构(GraphQL Schema)》
《SubQuery开发者指南丨Hello World Explained》
《SubQuery开发者指南丨Hello World (由SubQuery 托管)》
《SubQuery开发者指南丨创建一个SubQuery项目》
《SubQuery开发者指南丨清单文件(Manifest File)》