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.

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. 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.

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

info

Beta

Este recurso está em versão Beta. Se um administrador desativar o recurso, os aplicativos existentes implantados a partir do Git continuarão em execução, mas você não poderá reimplantá-los ou reiniciá-los até reativar a pré-visualização ou remover o recurso do aplicativo.

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.

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 do Git . Alternativamente, edite o aplicativo e adicione as credenciais em Configurar Git local o passo. Você precisa ter permissões CAN MANAGE no aplicativo para adicionar uma credencial Git. Para obter instruções para cada provedor, consulte Conectar seu provedor Git ao Databricks.

importante

Por motivos de segurança, o Databricks exclui todas as credenciais Git associadas à entidade de serviço do aplicativo quando você altera a origem da implantação (de Git para workspace ou de workspace para Git) ou quando você altera o repositório Git. Alterar apenas a referência do Git não exclui as credenciais. Após alterar a origem ou o local de implantação, você deve reconfigurar as credenciais Git para implantar novamente a partir do Git .

nota

Os criadores de aplicativos recebem automaticamente permissões CAN MANAGE na entidade de serviço somente quando o recurso Beta de implantação do Git está ativado. Se você criou um aplicativo enquanto o recurso estava desativado, pode não ter permissão para adicionar uma credencial do Git.

entidade de serviço suporta uma credencial Git por provedor. A atualização de uma credencial, por exemplo, através do console account , substitui a credencial existente para esse provedor e afeta todos os aplicativos que usam essa entidade de serviço com esse provedor.

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. 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á.

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. 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. 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.
• Verifique se a referência Git (branch, tag ou commit) existe no repositório.

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