Databricks uygulaması dağıtma

Azure Databricks uygulamanızı oluşturup geliştirdikten sonra Azure Databricks çalışma alanında erişilebilir hale getirmek için dağıtın. Dağıtım uygulamanızı derler, bağımlılıkları yükler ve proje dosyalarınızda tanımlanan yapılandırmayı kullanarak çalıştırır. Azure Databricks kullanıcı arabirimini veya Databricks CLI'yi kullanarak uygulamaları dağıtabilirsiniz.

Uyarı

Bir şablondan uygulama oluşturursanız, Azure Databricks uygulamayı ilk oluşturduğunuzda otomatik olarak dağıtır. Ancak, daha sonra değişiklik yaptıktan sonra da yeniden dağıtabilirsiniz. Bkz. Şablondan Databricks uygulaması oluşturma.

Dağıtım mantığı

Databricks Apps, Python, Node.jsveya her ikisinin birleşimini kullanan uygulamaların dağıtılmasına destek olur. Bu, Python arka ucuna sahip Node.js ön ucu gibi esnek mimarilere olanak tanır.

Dağıtım sırasında derleme işlemi, Node.js kullanılıp kullanılmadığını belirlemek için uygulama dizininizin kökündeki bir package.json dosyayı denetler. Varsa Python adımlarının yanı sıra Düğüme özgü derleme adımlarını da içerir. Dağıtım mantığı şu deseni izler:

Eğer package.json varsa:

1. npm install komutunu çalıştırın
2. Çalıştır pip install -r requirements.txt (varsa)
3. npm run build çalıştırın (eğer build içinde package.json betiği tanımlanmışsa)
4. içinde app.yamlbelirtilen komutu çalıştırın veya npm run start herhangi bir komut belirtilmemişse

Uyarı

içinde app.yamlherhangi bir komut belirtilmezse, uygulama Python kodu içerse bile Azure Databricks npm run startkomutunu yürütür. Hem Python hem de Node.js işlemlerini çalıştıran bir özel start betik tanımlayın; bu betik, her ikisini birden başlatmak için concurrently gibi bir araç kullanır. Örneğin: concurrently "npm run start:node" "python my_app.py".

Eğer package.json mevcut değilse:

1. Çalıştır pip install -r requirements.txt (varsa)
2. içinde app.yamlbelirtilen komutu çalıştırın veya python <my-app>.py herhangi bir komut belirtilmemişse

Dağıtıma hazırlanma

Uygulamanızı dağıtmadan önce projenizin gerekli bileşenleri içerdiğini doğrulayın:

• Ana betik - app.py veya app.js gibi giriş noktası dosyanız.
• İsteğe bağlı app.yaml dosya - Uygulamanız özel bir komut veya ortam değişkenleri gerektiriyorsa, yürütmeyi yapılandırmak için bir app.yaml dosya ekleyin. Bkz Databricks uygulama yürütmesini app.yaml ile yapılandırma.
• Bağımlılıklar - Tüm bağımlılıkların kullanılabilir olduğundan emin olun. Bkz. Databricks uygulaması için bağımlılıkları yönetme.
• Gizli diziler veya ortam değerleri - içindeki envbölümünü kullanıyorsanızapp.yaml, başvuruda bulunan gizli dizilerin veya dış kaynakların doğru yapılandırıldığını ve erişilebilir olduğunu doğrulayın. Bkz. Databricks uygulamasına kaynak ekleme.

Ayrıca, app service sorumlusunun kaynak kod klasörüne erişimi olduğundan emin olun.

Dağıtım kaynağı seçme

Databricks uygulamalarını aşağıdaki kaynaklardan dağıtabilirsiniz:

• Çalışma alanı klasörü - Uygulama dosyalarını bir çalışma alanı klasörüne yükleyin ve oradan dağıtın. Bu, standart dağıtım yöntemidir.
• Git deposu - Bir uygulama için Git deposu yapılandırın ve çalışma alanına dosya yüklemeden doğrudan dağıtın. Uygulama, her dağıtımda yapılandırılmış Git referansından (dal, etiket veya işlem) kodu alır. GitHub, GitLab ve Bitbucket dahil olmak üzere tüm önemli Git sağlayıcıları desteklenir. Desteklenen sağlayıcıların tam listesi için bkz. Git sağlayıcınızı Databricks'e bağlama.

İstediğiniz zaman aynı uygulama için çalışma alanı ile Git kaynakları arasında geçiş yapabilirsiniz.

Uygulamayı dağıtma

Aşağıdaki bölümlerde çalışma alanı klasöründen veya doğrudan git deposundan nasıl dağıtılacağı açıklanmaktadır.

Çalışma alanı klasöründen dağıtım

Databricks kullanıcı arabirimi

Azure Databricks kullanıcı arabiriminden uygulama dağıtmak için:

1. Uygulama dosyalarını Azure Databricks çalışma alanınıza yükleyin. Yönergeler için bkz. Dosyayı içeri aktarma.
2. Kenar çubuğundaki tıklayın İşlem.
3. Uygulamalar sekmesine gidin ve Ad sütununda uygulamanızın bağlantısına tıklayın.
4. Dağıt'a tıklayın ve çalışma alanınızda uygulama dosyalarını yüklediğiniz klasörü seçin.
5. Seç'e ve ardından Dağıt'a tıklayın.
6. Yapılandırmayı gözden geçirin ve Dağıt'a tıklayın.

Databricks Komut Satırı Arayüzü (CLI)

CLI kullanarak uygulama dağıtmak için:

1. Bir terminal açın ve uygulama dosyalarınızı içeren dizine gidin.

2. komutunu kullanarak sync uygulama dosyalarınızı Azure Databricks çalışma alanına yükleyin. Yolu, dosyaları yüklemek istediğiniz çalışma alanının konumuna göre değiştirin.

   databricks sync --watch . /Workspace/Users/my-email@org.com/my-app
   

   bayrağı --watch , eşitleme işlemini çalışır durumda tutar ve dosyaları yerel olarak değiştirdiğinizde değişiklikleri otomatik olarak karşıya yükler. Belirli dosyaları veya dizinleri eşitlemenin dışında tutmak için bunları yerel uygulama dizininizdeki bir .gitignore dosyaya ekleyin. Dışlanması gereken yaygın dosyalar , node_modules/, .env, __pycache__/, ve tüm büyük veri dosyaları veya derleme yapıtlarıdır.DS_Store.

3. Çalışma alanınızdaki dosyaları görüntüleyerek yüklemeyi doğrulayın. Kenar çubuğunda Çalışma Alanı'na tıklayın ve uygulamanız için oluşturduğunuz dizine gidin.

4. Aşağıdaki komutu çalıştırarak uygulamayı dağıtın. Uygulama adını ve kaynak kodu yolunu değerlerinizle değiştirin.

   databricks apps deploy my-app-name \
      --source-code-path /Workspace/Users/my-email@org.com/my-app
   

   CLI dağıtım ilerleme durumunu görüntüler ve uygulamanın ne zaman çalıştığını onaylar.

Git deposundan dağıtma

Önemli

Bu özellik Beta sürümündedir. Bir yönetici özelliği devre dışı bırakırsa Git'ten dağıtılan mevcut uygulamalar çalışmaya devam eder, ancak önizlemeyi yeniden etkinleştirene veya depoyu uygulamadan kaldırana kadar bunları yeniden dağıtamaz veya yeniden başlatamazsınız.

Git deposundan uygulama dağıtmak için, depoyu uygulama düzeyinde ekleyin ve dağıttığınızda Git başvurusunu belirtin. Git deponuz , bağımlılıkları ve giriş noktası gibi app.yamluygulama dosyalarını içermelidir. GitHub, GitLab ve Bitbucket dahil olmak üzere tüm önemli Git sağlayıcıları desteklenir.

Git'ten bir uygulamayı yapılandırmak ve dağıtmak için:

1. Uygulama dosyalarınızı bir Git deposuna yükleyin.
2. Azure Databricks çalışma alanınızda kenar çubuğunda tıklayın.
3. Uygulamalar sekmesine gidin ve düzenlemek üzere mevcut bir uygulamayı seçin veya Uygulama oluştur'a tıklayın.
4. Git deposunu yapılandır adımında Git deposu URL'sini (örneğin, https://github.com/org/repo) girin ve bir Git sağlayıcısı seçin.
5. Uygulama ayrıntıları sayfasına dönmek için Uygulama oluştur'a veya Kaydet'e tıklayın.
6. Özel depolar için, uygulamanın hizmet sorumlusunun bir Git kimlik bilgisi yapılandırılmış olmalıdır. Uygulama ayrıntıları sayfasında Git kimlik bilgilerini yapılandır'a tıklayın. Alternatif olarak, uygulamayı düzenleyin ve Git deposunu yapılandırma adımına kimlik bilgilerini ekleyin. Git kimlik bilgisi eklemek için uygulamada izinlere sahip CAN MANAGE olmanız gerekir. Her sağlayıcıyla ilgili yönergeler için bkz. Git sağlayıcınızı Databricks'e bağlama.

Önemli

Azure Databricks, güvenlik için dağıtım kaynağını (Git'ten çalışma alanına veya çalışma alanından Git'e) veya Git deposunu değiştirdiğinizde uygulamanın hizmet sorumlusuyla ilişkili tüm Git kimlik bilgilerini siler. Yalnızca Git başvurusu değiştirildiğinde kimlik bilgileri silinmez. Dağıtım kaynağını veya deposunu değiştirdikten sonra Git kimlik bilgilerini Git'ten dağıtmak üzere yeniden yapılandırmanız gerekir.

Uyarı

Uygulama oluşturucuları, hizmet sorumlusu üzerindeki izinleri yalnızca Git dağıtımı Beta özelliği etkinleştirildiğinde otomatik olarak alır CAN MANAGE . Özellik devre dışı bırakıldığı sırada bir uygulama oluşturduysanız Git kimlik bilgisi ekleme izniniz olmayabilir.

Hizmet sorumluları sağlayıcı başına bir Git kimlik bilgilerini destekler. Hesap konsolu gibi bir kimlik bilgilerinin güncelleştirilmesi, söz konusu sağlayıcının mevcut kimlik bilgilerinin yerini alır ve söz konusu hizmet sorumlusunu bu sağlayıcıyla birlikte kullanan tüm uygulamaları etkiler.

Ardından uygulamayı dağıtın:

1. Uygulama ayrıntıları sayfasında Dağıt'a tıklayın.
2. Git'ten'i seçin.
3. Git başvurusu için dal adını, etiketi veya işlem SHA'sını (örneğin, main, v1.0.0 veya işleme karması) girin.
4. Başvuru türü için dal, etiket veya işleme gibi başvuru türünü belirtin.
5. Dağıt’a tıklayın.

Dal veya etiket başvuruları için Azure Databricks bu dal veya etiketin en son değişikliğini dağıtır. Commit SHA referansları için, Azure Databricks her zaman bu belirli commit'i dağıtır. Hizmet sorumlusunun Git kimlik bilgisi geçersizse veya süresi dolduysa dağıtım başarısız olur.

Dağıtım sonrası davranış

Dağıtım tamamlandıktan sonra Azure Databricks, dosyanızda tanımlanan command'ye göre uygulamanızı başlatır veya varsayılan olarak python app.py komutunu çalıştırır. Uygulama ayrıntıları sayfası geçerli durumu gösterir ve günlüklere, dağıtım geçmişine ve ortam bilgilerine erişim sağlar.

Dağıtılan uygulamanın çıkışını görüntülemek için uygulama bağlantısına tıklayın.

Hata ayıklama ve çalışma zamanı izleme için Günlükler sekmesine gidin. Bkz . Databricks Uygulamaları için Günlüğe Kaydetme ve İzleme.

Uygulamayı güncelleştirme veya yeniden dağıtma

Kaynak kodunda veya yapılandırmada değişiklik yaptıktan sonra uygulamanızı yeniden dağıtin. Yeniden dağıtım, uygulamayı yeniden oluşturmadan en son güncelleştirmelerinizi uygular. İstediğiniz zaman çalışma alanından veya Git deposundan yeniden dağıtabilirsiniz.

Çalışma alanı klasöründen yeniden dağıtma

Çalışma alanı klasöründen yeniden dağıtmak için:

1. Çalışma alanı klasöründeki uygulama dosyalarınızı güncelleştirin.
2. Uygulamayı seçin ve Dağıt'a tıklayın.
3. Kaynak kod yolu değiştiyse veya git kaynağından geçiş yaptığınızda Dağıt'ın yanındaki oka tıklayın ve Farklı bir kaynak kullanarak dağıt'ı seçin.

Git deposundan yeniden dağıtma

Git deposundan yeniden dağıtmak için:

1. Değişikliklerinizi Git deposuna gönderin.
2. Azure Databricks çalışma alanınızda uygulamanızı seçin ve Dağıt'a tıklayın.
3. Git başvurusu değiştiyse veya çalışma alanı kaynağından geçiş yaptığınızda Dağıt'ın yanındaki oka tıklayın ve Farklı bir kaynak kullanarak dağıt'ı seçin.

Git deposunu veya kimlik bilgilerini değiştirmek için uygulama yapılandırmasını düzenleyin. Uygulamadan Git deposunu kaldırmak, çalışma alanından dağıtımı zorlar.

Önemli

Git deposunu değiştirmek veya dağıtım kaynakları (Git ve çalışma alanı) arasında geçiş yapmak, uygulamanın hizmet sorumlusu için tüm Git kimlik bilgilerini siler. Git'ten yeniden dağıtmadan önce kimlik bilgilerini yeniden yapılandırmanız gerekir.

Dağıtım sorunlarını giderme

Uygulamanız dağıtılamazsa veya beklendiği gibi çalışmazsa aşağıdaki sorun giderme adımlarını deneyin:

• Hata iletileri veya çalışma zamanı çıktısı için günlükleri denetleyin.
• Söz dizimlerini ve ayarları doğrulayın app.yaml .
• env bölümündeki gizli bilgilerin ve ortam değişkenlerinin düzgün çözümlendiğini doğrulayın.
• Tüm gerekli bağımlılıkların dahil edildiğini veya yüklendiğini onaylayın.

Git deposu dağıtımları için:

• Özel depolar için, uygulamanın hizmet sorumlusunun yapılandırılmış bir Git kimlik bilgisi olduğunu doğrulayın.
• Git deposu URL'sinin doğru olduğunu doğrulayın.
• Depoda Git başvurusunun (dal, etiket veya işleme) var olduğunu doğrulayın.

Sonraki Adımlar

• Databricks Uygulamaları için Loglama ve İzleme
• Databricks uygulaması için izinleri yapılandırma
• Ile Databricks uygulama yürütmesini yapılandırma app.yaml