Subgraph Studio Kullanarak Dağıtma

Reading time: 4 min

Subgraph'inizi Subgraph Studio'da dağıtma adımlarını öğrenin.

Subgraph Studio'da aşağıdakileri yapabilirsiniz:

• Oluşturmuş olduğunuz sugraph'lerin listesini görüntülemek
• Belirli bir subgraph'i yönetmek, subgraph'in detaylarını görmek ve durumunu görüntülemek
• Belirli subgraph'ler için API anahtarlarınızı oluşturmak ve yönetmek
• API anahtarlarınızı belirli alanlara sınırlamak ve yalnızca belirli Endeksleyicilerin bu anahtarlarla sorgulama yapmasına izin vermek
• Subgraph'inizi oluşturmak
• Subgraph'inizi The Graph CLI'yi kullanarak dağıtmak
• Subgraph'inizi playground ortamında test etmek
• Geliştirme sorgu URL'sini kullanarak subgraph’inizi hazırlama ortamına entegre etmek
• Subgraph'inizi The Graph Ağında yayımlamak
• Faturalarınızı yönetmek

Dağıtmadan önce The Graph CLI'yi yüklemeniz gerekmektedir.

The Graph CLI'yi kullanmak için bilgisayarınızda Node.js ve tercih ettiğiniz bir paket yöneticisi (npm, yarn veya pnpm) kurulu olmalıdır. CLI'ın en son sürümünü kontrol edin.

yarn global add @graphprotocol/graph-cli

npm install -g @graphprotocol/graph-cli

1. Subgraph Studio'yu açın.
2. Giriş yapmak için cüzdanınızı bağlayın.
   • Cüzdan bağlamak için MetaMask, Conbase Wallet, WalletConnect ya da Safe kullanabilirsiniz.
3. Giriş yaptıktan sonra, benzersiz yayına alma anahtarınız subgraph ayrıntıları sayfasında görünecektir.
   • Dağıtma anahtarınız subgraph'lerinizi yayımlamanızı veya API anahtarlarınızı ve faturanızı yönetmenizi sağlar. Dağıtma anahtarınız benzersizdir; ancak anahtarınızın ele geçirildiğini düşünüyorsanız bu anahtarı yeniden yaratabilirsiniz.

Subgraph'lerin Graph Ağı Endeksleyicileri tarafından desteklenebilmesi için şu gereklilikleri karşılaması gerekir:

• Desteklenen bir ağı endeksliyor olmalı
• Aşağıdaki özelliklerden hiçbirini kullanmamalı:
  • ipfs.cat & ipfs.map
  • Kritik olmayan hatalar
  • Graftlama

Subgraph’iniz Subgraph Studio’da oluşturulduktan sonra, aşağıdaki komutla CLI üzerinden subgraph kodunu ilklendirebilirsiniz:

graph init <SUBGRAPH_SLUG>

<SUBGRAPH_SLUG> değerini Subgraph Studio’daki subgraph ayrıntı sayfanızda bulabilirsiniz; aşağıdaki resme bakın:

graph init komutunu çalıştırdıktan sonra sorgulamak istediğiniz kontrat adresini, ağı ve ABI’yi girmeniz istenecektir. Bu komut, yerel makinenizde subgraph’inizle çalışmaya başlamanız için bazı temel kodları içeren yeni bir klasör oluşturacaktır. Sonrasında subgraph'inizi işlevselliğini test ederek nihayetlendirebilirsiniz.

Subgraph’inizi Subgraph Studio’da yayına alabilmek için önce CLI üzerinden hesabınıza giriş yapmanız gerekmektedir. Bunun için, subgraph ayrıntıları sayfanızda bulabileceğiniz yayına alma anahtarınıza ihtiyacınız olacak.

CLI üzerinden kimlik doğrulaması yapmak için aşağıdaki komutu kullanın:

graph auth <DEPLOY KEY>

Hazır olduğunuzda subgraph’inizi Subgraph Studio’da dağıtabilirsiniz.

Subgraph’inizi dağıtmak için aşağıdaki CLI komutunu kullanın:

graph deploy <SUBGRAPH_SLUG>

Bu komutu çalıştırdıktan sonra CLI sizden bir sürüm etiketi isteyecektir.

• Sürüm etiketlemede semver (örn. 0.0.1) kullanmanız tavsiye edilir. Ancak v1, version1 veya asfdf gibi başka bir dize de seçebilirsiniz.
• Oluşturduğunuz etiketler Graph Gezgini'nde görünür olacak. Küratörler bu etiketlere göre belirli bir sürüme sinyal verip vermemeyi kararlaştırabilirler; bu nedenle seçimlerinizi dikkatle yapın.

Yayına aldıktan sonra, subgraph’inizi (Subgraph Studio’da veya sorgu URL’si ile kendi uygulamanızda) test edebilir, yeni bir sürüm yayına alabilir, meta verileri güncelleyebilir ve hazır olduğunuzda Graph Gezgini'nde yayımlayabilirsiniz.

Subgraph Studio’da günlükleri kontrol ederek subgraph’inizle ilgili hataları görebilirsiniz.

Subgraph’inizi başarıyla yayımlamak için subgraph yayımlama adımlarını gözden geçirin.

Subgraph’inizi güncellemek isterseniz, aşağıdaki adımları izleyebilirsiniz:

• CLI kullanarak Studio’da yeni bir sürüm dağıtabilirsiniz (bu sürüm yalnızca özel olarak kalacaktır).
• Memnun kaldığınızda, yeni dağıtımınızı Graph Gezgini'nde yayımlayabilirsiniz.
• Bu işlem, küratörlerin sinyal vermeye başlayabileceği ve Endeksleyicilerin endeksleyebileceği, subgraph'inizin yeni bir sürümünü oluşturur.

Ayrıca, subgraph'inizin meta verilerini yeni bir sürüm yayımlamak zorunda kalmadan güncelleyebilirsiniz. Studio’daki (profil resmi, isim, açıklama gibi) subgraph ayrıntılarını Graph Gezgini'ndeki Ayrıntıları Güncelle seçeneğini işaretleyerek güncelleyebilirsiniz. Bu seçenek işaretlendiğinde, yeni bir sürüm yayımlamaya gerek kalmadan, Explorer'da subgraph ayrıntılarını güncelleyen bir blokzincir işlemi oluşturulur.

Subgraph Studio’da yeni bir subgraph sürümü yayına aldığınızda, önceki sürüm arşivlenecektir. Arşivlenen sürümler endekslenmez/senkronize edilmez ve bu nedenle sorgulanamaz. Subgraph’inizin arşivlenen bir sürümünü Subgraph Studio'da arşivden çıkarabilirsiniz.