implantado a Databricks app

Após criar e desenvolver seu aplicativo Databricks , implante-o para torná-lo acessível no workspace Databricks . O processo de implantação compila seu aplicativo, instala as dependências e o executa usando a configuração definida nos arquivos do seu projeto. Você pode implantar aplicativos usando a interface do usuário Databricks ou a CLI Databricks .

nota

Se o senhor criar um aplicativo a partir de um padrão, o Databricks o implantará automaticamente quando o criar pela primeira vez. No entanto, o senhor ainda pode reimplantá-lo mais tarde, depois de fazer alterações. Consulte Criar um aplicativo Databricks a partir de um padrão.

Lógica de implantação

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

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

Se package.json estiver presente :

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

nota

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

Se package.json não estiver presente :

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

Prepare-se para o destacamento.

Antes de implantar o 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 app.yaml opcional - Se o seu aplicativo exigir um comando personalizado ou uma variável de ambiente, inclua um arquivo app.yaml para configurar a execução. Consulte Configurar a execução do aplicativo Databricks com app.yaml.
• Dependências - Certifique-se de que todas as dependências estejam disponíveis. Consulte gerenciar dependências para um aplicativo Databricks.
• Segredos ou valores do ambiente - Se você usar a seção env em app.yaml, verifique se os segredos referenciados ou as fontes externas estão corretamente configurados e acessíveis. Consulte Adicionar recurso a um aplicativo Databricks.

Além disso, certifique-se de que a entidade de serviço do aplicativo tenha acesso à pasta do código-fonte.

implantou o aplicativo

Databricks UI

Para implantar um aplicativo na interface do usuário Databricks:

1. Faça upload dos arquivos do aplicativo para o site Databricks workspace. Para obter instruções, consulte Importar um arquivo.
2. Clique em Calcular na barra lateral.
3. Acesse Apps tab e clique no link do seu aplicativo na coluna Name (Nome ).
4. Clique em implantado e selecione a pasta em seu site workspace onde o senhor carrega os arquivos do aplicativo.
5. Clique em Select e depois em implantado .
6. Revise a configuração e clique em implantado .

Databricks CLI

Para implantar um aplicativo usando o site CLI:

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

2. Faça o upload dos arquivos do seu aplicativo para o workspace Databricks usando o comando sync . Substitua o caminho pelo local workspace onde você deseja upload os arquivos.

   Bash

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

   O parâmetro --watch 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 arquivo .gitignore no diretório local do seu aplicativo. Os arquivos comuns a serem excluídos são node_modules/, .env, __pycache__/, .DS_Store e quaisquer arquivos de dados grandes ou artefatos de compilação.

3. Verifique o upload visualizando os arquivos em seu workspace. Clique Na barra lateral, acesse o espaço de trabalho e navegue até o diretório que você criou para seu aplicativo.

4. Implante o aplicativo executando o seguinte comando. Substitua o nome do aplicativo e o caminho do código-fonte pelos seus valores.

   Bash

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

   A interface de linha de comando (CLI) exibe o progresso da implantação e confirma quando o aplicativo está em execução.

Uma vez implantado, o Databricks começará seu aplicativo com base no command definido em seu arquivo app.yaml ou executará por padrão o python app.py.

Comportamento pós-implantação

Após a conclusão da implantação, 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 do ambiente.

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

Acesse os registros tab para depuração e monitoramento de tempo de execução. Consulte Registro em log e monitoramento para aplicativos Databricks.

Atualize ou reimplemente o aplicativo

Talvez o senhor queira atualizar ou reimplantar o aplicativo se tiver feito alterações no código-fonte, atualizado o arquivo app.yaml ou se precisar implantá-lo a partir de um caminho de código-fonte diferente. O Re-implantado aplica as atualizações mais recentes sem a necessidade de recriar o aplicativo do zero.

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 Apps no site Databricks workspace.
3. Selecione seu aplicativo e escolha implantar novamente. Se o caminho do código-fonte foi 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 seu aplicativo não for implantado ou não executar conforme o esperado, tente as seguintes etapas de solução de problemas:

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

Próximos passos

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