gerenciar serverless ambientes de base
Visualização
Esse recurso está em Public Preview.
Esta página explica como criar e gerenciar ambientes de base do serverless em um workspace.
Permissões
- Somente os administradores do workspace podem criar e gerenciar os ambientes de base do workspace.
- Todos os usuários do workspace têm acesso aos ambientes básicos do workspace.
- Todos os usuários do site workspace podem criar especificações personalizadas do ambiente serverless.
Como os ambientes básicos funcionam no Databricks
Em Databricks, um ambiente básico é uma especificação YAML compartilhável que define uma versão do ambienteserverless e um conjunto de dependências Python adicionais para o serverless Notebook. Os administradores do espaço de trabalho criam e gerenciam ambientes de base para que os usuários possam começar rapidamente a partir de um ambiente consistente e armazenado em cache e, opcionalmente, adicionar sua própria biblioteca.
Criar e exportar uma especificação de ambiente
A maneira mais simples de criar uma especificação YAML válida é criar o ambiente no painel lateral Environment (Ambiente ) e, em seguida, usar o botão Export environment (Exportar ambiente) para download o arquivo YAML.
- Abra um notebook e conecte-se ao site serverless compute.
- Clique no botão Environment
no painel lateral do Notebook.
- Selecione a versão do ambiente . Databricks Recomenda-se usar a versão mais recente do ambiente serverless suportada pelo seu workspace.
- No campo Dependências , adicione as dependências que você gostaria que o ambiente básico tivesse. Clique em Adicionar dependência depois de inserir cada dependência. Para obter mais instruções sobre como adicionar dependências, consulte Adicionar dependências ao Notebook.
- Clique em Aplicar na parte inferior do painel do ambiente para garantir que a especificação seja válida.
- Clique no ícone do menu kebab
na parte inferior do painel do ambiente e clique em Exportar ambiente.
- Dê um nome ao arquivo YAML e adicione-o a uma pasta do espaço de trabalho ou ao volume Unity Catalog.
Exemplo de especificação de ambiente
O exemplo YAML a seguir é baseado na especificação do ambiente de projetos do MLflow. Ele define um ambiente básico com algumas dependências de biblioteca:
environment_version: '4'
dependencies:
- --index-url https://pypi.org/simple
- -r "/Workspace/Shared/requirements.txt"
- my-library==6.1
- /Workspace/Shared/Path/To/simplejson-3.19.3-py3-none-any.whl
- git+https://github.com/databricks/databricks-cli
Adicione um ambiente básico ao seu workspace
Para adicionar a especificação do ambiente como um ambiente de base ao site workspace:
- No site workspace, vá para Settings (Configurações ).
- Em administração do espaço de trabalho , selecione computação .
- Ao lado de Base environments for serverless compute , clique em gerenciar .
- Clique em Criar novo ambiente .
- Dê um nome ao seu ambiente básico. Esse é o nome que os usuários verão no menu Base environment dropdown.
- Selecione o arquivo YAML de especificação do ambiente usando o seletor de arquivos. O senhor pode navegar pelos arquivos workspace ou pelos volumes Unity Catalog.
- Clique em Criar .
O ambiente básico começará a ser construído. Verifique a coluna Status na lista de ambientes básicos. Ele mudará para Pronto para usar quando estiver pronto.
Definir o ambiente base do workspace's default
Por default, serverless Notebook em um workspace não usa um ambiente de base. Os administradores do espaço de trabalho podem selecionar um ambiente de base para aplicar a todos os novos Notebooks pelo site default.
- No site workspace, vá para Settings (Configurações ).
- Em administração do espaço de trabalho , selecione computação .
- Ao lado de Base environments for serverless compute , clique em gerenciar .
- Clique no ícone de estrela ao lado do ambiente base para defini-lo como o default.
Todos os novos serverless Notebook agora serão default para o ambiente de base selecionado.
Atualizar um ambiente básico
Talvez você queira editar o arquivo de ambiente base para atualizar os números de versão ou adicionar ou remover dependências.
Na lista de ambientes básicos, clique no caminho do arquivo YAML do ambiente base que você deseja atualizar. Isso abre o arquivo em um novo tab. Você pode revisar ou atualizar o conteúdo do arquivo lá. As alterações são salvas automaticamente.
Depois de fazer uma atualização na especificação YAML, o senhor deve refresh o ambiente básico para que o Notebook e o Job obtenham a configuração mais recente.
- Ao lado do ambiente de base que o senhor deseja refresh, clique no ícone do menu kebab
e selecione refresh .
- Clique em Confirmar .
As novas sessões agora usam o ambiente básico atualizado. As sessões existentes do Notebook devem ser reiniciadas para receber as atualizações.
Limitações
- Para o Job, somente a tarefa Notebook pode usar ambientes básicos.
- não há suporte para a versão 1 do ambiente sem servidor. Use a versão 2 ou superior.
- Os ambientes básicos estão disponíveis para todos os usuários do site workspace.
- são limitados a 10 ambientes básicos.