Implantar um aplicativo do Databricks

Depois de criar e desenvolver seu aplicativo Azure Databricks, implante-o para torná-lo acessível no workspace 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 Azure Databricks ou a CLI do Databricks.

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 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 de build específicas do Node juntamente com etapas de Python. A lógica de implantação segue este padrão:

Se package.json estiver presente:

1. Execute npm install
2. Instale as dependências do Python:
   • Se requirements.txt existir, execute pip install -r requirements.txt
   • Se requirements.txt não existir e pyproject.toml e uv.lock existirem, execute uv sync para instalar dependências
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

Se package.json não estiver presente:

1. Instale as dependências do Python:
   • Se requirements.txt existir, execute pip install -r requirements.txt
   • Se requirements.txt não existir e pyproject.toml e uv.lock existirem, execute uv sync para instalar dependências
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.

Escolher uma fonte de implantação

Você pode implantar aplicativos do Databricks das seguintes fontes:

• Pasta de workspace – Carregar arquivos de aplicativo em uma pasta de workspace e implantar a partir daí. Esse é o método de implantação padrão.
• Repositório Git – Configurar um repositório Git para um aplicativo e implantar diretamente sem carregar arquivos no workspace. O aplicativo lê o código da referência do Git configurada (ramo, tag, ou commit) sempre que você implanta. Você também pode especificar um caminho de código-fonte para implantar de um diretório específico dentro do repositório. Todos os principais provedores Git têm suporte, incluindo GitHub, GitLab e Bitbucket. Para obter uma lista completa de provedores com suporte, consulte Conectar seu provedor Git ao Databricks.

Você pode alternar entre as fontes do workspace e do Git para o mesmo aplicativo a qualquer momento, a menos que um administrador do workspace imponha implantações somente do Git. Consulte Impor implantações somente do Git.

Impor implantações somente do Git

Os administradores do workspace podem exigir que todos os aplicativos em um workspace sejam implantados em repositórios Git. Para habilitar essa configuração, vá para Configurações>Desenvolvimento>Aplicativos e ative Apenas permitir implantações de aplicativos a partir do Git. Essa configuração é desmarcada por padrão.

Quando ativa esta definição:

• Os usuários devem configurar um repositório Git antes de criar um aplicativo.
• Os usuários só podem implantar do Git, não de pastas de workspace.
• O Databricks desabilita modelos de aplicativo no workspace.
• Os usuários não podem remover um repositório Git de aplicativos que têm um.
• Os aplicativos existentes continuam a ser executados, mas os usuários não podem implantá-los ou iniciá-los novamente, a menos que o aplicativo tenha um repositório Git.

Implantar o aplicativo

As seções a seguir descrevem como implantar de uma pasta de espaço de trabalho ou diretamente de um repositório Git.

Implantar de uma pasta de workspace

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 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 Azure Databricks usando o comando sync. 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.

Implantar a partir de um repositório Git

Para implantar um aplicativo de um repositório Git, adicione o repositório no nível do aplicativo e especifique a referência do Git ao implantá-lo. O repositório Git deve conter os arquivos do aplicativo, incluindo app.yaml, dependências e ponto de entrada. Todos os principais provedores Git têm suporte, incluindo GitHub, GitLab e Bitbucket. Você também pode implantar aplicativos com suporte do Git usando a interface do usuário, a CLI, a API ou os Pacotes de Automação Declarativa.

Para configurar e implantar um aplicativo do Git:

1. Carregue os arquivos do aplicativo em um repositório Git.
2. No workspace Azure Databricks, clique em Compute na barra lateral.
3. Vá para a guia Aplicativos e selecione um aplicativo existente para editar ou clique em Criar aplicativo.
4. Na etapa Configurar repositório Git , insira a URL do repositório Git (por exemplo https://github.com/org/repo) e selecione um provedor Git.
5. Clique em Criar aplicativo ou Salvar para retornar à página de detalhes do aplicativo.
6. Para repositórios privados, o principal de serviço do aplicativo deve ter uma credencial Git configurada. Na página de detalhes do aplicativo, clique em Configurar credencial do Git ou edite o aplicativo e adicione a credencial na etapa Configurar repositório Git . Você deve ter CAN MANAGE permissões no aplicativo para adicionar uma credencial git. Repositórios públicos não exigem uma credencial Git. Para obter instruções para cada provedor, consulte Conectar seu provedor Git ao Databricks.

Em seguida, implante o aplicativo:

1. Na página de detalhes do aplicativo, clique em Implantar.
2. Selecione De Git.
3. Para referência do Git, insira o nome do branch, a marca ou o ID da confirmação SHA (por exemplo, main, v1.0.0 ou um hash de confirmação).
4. Para o tipo de referência, especifique o tipo de referência, como um branch, um tag ou um commit.
5. (Opcional) Para o caminho do código-fonte, insira um caminho para um diretório específico dentro do repositório. O aplicativo trata esse diretório como o diretório de nível superior e não pode acessar arquivos fora dele. Se você não especificar um caminho, o Databricks usará a raiz do repositório.
6. Clique em Implantar.

Para referências de ramificação ou marca, Azure Databricks implanta a confirmação mais recente desse branch ou marca. Para referências sha de confirmação, Azure Databricks sempre implanta essa confirmação específica. Se a credencial Git da entidade de serviço for inválida ou expirada, a implantação falhará.

Comportamento pós-implantação

Após a conclusão da implantação, Azure Databricks iniciará seu aplicativo com base no definido em seu arquivo /> /. 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 Log e monitoramento para apps do Databricks.

Atualizar ou reimplantar o aplicativo

Reimplante seu aplicativo depois de fazer alterações no código-fonte ou na configuração. A reimplantação aplica suas atualizações mais recentes sem recriar o aplicativo. Você pode reimplantar do workspace ou do repositório Git a qualquer momento.

Reimplantar de uma pasta de workspace

Para reimplantar de uma pasta de workspace:

1. Atualize os arquivos do aplicativo na pasta do workspace.
2. Selecione o aplicativo e clique em Implantar.
3. Se o caminho do código-fonte for alterado ou você estiver alternando de uma origem git, clique na seta ao lado de Implantar e selecione Implantar usando uma origem diferente.

Reimplantar de um repositório Git

Para reimplantar de um repositório Git:

1. Envie suas alterações por push para o repositório Git.
2. No workspace Azure Databricks, selecione seu aplicativo e clique em Deploy.
3. Se a referência do Git for alterada ou você estiver alternando de uma fonte de workspace, clique na seta ao lado de Implantar e selecione Implantar usando uma origem diferente.

Para alterar o repositório Git ou a credencial, edite a configuração do aplicativo. Para atualizar o repositório Git usando a CLI ou a API, use o comando create-update . Remover o repositório Git do aplicativo impõe a implantação a partir do workspace.

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:

• Verifique os logs em busca de mensagens de erro ou saída de runtime.
• Valide a sintaxe app.yaml e as configurações.
• Verifique se os segredos e as variáveis de ambiente na seção env são resolvidos corretamente.
• Confirme se todas as dependências necessárias estão incluídas ou instaladas.

Para implantações de repositório Git:

• Para repositórios privados, verifique se a entidade de serviço do aplicativo tem uma credencial Git configurada.
• Verifique se a URL do repositório Git está correta e se a referência do Git (branch, tag ou commit) existe no repositório.
• Se um administrador do workspace impor implantações somente do Git, você não poderá implantar ou iniciar um aplicativo, a menos que ele tenha um repositório Git configurado.
• Se você implantar da CLI, API ou Pacotes de Automação Declarativa, crie o aplicativo primeiro e adicione a credencial Git à entidade de serviço do aplicativo.

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