Implantar um aplicativo Databricks

Depois de criar e desenvolver a sua aplicação Azure Databricks, implemente-a para a tornar acessível no espaço de trabalho Azure Databricks. O deployment constrói a sua aplicação, instala dependências e executa-a usando a configuração definida nos ficheiros do seu projeto. Pode implementar aplicações usando a interface 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 reimplantá-lo mais tarde depois de fazer alterações. Consulte Criar um aplicativo Databricks a partir de um modelo.

Lógica de implantação

O Databricks Apps suporta a implantação de aplicativos que usam Python, Node.jsou uma combinação de ambos. Isso permite arquiteturas flexíveis, como um frontend Node.js com um backend Python.

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

Se package.json estiver presente:

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

Observação

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

Se package.json não estiver presente:

1. Execute pip install -r requirements.txt (caso exista)
2. Execute o comando especificado no 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 seu 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 seu 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 comapp.yaml.
• Dependências - Certifique-se de que todas as dependências estão disponíveis. Consulte Gerenciar dependências para um aplicativo Databricks.
• Segredos ou valores de ambiente - Se você usar a env seção em app.yaml, verifique se os segredos referenciados ou fontes externas estão corretamente configurados e acessíveis. Consulte Adicionar recursos a um aplicativo Databricks.

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

Implementar a aplicação

Interface do usuário do Databricks

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

1. Carregue os arquivos do aplicativo em seu espaço de trabalho do Azure Databricks. Para obter instruções, consulte Importar um arquivo.
2. Clique em Calcular 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 em seu espaço de trabalho onde você carregou os arquivos do aplicativo.
5. Clique em Selecionar e, em seguida, em Implantar.
6. Revise a configuração e clique em Implantar.

CLI do Databricks

Para implantar um aplicativo usando a CLI:

1. Abre um terminal e navega até ao diretório que contém os ficheiros da tua app.

2. Carregue os ficheiros da sua aplicação para o espaço de trabalho Azure Databricks usando o sync comando. Substitua o caminho pelo local do espaço de trabalho onde você deseja carregar os arquivos.

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

   A --watch flag mantém o processo de sincronização a correr e carrega automaticamente as alterações quando modificas ficheiros localmente. Para excluir ficheiros ou diretórios específicos da sincronização, adicione-os a um .gitignore ficheiro no diretório local da sua aplicação. Ficheiros comuns a excluir são node_modules/, .env, __pycache__/, .DS_Store, e quaisquer ficheiros de dados grandes ou artefactos de construção.

3. Verifique o carregamento visualizando os ficheiros no seu espaço de trabalho. de Trabalho na barra lateral e navegue até ao diretório que criou para a sua aplicação.

4. Implemente a aplicação executando o seguinte comando. Substitui o nome da aplicação e o caminho do código-fonte pelos teus valores.

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

   A CLI mostra o progresso da implementação e confirma quando a aplicação está a funcionar.

Uma vez implantado, o Azure Databricks inicia seu aplicativo com base no definido command em seu app.yaml arquivo ou usa como padrão a execução python app.py.

Comportamento pós-implantação

Após a implementação concluída, o Azure Databricks inicia a sua aplicação num ambiente gerido. A página de detalhes da aplicação mostra o estado atual e fornece acesso a registos, histórico de implementação e informações do ambiente.

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

Vá para a guia Logs para depuração e monitoramento de tempo de execução. Consulte Registro e monitoramento de aplicativos Databricks.

Atualize ou volte a implementar a aplicação

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

Para fazer alterações em um aplicativo implantado:

1. Atualize o código da aplicação 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 mudou, clique na seta ao lado de Deploy e selecione Deploy usando um caminho diferente do código-fonte.

Resolução de problemas de implementação

Se a sua aplicação falhar ao implementar ou não correr como esperado, experimente os seguintes passos de resolução de problemas:

• Verificar registos - Ver mensagens de erro ou saída durante a execução no painel de registos.
• Validar app.yaml - Verifique se a sintaxe está correta e se as configurações suportadas são usadas.
• Verificar segredos e variáveis de ambiente - Certifique-se de que todas as referências na seção env sejam correctamente resolvidas.
• Confirmar dependências - Certifique-se de que todos os pacotes necessários estão incluídos ou instalados.

Próximos passos

• Registo e Monitorização de Aplicações Databricks
• Configurar permissões para um aplicativo Databricks
• Configurar a execução da aplicação Databricks com app.yaml