Configure os repositórios default Python pacote
Os administradores do workspace podem configurar repositórios pacote privados ou autenticados dentro do workspace como a configuração default pip para serverless Notebook, serverless Job e o clássico compute.
Se um workspace estiver configurado com um default Python pacote repo, os usuários no workspace poderão instalar o pacote a partir de repositórios internos Python sem definir explicitamente os valores index-url
ou extra-index-url
. No entanto, se esses valores forem especificados no código ou em um Notebook, eles terão precedência sobre o padrão workspace.
Essa configuração aproveita os segredos do Databricks para armazenar e gerenciar com segurança os URLs e as credenciais do repositório. Os administradores do workspace podem fazer a configuração usando a página de configurações workspace de administração ou usando um escopo secreto predefinido e o Databricks CLI comando secrets ou REST API o comando.
Configure as dependências do default para um workspace
Os administradores do espaço de trabalho podem adicionar ou remover os repositórios do pacote default Python usando a página de configurações de administração workspace.
- Como administrador do workspace, log in para o Databricks workspace.
- Clique no seu nome de usuário na barra superior do workspace do Databricks e selecione Configurações .
- Clique em computar tab.
- Ao lado de Pacote Repositories padrão , clique em gerenciar .
- (Opcional) Adicionar ou remover um URL de índice, URLs de índice extras ou um certificado SSL personalizado.
- Clique em Salvar para salvar as alterações.
As modificações ou exclusões de segredos são aplicadas após a reconexão do recurso compute ao Notebook ou a reexecução do trabalho.
Configurar utilizando a CLI de segredos ou a API REST
Para configurar repositórios de pacotes default Python utilizando o CLI ou REST API, crie um Secret Scope predefinido e configure as permissões de acesso, em seguida, adicione os segredos do repositório de pacotes.
Nome do escopo secreto predefinido
Os administradores do espaço de trabalho podem definir URLs de índice pip default ou URLs de índice adicionais, juntamente com autenticação tokens e segredos em um Escopo Secreto designado sob uma chave predefinida:
- Nome secreto do escopo:
databricks-package-management
- chave secreta para index-url:
pip-index-url
- chave secreta para URLs fora do índice:
pip-extra-index-urls
- chave secreta para o conteúdo da certificação SSL:
pip-cert
Criar o Escopo Secreto
Um Secret Scope pode ser criado utilizando o Databricks CLI comando secrets ou REST API o comando. Após criar o Escopo Secreto, configure as listas de controle de acesso para conceder acesso de leitura a todos os usuários workspace. Isso garante que o repositório permaneça seguro e não possa ser alterado por usuários individuais. O Escopo Secreto deve utilizar o nome predefinido databricks-package-management
.
databricks secrets create-scope databricks-package-management
databricks secrets put-acl databricks-package-management admins MANAGE
databricks secrets put-acl databricks-package-management users READ
Adicionar segredos do repositório do pacote Python
Adicione os detalhes do repositório do pacote Python utilizando os nomes predefinidos para a chave secreta, sendo que todos os três campos são opcionais.
# Add index URL.
databricks secrets put-secret --json '{"scope": "databricks-package-management", "key": "pip-index-url", "string_value":"<index-url-value>"}'
# Add extra index URLs. If you have multiple extra index URLs, separate them using white space.
databricks secrets put-secret --json '{"scope": "databricks-package-management", "key": "pip-extra-index-urls", "string_value":"<extra-index-url-1 extra-index-url-2>"}'
# Add cert content. If you want to pip configure a custom SSL certificate, put the cert file content here.
databricks secrets put-secret --json '{"scope": "databricks-package-management", "key": "pip-cert", "string_value":"<cert-content>"}'
Modificar ou excluir segredos do repositório PyPI privado
Para modificar os segredos do repositório PyPI, utilize o comando ` put-secret
`. Para excluir os segredos do repositório PyPI, utilize delete-secret
conforme mostrado abaixo:
# delete secret
databricks secrets delete-secret databricks-package-management pip-index-url
databricks secrets delete-secret databricks-package-management pip-extra-index-urls
databricks secrets delete-secret databricks-package-management pip-cert
# delete scope
databricks secrets delete-scope databricks-package-management