Implantar um aplicativo do Databricks

Depois de criar e desenvolver seu aplicativo do Azure Databricks, implante-o para torná-lo acessível no workspace do Azure Databricks. A implantação cria seu aplicativo, instala dependências e o executa usando a configuração definida em seus arquivos de projeto. Você pode implantar aplicativos usando a interface do usuário do Azure Databricks ou a CLI do Azure Databricks.

Observação

Se você criar um aplicativo a partir de um modelo, o Azure Databricks o implantará automaticamente quando você o criar pela primeira vez. No entanto, você ainda pode implantá-lo novamente mais tarde depois de fazer alterações. Consulte Criar um aplicativo do Databricks a partir de um modelo.

Lógica de implantação

O Databricks Apps dá suporte à implantação de aplicativos que usam Python, Node.jsou uma combinação de ambos. Isso permite arquiteturas flexíveis, como um front-end Node.js com um back-end do Python.

Durante a implantação, o processo de build verifica um package.json arquivo na raiz do diretório do aplicativo para determinar se Node.js é usado. Se estiver presente, ele inclui etapas específicas de construção do Node juntamente com as etapas do Python. A lógica de implantação segue este padrão:

Se package.json estiver presente:

1. Execute npm install
2. Executar pip install -r requirements.txt (se existir)
3. Executar npm run build (se um script build estiver definido em package.json)
4. Execute o comando especificado em app.yaml, ou npm run start se nenhum comando for especificado

Observação

Se nenhum comando for especificado em app.yaml, o Azure Databricks executa npm run start, mesmo que o aplicativo inclua código Python. Para executar processos de Python e Node.js, defina um script personalizado start que use uma ferramenta como concurrently para iniciar os dois. Por exemplo: concurrently "npm run start:node" "python my_app.py".

Se package.json não estiver presente:

1. Executar pip install -r requirements.txt (se existir)
2. Execute o comando especificado em app.yaml, ou python <my-app>.py se nenhum comando for especificado

Preparar-se para a implantação

Antes de implantar seu aplicativo, verifique se o projeto inclui os componentes necessários:

• Script principal - Seu arquivo de ponto de entrada, como app.py ou app.js.
• Arquivo opcional app.yaml – se o aplicativo exigir um comando personalizado ou variáveis de ambiente, inclua um app.yaml arquivo para configurar a execução. Consulte Configurar a execução do aplicativo Databricks com app.yaml.
• Dependências – verifique se todas as dependências estão disponíveis. Consulte Gerenciar dependências de um aplicativo do Databricks.
• Segredos ou valores de ambiente – se você usar a seção env em app.yaml, verifique se os segredos ou as fontes externas referenciadas estão configuradas e acessíveis corretamente. Consulte Adicionar recursos a um aplicativo do Databricks.

Além disso, verifique se a entidade de serviço de aplicativo tem acesso à pasta de código-fonte.

Implantar o aplicativo

Interface do usuário do Databricks

Para implantar um aplicativo da interface do usuário do Azure Databricks:

1. Carregue os arquivos do aplicativo no workspace do Azure Databricks. Para obter instruções, consulte Importar um arquivo.
2. Clique em Computação na barra lateral.
3. Vá para a guia Aplicativos e clique no link para seu aplicativo na coluna Nome .
4. Clique em Implantar e selecione a pasta no workspace em que você carregou os arquivos do aplicativo.
5. Clique em Selecionar, em seguida Implantar.
6. Examine a configuração e clique em Implantar.

CLI do Databricks

Para implantar um aplicativo usando a CLI:

1. Abra um terminal e navegue até o diretório que contém os arquivos do aplicativo.

2. Carregue os arquivos do aplicativo no workspace do Azure Databricks usando o sync comando. Substitua o caminho pelo local do workspace em que você deseja carregar os arquivos.

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

   O --watch sinalizador mantém o processo de sincronização em execução e carrega automaticamente as alterações quando você modifica arquivos localmente. Para excluir arquivos ou diretórios específicos da sincronização, adicione-os a um .gitignore arquivo no diretório do aplicativo local. Arquivos comuns a serem excluídos sãonode_modules/, .env, , __pycache__/.DS_Storee quaisquer arquivos de dados grandes ou artefatos de build.

3. Verifique o upload exibindo os arquivos em seu workspace. Clique no na barra lateral e navegue até o diretório que você criou para o seu aplicativo.

4. Implante o aplicativo executando o comando a seguir. Substitua o nome do aplicativo e o caminho do código-fonte por seus valores.

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

   A CLI exibe o progresso da implantação e confirma quando o aplicativo está em execução.

Depois de implantado, o Azure Databricks inicia seu aplicativo com base no command definido no arquivo app.yaml ou, por padrão, executa python app.py.

Comportamento pós-implantação

Após a conclusão da implantação, o Azure Databricks inicia seu aplicativo em um ambiente gerenciado. A página de detalhes do aplicativo mostra o status atual e fornece acesso a logs, histórico de implantação e informações de ambiente.

Para exibir a saída do aplicativo implantado, clique no link do aplicativo.

Vá para a aba Logs para depuração e monitoramento de tempo de execução. Consulte Registro em log e monitoramento para aplicativos do Databricks.

Atualizar ou reimplantar o aplicativo

Talvez você queira atualizar ou implantar novamente seu aplicativo se tiver feito alterações no código-fonte, atualizado o app.yaml arquivo ou precisar implantar de um caminho de código-fonte diferente. A reimplantação aplica as atualizações mais recentes sem a necessidade de recriar o aplicativo desde o início.

Para fazer alterações em um aplicativo implantado:

1. Atualize o código do seu aplicativo ou a configuração app.yaml.
2. Retorne à página Aplicativos no espaço de trabalho do Azure Databricks.
3. Selecione seu aplicativo e escolha Implantar novamente. Se o caminho do código-fonte for alterado, clique na seta ao lado de Implantar e selecione Implantar usando um caminho de código-fonte diferente.

Solucionar problemas de implantação

Se o aplicativo falhar na implantação ou não for executado conforme o esperado, tente as seguintes etapas de solução de problemas:

• Verificar logs – Exibir mensagens de erro ou saída de runtime no painel de logs.
• Validar app.yaml - Verifique se a sintaxe está correta e se as configurações com suporte são usadas.
• Verificar segredos e variáveis de ambiente – Verifique se todas as referências na seção env são resolvidas corretamente.
• Confirmar dependências – verifique se todos os pacotes necessários estão incluídos ou instalados.

Próximas etapas

• Log e monitoramento para aplicativos do Databricks
• Configurar permissões para um aplicativo do Databricks
• Configurar a execução do aplicativo Databricks com app.yaml