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. Instale as dependências do Python:

   • Se requirements.txt existir, execução pip install -r requirements.txt
   • Se requirements.txt não existir e pyproject.toml e uv.lock existirem, execute uv sync para instalar as dependências.

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. Instale as dependências do Python:

   • Se requirements.txt existir, execução pip install -r requirements.txt
   • Se requirements.txt não existir e pyproject.toml e uv.lock existirem, execute uv sync para instalar as dependências.

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.

Escolha uma fonte de implantação

Você pode implantar aplicativos Databricks a partir das seguintes fontes:

• Pasta de espaço de trabalho - carregue os arquivos do aplicativo para uma pasta de workspace e implante-os a partir daí. Este é o método de implantação padrão.
• RepositórioGit - Configure um repositório Git para um aplicativo e implante diretamente sem fazer upload de arquivos para o workspace. O aplicativo lê o código da referência Git configurada (branch, tag ou commit) cada vez que você realiza uma implantação. Você também pode especificar um caminho para o código-fonte a ser implantado a partir de um diretório específico dentro do repositório. Todos os principais provedores Git são suportados, incluindo GitHub, GitLab e Bitbucket. Para obter uma lista completa dos provedores compatíveis, consulte Conectar seu provedor Git ao Databricks.

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

Impor implantações somente via Git

Os administradores do espaço de trabalho podem exigir que todos os aplicativos em um workspace sejam implantados a partir de repositórios Git . Para ativar essa configuração, acesse Configurações > Desenvolvimento > Aplicativos e ative a opção Permitir implantações de aplicativos somente do Git . Essa configuração está desativada por default.

Ao ativar esta configuração:

• Os usuários devem configurar um repositório Git antes de criar um aplicativo.
• Os usuários só podem implantar a partir do Git, não das pastas workspace .
• Databricks desativa o aplicativo padrão no workspace.
• Os usuários não podem remover um repositório Git de aplicativos que o possuam.
• Os aplicativos existentes continuam em execução, mas os usuários não podem implantá-los ou reiniciá-los, a menos que o aplicativo tenha um repositório Git .

implantou o aplicativo

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

implantado a partir de uma pasta workspace

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.

implantado a partir de um repositório Git

Para implantar um aplicativo a partir de um repositório Git , adicione o repositório no nível do aplicativo e, em seguida, especifique a referência Git ao implantá-lo. Seu repositório Git deve conter os arquivos do aplicativo, incluindo app.yaml, dependências e ponto de entrada. Todos os principais provedores Git são suportados, incluindo GitHub, GitLab e Bitbucket. Você também pode implantar aplicativos com suporte Gitusando a interface do usuário, CLI, API ou os pacotes de automação declarativa.

Para configurar e implantar um aplicativo a partir do Git:

1. Faça o upload dos arquivos do seu aplicativo para um repositório Git.
2. Na sua workspace Databricks , clique em Calcule na barra lateral.
3. Acesse a tab Aplicativos e selecione um aplicativo existente para editar ou clique em Criar aplicativo .
4. Em Configurar repositório Git ou passo, 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, a entidade de serviço do aplicativo deve ter uma credencial Git configurada. Na página de detalhes do aplicativo, clique em Configurar credencial Git ou edite o aplicativo e adicione a credencial em Configurar Git . Você precisa ter permissões CAN MANAGE no aplicativo para adicionar uma credencial Git. Os 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, implantamos o aplicativo:

1. Na página de detalhes do aplicativo, clique em implantar .
2. Selecionar do Git .
3. Para referência do Git , insira o nome do branch, a tag ou o SHA do commit (por exemplo, main, v1.0.0 ou um hash de commit).
4. Em Tipo de referência , especifique o tipo de referência, como um branch, tag ou commit.
5. (Opcional) Em Caminho do código-fonte , insira o 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 consegue 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 branch ou tag , Databricks implantou o commit mais recente daquela branch ou tag. Para referências SHA commit , Databricks sempre implantou esse commit específico. Se as credenciais Git da entidade de serviço forem inválidas ou expirarem, a implantação falhará.

nota

Aplicativos criados antes da implantação Git se tornarem geralmente disponíveis não concedem automaticamente aos criadores permissões CAN MANAGE na entidade de serviço do aplicativo. Se você precisar adicionar uma credencial Git a um aplicativo mais antigo, peça a um administrador workspace para lhe conceder permissões CAN MANAGE na entidade de serviço.

entidade de serviço suporta uma credencial Git por provedor. Se você atualizar as credenciais em outro local, como por meio do console account , elas substituirão as credenciais existentes para esse provedor.

Comportamento pós-implantação

Após a conclusão da implantação, Databricks inicia seu aplicativo com base no command definido em seu arquivo app.yaml ou, por padrão, executa python app.py. 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

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

Reimplementar a partir de uma pasta workspace

Para reimplantar a partir de uma pasta workspace :

1. Atualize os arquivos do seu aplicativo na pasta workspace .
2. Selecione o aplicativo e clique em implantar .
3. Se o caminho do código-fonte foi alterado ou se você está mudando de uma fonte Git , clique na seta ao lado de implantar e selecione implantar usando uma fonte diferente .

Reimplante a partir de um repositório Git

Para reimplantar a partir de um repositório Git:

1. Envie suas alterações para o repositório Git.
2. No seu workspace Databricks , selecione seu aplicativo e clique em implantar .
3. Se a referência Git foi alterada ou se você está mudando de uma origem workspace , clique na seta ao lado de implantar e selecione implantar usando uma origem diferente .

Para alterar o repositório Git ou as credenciais, edite a configuração do aplicativo. Para atualizar o repositório Git usando a CLI ou a API, utilize o comando create-update . Remover o repositório Git do aplicativo força a implantação a partir do workspace.

importante

Alterar o repositório Git ou alternar entre fontes de implantação (Git e workspace) exclui todas as credenciais Git da entidade de serviço do aplicativo. Alterar apenas a referência do Git não exclui as credenciais. Você precisa reconfigurar as credenciais antes de implantar novamente a partir do Git .

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:

• Verifique logs em busca de mensagens de erro ou informações de saída em tempo de execução.
• Validar a sintaxe e as configurações app.yaml .
• Verifique se secrets e variável 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 possui uma credencial Git configurada.
• Verifique se o URL do repositório Git está correto e se a referência Git (branch, tag ou commit) existe no repositório.
• Se um administrador workspace impuser implantações somente Git , você não poderá implantar ou iniciar um aplicativo a menos que ele tenha um repositório Git configurado.
• Se você implantar a partir da CLI, API ou Declarative Automation Bundles, crie o aplicativo primeiro e, em seguida, adicione as credenciais Git à entidade de serviço do aplicativo.

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