Implantar pacotes e executar fluxos de trabalho a partir do espaço de trabalho

Ativos que fazem parte dos seus Pacotes de Automação Declarativa podem ser criados e modificados a partir de um ambiente de desenvolvimento local ou do espaço de trabalho, mas para que as alterações sejam sincronizadas com os recursos correspondentes do Databricks, os pacotes devem ser implementados. Os pacotes têm identidades exclusivas em um espaço de trabalho, portanto, independentemente de um pacote ser implantado a partir de uma máquina local ou do espaço de trabalho, os ativos do pacote não são duplicados.

Para requisitos para usar bundles no espaço de trabalho, consulte Declarative Automation Bundles nos requisitos do espaço de trabalho.

Para mais informações sobre bundles, veja O que são Declarative Automation Bundles?.

Implantar um pacote

Para implantar um pacote a partir do espaço de trabalho:

1. Navegue até o pacote no espaço de trabalho e clique em um arquivo YAML de configuração do pacote, como databricks.yml.

2. Clique no ícone de implantações.

3. No painel de Desdobramentos , escolha um alvo. Os objetivos são definidos no targets mapeamento do conjunto databricks.yml. Consulte os modos de implementação dos Pacotes de Automação Declarativa.

   

4. Clique em Implementar. O pacote é validado e os detalhes da validação aparecem em uma caixa de diálogo.

5. Revise os detalhes da implantação nesta caixa de diálogo de confirmação para desenvolvimento e clique em Implantar.

   

   Importante

   Implantar pacotes e executar recursos de pacote executa o código como o usuário atual. Certifique-se de confiar no código do pacote, incluindo YAML, que pode conter definições de configuração que executam comandos.

O estado da implantação é apresentado na janela de saída do projeto. Quando a implantação for concluída, os recursos do pacote implantado serão listados no painel Recursos do pacote .

Editar e implementar dashboards

Os dashboards num bundle podem ser editados, mas para publicar alterações é necessário re-implementar o bundle. Para atualizar um dashboard num pacote:

1. A partir do painel de Implementações do editor de pacotes, clique num painel de controlo em Recursos de Pacotes para abrir o painel.

   

2. Clica em Editar rascunho para abrir o editor do painel.

   

3. Faça alterações ao painel de controlo.

4. Clique em Implementar para publicar as alterações no painel do pacote. Todos os recursos do pacote são redistribuídos, incluindo o painel de controlo.

   

5. Clique em Ver implementação para verificar as alterações na versão publicada.

Para programar atualizações de painéis em produção, utilize uma tarefa agendada com uma tarefa de painel. Veja Executar trabalhos num cronograma e Tarefa no Painel para os trabalhos.

Implantações vinculadas à origem

Por padrão, quando você implanta um pacote em um destino de desenvolvimento por meio do espaço de trabalho, os recursos criados durante a implantação fazem referência aos arquivos de origem no espaço de trabalho em vez de suas cópias do espaço de trabalho. A sincronização de arquivos com ${workspace.file_path} é ignorada. Se você excluir um pacote, somente os recursos definidos no pacote serão excluídos; os arquivos permanecem.

Para desabilitar esse comportamento, no arquivo de configuração do pacote databricks.yml , defina a predefinição do source_linked_deployment modo de implantação como false.

targets:
  # Disable source_linked_deployment in dev
  dev:
    mode: development
    presets:
      source_linked_deployment: false

Para mais informações sobre os modos de implementação, consulte modos de implementação de Pacotes de Automação Declarativa.

Executar um fluxo de trabalho em um pacote

Pode desencadear uma execução de um recurso definido num bundle depois de o bundle ter sido implementado com sucesso:

1. Navegue até o pacote no espaço de trabalho e clique em um arquivo YAML de configuração do pacote, como databricks.yml.

2. Clique no ícone de implantações.

   

3. No painel Recursos do pacote , clique no ícone executar (reproduzir) associado a qualquer recurso para executá-lo.

   

   Se um recurso estiver desativado e não tiver um ícone de execução, ele ainda não foi implantado. Implante o pacote antes de tentar executar o recurso. Consulte Distribuir um pacote.

Colabore, revise e implemente em produção

Os Pacotes de Automação Declarativa no espaço de trabalho permitem-lhe personalizar permissões para modificar, implementar e executar o pacote para facilitar a colaboração e resolução de problemas. O Databricks recomenda colaborar em seu pacote por meio do Git, mas para uma solução de problemas simples, você pode compartilhar um pacote com seus colaboradores no espaço de trabalho Databricks. Navegue até a visualização do projeto do pacote e clique em Compartilhar. Os pacotes herdam as permissões de sua pasta Git pai, portanto, compartilhar um pacote aplica as alterações à pasta Git pai.

Quando você terminar a colaboração e o teste do seu pacote no dev, altere a implantação de destino para prod para implantar no espaço de trabalho atual.

Defina um espaço de trabalho de produção diferente para suas implantações automatizadas no databricks.yml arquivo de configuração. Veja o espaço de trabalho.