Partager via

Déployer une application Databricks

Après avoir créé et développé votre application Azure Databricks, déployez-la pour la rendre accessible dans l’espace de travail Azure Databricks. Le déploiement génère votre application, installe des dépendances et l’exécute à l’aide de la configuration définie dans vos fichiers projet. Vous pouvez déployer des applications à l’aide de l’interface utilisateur Azure Databricks ou d’Azure Databricks CLI.

Remarque

Si vous créez une application à partir d’un modèle, Azure Databricks la déploie automatiquement lorsque vous la créez pour la première fois. Toutefois, vous pouvez toujours le redéployer ultérieurement après avoir apporté des modifications. Consultez Créer une application Databricks à partir d’un modèle.

Logique de déploiement

Databricks Apps prend en charge le déploiement d’applications qui utilisent Python, Node.jsou une combinaison des deux. Cela permet des architectures flexibles, telles qu’un front-end Node.js avec un back-end Python.

Pendant le déploiement, le processus de génération recherche un package.json fichier à la racine du répertoire de votre application pour déterminer si Node.js est utilisé. S'il est présent, il inclut des étapes de construction spécifiques à Node.js ainsi que des étapes Python. La logique de déploiement suit ce modèle :

S’il package.json est présent :

  1. Exécutez npm install
  2. Exécuter pip install -r requirements.txt (s’il existe)
  3. Exécuter npm run build (si un build script est défini dans package.json)
  4. Exécutez la commande spécifiée dans app.yaml, ou npm run start si aucune commande n’est spécifiée

Remarque

Si aucune commande n’est spécifiée, app.yamlAzure Databricks npm run starts’exécute, même si l’application inclut du code Python. Pour exécuter à la fois Python et Node.js processus, définissez un script personnalisé start qui utilise un outil comme concurrently pour lancer les deux. Par exemple : concurrently "npm run start:node" "python my_app.py".

Si package.json n’est pas présent :

  1. Exécuter pip install -r requirements.txt (s’il existe)
  2. Exécutez la commande spécifiée dans app.yaml, ou python <my-app>.py si aucune commande n’est spécifiée

Préparer le déploiement

Avant de déployer votre application, vérifiez que votre projet inclut les composants nécessaires :

En outre, assurez-vous que le service principal de l'application a accès au dossier de code source.

Déployer l’application

Interface utilisateur Databricks

Pour déployer une application à partir de l’interface utilisateur Azure Databricks :

  1. Chargez les fichiers d’application dans votre espace de travail Azure Databricks. Pour obtenir des instructions, consultez Importer un fichier.
  2. Cliquez sur icône de calculCalcul dans la barre latérale.
  3. Accédez à l’onglet Applications , puis cliquez sur le lien vers votre application dans la colonne Nom .
  4. Cliquez sur Déployer et sélectionnez le dossier dans votre espace de travail où vous avez chargé les fichiers d’application.
  5. Cliquez sur Sélectionner, puis Déployer.
  6. Passez en revue la configuration, puis cliquez sur Déployer.

Interface CLI de Databricks

Pour déployer une application à l’aide de l’interface CLI :

  1. Ouvrez un terminal et accédez au répertoire qui contient vos fichiers d’application.

  2. Chargez vos fichiers d’application dans l’espace de travail Azure Databricks à l’aide de la sync commande. Remplacez le chemin d’accès par l’emplacement de l’espace de travail où vous souhaitez charger les fichiers.

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

    L’indicateur --watch conserve le processus de synchronisation en cours d’exécution et charge automatiquement les modifications lorsque vous modifiez des fichiers localement. Pour exclure des fichiers ou répertoires spécifiques de la synchronisation, ajoutez-les à un .gitignore fichier dans votre répertoire d’application local. Les fichiers courants à exclure sont node_modules/, , .env__pycache__/, .DS_Storeet tous les fichiers de données volumineux ou artefacts de build.

  3. Vérifiez le chargement en affichant les fichiers dans votre espace de travail. Cliquez sur l'icône Espace de travail dans la barre latérale et accédez au répertoire que vous avez créé pour votre application.

  4. Déployez l’application en exécutant la commande suivante. Remplacez le nom de l’application et le chemin du code source par vos valeurs.

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

    L’interface CLI affiche la progression du déploiement et confirme l’exécution de l’application.

Une fois déployé, Azure Databricks démarre votre application en fonction de la valeur définie command dans votre app.yaml fichier ou des valeurs par défaut en cours d’exécution python app.py.

Comportement après le déploiement

Une fois le déploiement terminé, Azure Databricks démarre votre application dans un environnement managé. La page détails de l’application affiche l’état actuel et fournit l’accès aux journaux, à l’historique du déploiement et aux informations d’environnement.

Afficher la page de détails de l’application après le déploiement de l’application

Pour afficher la sortie de l’application déployée, cliquez sur le lien de l’application.

Accédez à l’onglet Journaux pour le débogage et la surveillance du runtime. Consultez la journalisation et la surveillance des applications Databricks.

Mettre à jour ou redéployer l’application

Vous pouvez mettre à jour ou redéployer votre application si vous avez apporté des modifications au code source, mis à jour le app.yaml fichier ou avoir besoin de déployer à partir d’un autre chemin de code source. Le redéploiement applique vos dernières mises à jour sans avoir à recréer l’application à partir de zéro.

Pour apporter des modifications à une application déployée :

  1. Mettez à jour le code de votre application ou la configuration app.yaml.
  2. Revenez à la page Applications de l’espace de travail Azure Databricks.
  3. Sélectionnez votre application et choisissez Déployer à nouveau. Si le chemin du code source a changé, cliquez sur la flèche en regard de Déployer et sélectionnez Déployer à l’aide d’un autre chemin de code source.

Résoudre les problèmes de déploiement

Si votre application ne parvient pas à déployer ou ne s’exécute pas comme prévu, essayez les étapes de résolution des problèmes suivantes :

  • Vérifier les journaux - Afficher les messages d’erreur ou la sortie du runtime dans le panneau de journaux.
  • Valider app.yaml - Vérifiez que la syntaxe est correcte et que les paramètres pris en charge sont utilisés.
  • Vérifiez les secrets et les variables d’environnement : vérifiez que toutes les références de la env section sont résolues correctement.
  • Confirmer les dépendances : vérifiez que tous les packages requis sont inclus ou installés.

Étapes suivantes

  • Last updated on