SubQuery 開發者指南丨發佈 SubQuery 項目

SubQuery

由 熱鏈中的人 於 11 月 2, 2021

用 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，請保持不選。

創建你的項目，你會在你的子查詢項目的列表中看到它。我們就快成功了 ! 我們只需要部署它的一個新版本。

**
**

部署你的第一個版本

當創建一個項目將設置項目的顯示狀況時，你必須在它變得可使用之前部署一個版本。部署一個版本會觸發一個新的 SubQuery 索引操作，並設置所需的查詢服務以開始接受 GraphQL 請求。你也可以在這裏將新的版本部署到現有的項目。

在你的新項目中，你會看到一個部署新版本的按鈕。點擊這個，並填寫關於部署的必要信息。

新版本的提交哈希值。從 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 項目，你不會失去任何數據。