Yaşam döngüsü yönetimi en iyi yöntemleri

Bu makale, Microsoft Fabric'te yaşam döngüsü boyunca içeriklerini yöneten veri ve analiz oluşturucuları için rehberlik sağlar. Makale, bir yayın aracı olarak kaynak denetimi ve dağıtım işlem hatları için Git tümleştirmesinin kullanımına odaklanır. Kurumsal içerik yayımlama, Kurumsal içerik yayımlama hakkında genel bir kılavuz için.

Önemli

Bu özellik önizleme aşamasındadır.

Makale dört bölüme ayrılmıştır:

  • İçerik hazırlama - İçeriğinizi yaşam döngüsü yönetimi için hazırlayın.

  • Geliştirme - Dağıtım işlem hatları geliştirme aşamasında içerik oluşturmanın en iyi yolları hakkında bilgi edinin.

  • Test - Ortamınızı test etmek için dağıtım işlem hatları test aşamasının nasıl kullanılacağını anlayın.

  • Üretim - İçeriğinizi tüketim için kullanılabilir hale getirmek için bir dağıtım işlem hatları üretim aşamasından yararlanın.

İçerik hazırlama

İçeriğinizi yaşam döngüsü boyunca devam eden yönetime en iyi şekilde hazırlamak için, önce bu bölümdeki bilgileri gözden geçirin:

  • İçeriği üretim ortamına bırakın.

  • Belirli bir çalışma alanı için dağıtım işlem hattı kullanmaya başlayın.

Ekipler arasında ayrı geliştirme

Kuruluştaki farklı ekipler, aynı proje üzerinde çalışırken bile genellikle farklı uzmanlık, sahiplik ve çalışma yöntemlerine sahiptir. Her takıma istedikleri gibi çalışabilmeleri için bağımsızlığını verirken sınırlar belirlemek önemlidir. Farklı ekipler için ayrı çalışma alanları olmasını göz önünde bulundurun. Ayrı çalışma alanlarıyla her ekip farklı izinlere sahip olabilir, farklı kaynak denetimi depolarıyla çalışabilir ve içeriği farklı bir tempoda üretime sevk edebilir. Çoğu öğe çalışma alanları arasında verilere bağlanabilir ve verileri kullanabilir, bu nedenle aynı veri ve proje üzerinde işbirliğini engellemez.

İzin modelinizi planlama

Hem Git tümleştirmesi hem de dağıtım işlem hatları yalnızca çalışma alanı izinlerinden farklı izinler gerektirir. Git tümleştirme ve dağıtım işlem hatları için izin gereksinimleri hakkında bilgi edinin.

Güvenli ve kolay bir iş akışı uygulamak için, hem Git deposu hem de bir işlem hattındaki geliştirme/test/üretim aşamaları olmak üzere kullanılan ortamların her bölümüne kimlerin erişildiğini planlayın. Dikkate alınması gereken bazı noktalar şunlardır:

  • Git deposundaki kaynak koduna kimlerin erişimi olmalıdır?

  • İşlem hattı erişimi olan kullanıcılar her aşamada hangi işlemleri gerçekleştirebilmelidir?

  • Test aşamasında içeriği kimler gözden geçiriyor?

  • Test aşaması gözden geçirenlerinin işlem hattına erişimi olmalıdır mı?

  • Üretim aşamasına dağıtımı kim denetlemelidir?

  • İşlem hattına hangi çalışma alanını atayın veya Git'e bağlanın?

  • Çalışma alanını hangi dala bağlıyorsunuz? Bu dal için tanımlanan ilke nedir?

  • Çalışma alanı birden çok ekip üyesi tarafından paylaşılıyor mu? Doğrudan çalışma alanında mı yoksa yalnızca Çekme istekleri aracılığıyla mı değişiklik yapmalılar?

  • Çalışma alanınızı hangi aşamaya atayacaksınız?

  • Atadığınız çalışma alanının izinlerinde değişiklik yapmanız gerekiyor mu?

Farklı veritabanlarına farklı aşamalar Bağlan

Üretim veritabanı her zaman kararlı ve kullanılabilir olmalıdır. Geliştirme veya test anlam modelleri için IŞ ZEKAsı oluşturucuları tarafından oluşturulan sorgularla aşırı yüklememek en iyisidir. Üretim verilerini korumak ve geliştirme veritabanını üretim verilerinin tamamıyla aşırı yüklememek için geliştirme ve test için ayrı veritabanları oluşturun.

Aşamalar arasında değişecek yapılandırmalar için parametreleri kullanma

Mümkün olduğunda geliştirme/test/üretim aşamaları arasında değişebilecek herhangi bir tanıma parametre ekleyin. Parametreleri kullanmak, değişikliklerinizi üretim ortamına taşıdığınızda tanımları kolayca değiştirmenize yardımcı olur. Doku'da parametreleri yönetmenin birleşik bir yolu olmasa da, bunu herhangi bir parametreleştirme türünü destekleyen öğelerde kullanmanızı öneririz. Parametrelerin veri kaynaklarına veya Doku'daki iç öğelere bağlantı tanımlama gibi farklı kullanımları vardır. Sorgularda, filtrelerde ve kullanıcılara görüntülenen metinde değişiklik yapmak için de kullanılabilirler.
Dağıtım işlem hatlarında, her dağıtım aşaması için farklı değerler ayarlamak üzere parametre kurallarını yapılandırabilirsiniz.

Geliştirme

Bu bölümde, dağıtım işlem hatlarıyla çalışmaya ve geliştirme aşamanıza uygun kullanımınıza yönelik yönergeler sağlanır.

Çalışmanızı git deposuna yedekleme

Git tümleştirmesi sayesinde tüm geliştiriciler git'e işleyerek çalışmalarını yedekleyebilir. Doku'da çalışmanızı düzgün bir şekilde yedeklemek için bazı temel kurallar şunlardır:

  • Başkalarının işlenmeden önce çalışmanızı geçersiz kılmaması için çalışmanız gereken yalıtılmış bir ortamınız olduğundan emin olun. Bu, bir Masaüstü aracında (VS Code, Power BI Desktop veya diğerleri gibi) veya diğer kullanıcıların erişebildiği ayrı bir çalışma alanında çalışmak anlamına gelir.

  • Oluşturduğunuz ve başka hiçbir geliştiricinin kullanmadığını bir dala işleyin. Çalışma alanını yazma ortamı olarak kullanıyorsanız dallarla çalışma hakkında bilgi edinin.

  • Birlikte dağıtılması gereken değişiklikleri birlikte işleyin. Bu öneri, tek bir öğe veya aynı değişiklikle ilgili birden çok öğe için geçerlidir. Tüm ilgili değişikliklerin birlikte işlenmesi, daha sonra diğer aşamalara dağıtım yaparken, çekme istekleri oluştururken veya değişiklikleri geri alırken size yardımcı olabilir.

  • Büyük işlemeler maksimum işleme boyutu sınırına ulaşabilir. Birlikte işlediğiniz öğe sayısına veya bir öğenin genel boyutuna dikkat edin. Örneğin, büyük görüntüler eklenirken raporlar büyüyebilir. İşe yarasa bile büyük boyutlu öğeleri kaynak denetim sistemlerinde depolamak kötü bir uygulamadır. Görüntü gibi çok fazla statik kaynağı varsa öğelerinizin boyutunu küçültmenin yollarını göz önünde bulundurun.

Değişiklikleri geri döndürme

Çalışmanızı yedekledikten sonra, önceki bir sürüme geri dönüp çalışma alanına geri yüklemek istediğiniz durumlar olabilir. Önceki sürüme geri dönmenin birkaç yolu vardır:

  • Geri Al düğmesi: Geri Al işlemi, henüz işlenmedikleri sürece yaptığınız değişiklikleri geri döndürmenin kolay ve hızlı bir yoludur. Ayrıca her öğeyi ayrı ayrı geri alabilirsiniz. Geri alma işlemi hakkında daha fazla bilgi edinin.

  • Eski işlemelere geri dönme: Kullanıcı arabiriminde önceki işlemeye geri dönmenin doğrudan bir yolu yoktur. En iyi seçenek, git geri döndürme veya git sıfırlama kullanarak eski bir işlemeyi HEAD olarak yükseltmektir. Bunu yaptığınızda, kaynak denetim bölmesinde bir güncelleştirme olduğunu ve çalışma alanını bu yeni işlemeyle güncelleştirebileceğiniz gösterilir.

Veriler Git'te depolanmadığından, bir veri öğesini eski bir sürüme döndürmenin mevcut verileri bozabileceğini ve verileri bırakmanızı gerektirebileceğini veya işlemin başarısız olabileceğini unutmayın. Değişiklikleri geri döndürmeden önce bunu önceden denetleyin.

'Özel' çalışma alanıyla çalışma

Yalıtılmış olarak çalışmak istediğinizde, ayrı bir çalışma alanını yalıtılmış bir ortam olarak kullanın. Dallarla çalışırken iş ortamınızı yalıtma hakkında daha fazla bilgi edinin. Siz ve ekip için en uygun iş akışı için aşağıdaki noktaları göz önünde bulundurun:

  • Çalışma alanını ayarlama: Başlamadan önce, yeni bir çalışma alanı (henüz yoksa) oluşturabildiğinizden, bunu bir Doku kapasitesine atayabileceğinizden ve çalışma alanınızda çalışmak üzere verilere erişebildiğinizden emin olun.

  • Yeni dal oluşturma: İçeriğinizin en güncel sürümüne sahip olmak için ana daldan yeni bir dal oluşturun. Ayrıca, doğru içeriği çalışma alanına çekebilmek için daldaki doğru klasöre bağlandığınızdan emin olun.

  • Küçük, sık yapılan değişiklikler: Birleştirmesi kolay ve çakışmalara girme olasılığı daha düşük olan küçük artımlı değişiklikler yapmak git için en iyi yöntemdir. Bu mümkün değilse, önce çakışmaları kendi başınıza çözebilmeniz için dalınızı main'dan güncelleştirdiğinizden emin olun.

  • Yapılandırma değişiklikleri: Gerekirse, daha üretken çalışmanıza yardımcı olması için çalışma alanınızdaki yapılandırmaları değiştirin. Bazı değişiklikler öğeler arasındaki bağlantıyı veya farklı veri kaynaklarıyla veya belirli bir öğedeki parametrelerde yapılan değişiklikleri içerebilir. İşlediğiniz her şeyin işlemenin bir parçası olduğunu ve yanlışlıkla ana dalda birleştirilebileceğini unutmayın.

çalışmanızı düzenlemek için İstemci araçlarını kullanma

Bunu destekleyen öğeler ve araçlar için anlamsal modeller ve raporlar için Power BI Desktop, Not Defterleri için VSCode gibi yazma için istemci araçlarıyla çalışmak daha kolay olabilir. Bu araçlar yerel geliştirme ortamınız olabilir. Çalışmanızı tamamladıktan sonra değişiklikleri uzak depoya gönderin ve değişiklikleri karşıya yüklemek için çalışma alanını eşitleyin. Yalnızca, yazmakta olduğunuz öğenin desteklenen yapısıyla çalıştığınızdan emin olun. Emin değilseniz, önce çalışma alanıyla eşitlenmiş içeriği olan bir depoyu kopyalayın, ardından yapının zaten bulunduğu yerden yazmaya başlayın.

Çalışma alanlarını ve dalları yönetme

Çalışma alanı aynı anda yalnızca tek bir dala bağlanabildiğinden, bunu 1:1 eşlemesi olarak kabul etmek önerilir. Ancak, gerektirdiği çalışma alanı miktarını azaltmak için şu seçenekleri göz önünde bulundurun:

  • Bir geliştirici tüm gerekli yapılandırmalarla özel bir çalışma alanı ayarladıysa, bu çalışma alanını gelecekteki tüm dallar için kullanmaya devam edebilir. Sprint bittiğinde, değişiklikleriniz birleştirilir ve yeni bir görev başlatırsınız, bağlantıyı aynı çalışma alanında yeni bir dala geçmeniz yeter. Sprint'in ortasında bir hatayı aniden düzeltmeniz gerekiyorsa da bunu yapabilirsiniz. Bunu web üzerinde çalışan bir dizin olarak düşünün.

  • İstemci aracı (VS Code, Power BI Desktop veya diğerleri gibi) kullanan geliştiricilerin çalışma alanına ihtiyacı yoktur. Dallar oluşturabilir ve bu dalda değişiklikleri yerel olarak işleyebilir, bunları uzak depoya gönderebilir ve ana dala bir çekme isteği oluşturabilir ve bunların tümü çalışma alanı olmadan yapılabilir. Çalışma alanı, her şeyin gerçek hayattaki bir senaryoda çalışıp çalışmadığını denetlemek için yalnızca test ortamı olarak gereklidir. Bunun ne zaman gerçekleşeceğine karar vermek size kalmış.

Git deposundaki bir öğeyi yineleme

Git deposundaki bir öğeyi çoğaltmak için:

  1. Öğe dizininin tamamını kopyalayın.
  2. logicalId değerini bu bağlı çalışma alanı için benzersiz bir değerle değiştirin.
  3. Özgün öğeden ayırt etmek ve yinelenen görünen ad hatasından kaçınmak için görünen adı değiştirin.
  4. Gerekirse, mantıksal kimliği güncelleştirin ve/veya bağımlılıklardaki adları görüntüleyin.

Test etme

Bu bölüm, dağıtım işlem hatları test aşamasıyla çalışmaya yönelik rehberlik sağlar.

Üretim ortamınızın simülasyonunu oluşturun

Önerdiğiniz değişikliğin üretim aşamasını nasıl etkilediğini görmek önemlidir. Dağıtım işlem hatları test aşaması, test amacıyla gerçek bir üretim ortamının benzetimini yapmanızı sağlar. Alternatif olarak, Git'i başka bir çalışma alanına bağlayarak bunun benzetimini yapabilirsiniz.

Bu üç faktörün test ortamınızda ele alındığından emin olun:

  • Veri hacmi

  • Kullanım hacmi

  • Üretimdekine benzer bir kapasite

Test ederken, üretim aşamasıyla aynı kapasiteyi kullanabilirsiniz. Ancak aynı kapasiteyi kullanmak, yük testi sırasında üretimi kararsız hale getirebilir. Kararsız üretimden kaçınmak için, kaynaklarda üretim kapasitesine benzer farklı bir kapasite kullanarak test edin. Ek maliyetlerden kaçınmak için yalnızca test süresi için ödeme yapabileceğiniz bir kapasite kullanın.

Üretim ortamının benzetimini bir test ortamıyla birlikte bir dağıtım işlem hattını gösteren diyagram.

Dağıtım kurallarını gerçek hayattaki veri kaynağıyla kullanma

Gerçek hayattaki veri kullanımını simüle etmek için test aşamasını kullanıyorsanız, geliştirme ve test veri kaynaklarını birbirinden ayırmak en iyisidir. Geliştirme veritabanı görece küçük olmalı ve test veritabanı üretim veritabanına olabildiğince benzer olmalıdır. Test aşamasında veri kaynakları arasında geçiş yapmak veya dağıtım işlem hatlarında çalışmıyorsa bağlantıyı parametreleştirmek için veri kaynağı kurallarını kullanın.

Yaptığınız değişiklikler bağımlı öğeleri de etkileyebilir. Test sırasında, değişikliklerinizin güncelleştirilen öğelere bağımlı olabilecek mevcut öğelerin performansını etkilemediğini veya bozmadığını doğrulayın.

Etki analizini kullanarak ilgili öğeleri kolayca bulabilirsiniz.

Veri öğelerini güncelleştirme

Veri öğeleri, verileri depolayan öğelerdir. Git'teki öğenin tanımı, verilerin nasıl depolandığını tanımlar. Çalışma alanında bir öğeyi güncelleştirirken tanımı çalışma alanına aktarıyor ve mevcut verilere uyguluyoruz. Veri öğelerini güncelleştirme işlemi Git ve dağıtım işlem hatları için aynıdır.

Tanımda değişiklikler uygulandığında verilerin saklanması söz konusu olduğunda farklı öğeler farklı özelliklere sahip olduğundan, değişiklikleri uygularken dikkatli olun. Değişiklikleri en güvenli şekilde uygulamanıza yardımcı olabilecek bazı uygulamalar:

  • Değişikliklerin ne olduğunu ve mevcut veriler üzerindeki etkilerini önceden bilin. Yapılan değişiklikleri açıklamak için işleme iletilerini kullanın.

  • Bu öğenin test verileriyle değişikliği nasıl işlediğini görmek için değişiklikleri önce geliştirme veya test ortamına yükleyin.

  • Her şey yolunda giderse üretimdeki beklenmeyen davranışları en aza indirmek için hazırlama ortamında gerçek zamanlı verileri (veya mümkün olduğunca yakın) denetlemenizi öneririz.

  • Verileri kullanan işletme kullanıcılarınıza herhangi bir hatanın neden olabileceği zararı en aza indirmek için Prod ortamını güncelleştirirken en iyi zamanlamayı göz önünde bulundurun.

  • Dağıtımdan sonra, her şeyin beklendiği gibi çalıştığını doğrulamak için Prod'da dağıtım sonrası testleri yapılır.

  • Bazı değişiklikler her zaman hataya neden olan değişiklikler olarak kabul edilir. Umarım önceki adımlar üretimden önce bunları izlemenize yardımcı olur. Prod'daki değişiklikleri uygulamak ve verileri kurtararak normal duruma geri dönmek ve iş kullanıcıları için kapalı kalma süresini en aza indirmek için bir plan oluşturun.

Uygulamanızı test etme

Bir uygulama aracılığıyla müşterilerinize içerik dağıtıyorsanız, üretime geçmeden önce uygulamanın yeni sürümünü gözden geçirin. Her dağıtım işlem hattı aşamasının kendi çalışma alanı olduğundan, geliştirme ve test aşamaları için uygulamaları kolayca yayımlayabilir ve güncelleştirebilirsiniz. Uygulamaları yayımlama ve güncelleştirme, uygulamayı son kullanıcının bakış açısından test etmenizi sağlar.

Önemli

Dağıtım işlemi, uygulama içeriğini veya ayarlarını güncelleştirmeyi içermez. İçerik veya ayarlarda değişiklik uygulamak için uygulamayı gerekli işlem hattı aşamasında el ile güncelleştirin.

Üretim

Bu bölümde dağıtım işlem hatları üretim aşamasına yönelik yönergeler sağlanır.

Üretime kimlerin dağıtım yapabileceklerini yönetme

Üretime dağıtma işlemi dikkatli bir şekilde ele alınacağından, bu hassas işlemi yalnızca belirli kişilerin yönetmesine izin vermek iyi bir uygulamadır. Ancak, büyük olasılıkla belirli bir çalışma alanının tüm IŞ ZEKAsı oluşturucularının işlem hattına erişmesini istersiniz. Erişim izinlerini yönetmek için üretim çalışma alanı izinlerini kullanın. Diğer kullanıcılar çalışma alanındaki içeriği görmek için üretim çalışma alanı görüntüleyici rolüne sahip olabilir, ancak Git veya dağıtım işlem hatlarından değişiklik yapamaz.

Ayrıca, yalnızca içerik oluşturma işleminin parçası olan kullanıcıların izinlerini etkinleştirerek depoya veya işlem hattına erişimi sınırlayın.

Üretim aşaması kullanılabilirliğini sağlamak için kurallar ayarlama

Dağıtım kuralları , üretimdeki verilerin her zaman bağlı ve kullanıcılar tarafından kullanılabilir olmasını sağlamanın güçlü bir yoludur. Dağıtım kuralları uygulandığında, müşterilerin ilgili bilgileri sorunsuz bir şekilde görebileceği güvencesine sahip olurken dağıtımlar çalıştırılabilir.

Anlam modelinde tanımlanan veri kaynakları ve parametreler için üretim dağıtım kuralları ayarladığınızdan emin olun.

Üretim uygulamasını güncelleştirme

Kullanıcı arabirimi aracılığıyla işlem hattındaki dağıtım, çalışma alanı içeriğini güncelleştirir. İlişkili uygulamayı güncelleştirmek için dağıtım işlem hatları API'sini kullanın. Uygulamayı kullanıcı arabirimi aracılığıyla güncelleştirmek mümkün değildir. İçerik dağıtımı için bir uygulama kullanıyorsanız, son kullanıcıların en son sürümü hemen kullanabilmesi için üretime dağıtıldıktan sonra uygulamayı güncelleştirmeyi unutmayın.

Git dallarını kullanarak üretime dağıtma

Depo 'tek gerçeklik kaynağı' olarak görev yapacağından, bazı takımlar güncelleştirmeleri doğrudan Git'ten farklı aşamalara dağıtmak isteyebilir. Bu, Birkaç önemli nokta ile Git tümleştirmesi ile mümkündür:

  • Yayın dallarını kullanmanızı öneririz. Her dağıtımdan önce çalışma alanının yeni yayın dallarına olan bağlantısını sürekli değiştirmeniz gerekir.

  • Derleme veya yayın işlem hattınız kaynak kodu değiştirmenizi veya çalışma alanına dağıtımdan önce derleme ortamında betik çalıştırmanızı gerektiriyorsa, çalışma alanını Git'e bağlamak size yardımcı olmaz.

  • Her aşamaya dağıtıldıktan sonra, o aşamaya özgü tüm yapılandırmayı değiştirdiğinizden emin olun.

İçerik için hızlı düzeltmeler

Bazen üretimde hızlı düzeltme gerektiren sorunlar olabilir. Düzeltmeyi önce test etmeden dağıtmak kötü bir uygulamadır. Bu nedenle, düzeltmeyi her zaman geliştirme aşamasında uygulayın ve dağıtım işlem hattı aşamalarının geri kalanına itin. Geliştirme aşamasına dağıtmak, düzeltmeyi üretime dağıtmadan önce çalışıp çalışmadığını denetlemenizi sağlar. İşlem hattı genelinde dağıtım yalnızca birkaç dakika sürer.

Git'ten dağıtım kullanıyorsanız Git dallanma stratejisini benimseme başlığında açıklanan uygulamaları izlemenizi öneririz.