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 Azure 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.

Uygulamayı dağıtma

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.

Dağıtıldıktan sonra Azure Databricks, command dosyanızda tanımlanan app.yaml'ye göre uygulamanızı başlatır veya varsayılan olarak python app.py çalıştırır.

Dağıtım sonrası davranış

Dağıtım tamamlandıktan sonra Azure Databricks uygulamanızı yönetilen bir ortamda başlatı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 kodda değişiklik yaptıysanız, dosyayı güncelleştirdiyseniz veya farklı bir kaynak kodu yolundan app.yaml dağıtmanız gerekiyorsa uygulamanızı güncelleştirmek veya yeniden dağıtmak isteyebilirsiniz. Yeniden dağıtma, uygulamayı sıfırdan yeniden oluşturmanıza gerek kalmadan en son güncelleştirmelerinizi uygular.

Dağıtılan uygulamada değişiklik yapmak için:

1. Uygulama kodunuzu veya app.yaml yapılandırmanızı güncelleştirin.
2. Azure Databricks çalışma alanında Uygulamalar sayfasına dönün.
3. Uygulamanızı seçin ve yeniden Dağıt'ı seçin. Kaynak kod yolu değiştiyse Dağıt'ın yanındaki oka tıklayın ve Farklı kaynak kodu yolu kullanarak dağıt'ı seçin.

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:

• Günlükleri denetleme - Günlükler panelinde hata iletilerini veya çalışma zamanı çıkışını görüntüleyin.
• Doğrulamak app.yaml - Söz diziminin doğru olduğundan ve desteklenen ayarların kullanıldığından emin olun.
• Gizli anahtarları ve ortam değişkenlerini doğrulayın - env bölümündeki tüm başvuruların düzgün çözümlendiğinden emin olun.
• Bağımlılıkları onaylama - Tüm gerekli paketlerin eklendiğinden veya yüklendiğinden emin olun.

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