Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Microsoft Fabric'te Git tümleştirme ve dağıtım işlem hatlarının GraphQL için API ile nasıl çalıştığını öğrenin. Bu makale, deponuza bağlantı ayarlamayı, GraphQL için API'nizi yönetmeyi ve bunları farklı ortamlara dağıtmayı anlamanıza yardımcı olur.
Uyarı
GraphQL kaynak denetimi ve dağıtımı için API şu anda önizleme aşamasındadır.
Önkoşullar
- Fabric içinde GraphQL için bir API'niz olmalıdır. Daha fazla bilgi için bkz. Dokuda GraphQL için API oluşturma ve veri ekleme.
Genel Bakış
Fabric, iki ana bileşen aracılığıyla CI/CD (sürekli tümleştirme ve sürekli dağıtım) ve geliştirme yaşam döngüsü yönetimi için güçlü araçlar sunar: Git tümleştirmesi (CI) ve dağıtım pipeline'ları (CD). Çalışma alanları hem Git eşitlemesi hem de dağıtım aşamaları için merkezi bileşenler görevi görür.
Git tümleştirmesi (CI): Çalışma alanı öğelerini (kod, yapılandırmalar, API'ler gibi) sürüm denetimi depolarıyla eşitleyerek Git aracılığıyla sürüm denetimini ve değişiklik izlemeyi etkinleştirir.
Dağıtım işlem hatları (CD):Bağlı çalışma alanlarıyla aşamaların (geliştirme, test, üretim gibi) oluşturulmasını sağlar. Her aşamada desteklenen öğeler sonraki aşamalara otomatik olarak çoğaltılır ve çalışma alanında yapılan değişiklikler yayın işlem hattında dağıtımı tetikler. Değişikliklerin ortamlar arasında verimli bir şekilde test edilmesini ve dağıtılmasını sağlamak için işlem hattını yapılandırabilirsiniz.
Fabric, yaygın senaryolara göre uyarlanmış çeşitli CI/CD iş akışlarını destekler. Daha fazla ayrıntı için bkz. Fabric'de CI/CD iş akışı seçenekleri.
Uyarı
Dağıtım sırasında yalnızca meta veriler kopyalanır; ve veriler kopyalanmaz.
Çalışma alanındaki öğeler ilişkili Git deposunda Kod Olarak Altyapı (IaC) olarak depolanır. Depodaki kod değişiklikleri işlem hatlarında dağıtımı tetikleyebilir. Bu yöntem, test ve üretim sürümü amacıyla aşamalar arasında kod değişikliklerinin otomatik olarak çoğaltılmasını sağlar.
Veri kaynağı kimlik doğrulama yöntemleri
Bu bölümde, veri kaynaklarını GraphQL için API'nize bağlamaya yönelik kimlik doğrulama yöntemleri hakkında bilgi edinecek ve bunların GraphQL için API ile geliştirme işlem hatlarındaki bağlı veri kaynakları arasındaki otomatik bağlama üzerindeki etkisini anlayacaksınız. Dağıtım işlem hattı işleminde otomatik bağlama hakkında daha fazla bilgi edinebilirsiniz.
GraphQL için API'nize veri kaynaklarını bağlamak için kullanabileceğiniz iki seçenek vardır:
Tek Oturum Açma Kimlik Doğrulaması (SSO) ile Fabric Veri Kaynaklarına Bağlanma
Kaydedilmiş Kimlik Bilgilerini kullanarak Fabric veya dış veri kaynaklarına bağlanın
İlk seçenek olan Tek Sign-On (SSO), Fabric içindeki veri kaynaklarına bağlantıları etkinleştirir. Bu durumda, özgün çalışma alanında Çoklu oturum açma yöntemini kullanarak bir veri kaynağını GraphQL'e bağladığınızda (örneğin, Geliştirme aşaması), veri kaynağı ve GraphQL öğesi işlem hattındaki hedef çalışma alanına (örneğin Test aşaması) dağıtılır ve hedef çalışma alanında GraphQL otomatik olarak hedef çalışma alanında dağıtılan yerel veri kaynağına bağlanır (aşağıdaki diyagrama bakın). SSO kullanırken ve SQL Analytics Uç Noktası üzerinden bir veri kaynağına bağlanırken belirli sınırlamalar vardır. Daha fazla ayrıntı için **Geçerli Sınırlamalar'a bakın.
İkinci seçenek olan Kayıtlı Kimlik Bilgileri, Doku dışındaki dış veri kaynaklarına ve Doku içindeki veri kaynaklarına bağlantı sağlar. Ancak, Kaydedilen Kimlik Bilgisi yaklaşımı için otomatik bağlama desteklenmez. Başka bir deyişle, özgün çalışma alanında Kayıtlı Kimlik Bilgileri 'ni (Geliştirme aşaması) kullanarak bir veri kaynağını GraphQL'e bağlarsanız, veri kaynağı işlem hattındaki hedef çalışma alanına (Test aşaması) dağıtılır. Ancak hedef çalışma alanında GraphQL öğesi, hedef çalışma alanında yerel bir veri kaynağına otomatik olarak bağlanmak yerine Kayıtlı Kimlik Bilgileri aracılığıyla özgün çalışma alanında (Geliştirme aşaması) veri kaynağına bağlı kalır. (aşağıdaki diyagrama bakın)
Ayrıca, veri kaynaklarına bağlanmak için Kayıtlı Kimlik Bilgileri yöntemi kullanılıyorsa geliştiricilerin GraphQL öğesini başarıyla dağıtmak için Kayıtlı Kimlik Bilgileri bilgilerine erişimi olmalıdır.
Uyarı
Özgün çalışma alanındaki GraphQL API'sinin (Geliştirme aşaması) farklı bir çalışma alanında bulunan bir veri kaynağına bağlı olması durumunda, hedef çalışma alanındaki GraphQL için dağıtılan API (Test aşaması), veri kaynaklarını GraphQL için API'nize bağlamak için hangi kimlik doğrulama yönteminin kullanıldığına bakılmaksızın farklı çalışma alanında bulunan veri kaynağına bağlı kalır. (aşağıdaki diyagrama bakın)
GraphQL Git tümleştirmesi için API
GraphQL için Doku API'sinde kaynak denetimi için Git tümleştirmesi sunulur. Git tümleştirmesi ile GraphQL için API'nizi yedekleyebilir ve sürüm oluşturabilir, gerektiğinde önceki aşamalara geri dönebilir, Git dallarını kullanarak işbirliği yapabilir veya tek başına çalışabilir ve GraphQL yaşam döngüsü api'nizi tamamen Doku içinde yönetebilirsiniz.
Bağlantı Ayarlama:
Çalışma Alanı ayarlarınızdan, değişiklikleri işlemek ve eşitlemek için deponuza kolayca bağlantı kurabilirsiniz. Bağlantıyı ayarlamak için bkz. Git tümleştirmesini kullanmaya başlama. Bağlandıktan sonra GraphQL api'si de dahil olmak üzere öğeleriniz Kaynak denetim masasında görünür.
GraphQL örnekleri için API'yi Git deposuna başarıyla kaydettikten sonra, depoda GraphQL klasör yapısını görürsünüz. Artık pull request oluşturulması gibi gelecekteki işlemleri yürütebilirsiniz.
Git'te GraphQL gösterimi:
Aşağıdaki görüntü, Git deposundaki GraphQL öğesinin her API'sinin dosya yapısına bir örnektir:
GraphQL için API öğesini Git deposuna kaydettiğinizde GraphQL için API tanımı depolanır. Bu yaklaşım, bir Doku çalışma alanına geri eşitlerken tam kurtarmayı destekler:
Doku denetim düzlemi API'leri belgelerinde GraphQL API tanım biçimi, söz dizimi ve örnekler hakkında daha fazla bilgi bulabilirsiniz:
Dağıtım işlem hattında GraphQL için API
Dağıtım işlem hattını kullanarak GraphQL dağıtımı için API'nizi tamamlamak için aşağıdaki adımları kullanın.
Yeni bir dağıtım hattı oluşturun veya mevcut bir dağıtım hattını açın. Daha fazla bilgi için bkz. Dağıtım işlem hatlarını kullanmaya başlama.
Çalışma alanlarını dağıtım hedeflerinize göre farklı aşamalara atayın.
Aşağıdaki örnekte gösterildiği gibi Farklı aşamalar arasında GraphQL api'si dahil olmak üzere öğeleri seçin, görüntüleyin ve karşılaştırın. Önceki aşama ile geçerli aşama arasında değişen öğe sayısını gösteren vurgulanan alanlar.
- Dağıtılması gereken öğeleri seçin. Seçtiğiniz öğeleri (GraphQL için API ve Bağlı Veri kaynağı) Geliştirme, Test ve Üretim aşamalarında dağıtmak için Dağıt'ı seçin.
Dağıtmak üzere olduğunuz öğeleri onaylayan bir sonraki ileti açılır. Dağıtım işlemini onaylamak ve devam etmek için Dağıt'ı seçin.
Mevcut sınırlamalar
Fabric CI/CD, alt öğelerin otomatik bağlanmasını desteklemez. Başka bir deyişle GraphQL API'si özgün çalışma alanında (geliştirme aşaması gibi) bir veri kaynağının alt öğesi olarak SQL Analytics Uç Noktasına bağlanırsa, köken hedef çalışma alanına (örneğin Test aşaması) aktarılmaz. Sonuç olarak, hedef çalışma alanında GraphQL için dağıtılan API (örneğin, Test aşaması) özgün çalışma alanında SQL Analytics Uç Noktasına bağlı kalır (örneğin, Geliştirme aşaması).
Veri kaynağı bağlantıları için Kayıtlı Kimlik Bilgileri yaklaşımı kullanıldığında otomatik bağlama desteklenmez. Daha fazla bilgi için, yukarıda açıklanan veri kaynağı kimlik doğrulama yöntemleri bölümüne bakın.