Configurar repositórios de pacotes do Python padrão

Os administradores do workspace podem configurar repositórios de pacotes privados ou autenticados em seus respectivos workspaces como a configuração padrão do pip para notebooks sem servidor, trabalhos sem servidor e computação clássica.

Se um workspace estiver configurado com um repositório de pacotes Python padrão, os usuários do workspace poderão instalar pacotes de repositórios internos de pacotes Python sem definir explicitamente index-url ou extra-index-url valores. No entanto, se esses valores forem especificados em código ou em um notebook, eles têm precedência sobre os padrões do workspace.

Essa configuração aproveita segredos do Databricks para armazenar e gerenciar com segurança as URLs e as credenciais do repositório. Os administradores do workspace podem configurar a configuração usando a página de configurações de administrador do workspace ou usando um escopo de segredo predefinido e os comandos de segredos da CLI do Databricks ou a API REST.

Configurar dependências padrão para um workspace

Os administradores do workspace podem adicionar ou remover os repositórios de pacote python padrão usando a página de configurações de administrador do workspace.

1. Como administrador do espaço de trabalho, faça login no espaço de trabalho do Databricks.
2. Clique no seu nome de usuário na barra superior do workspace do Databricks e selecione Configurações.
3. Clique na guia Computação.
4. Ao lado de Repositórios de Pacote Padrão, clique em Gerenciar.
5. (Opcional) Adicione ou remova uma URL de índice, URLs de índice extras ou um certificado SSL personalizado.
6. Clique em Salvar para salvar as alterações.

Configurar usando a CLI de segredos ou a API REST

Para configurar repositórios de pacotes python padrão usando a CLI ou a API REST, crie um escopo de segredo predefinido e configure permissões de acesso e adicione os segredos do repositório de pacotes.

Nome do escopo do segredo predefinido

Os administradores do espaço de trabalho podem definir URLs de índice pip padrão ou URLs de índice adicionais, juntamente com tokens de autenticação e segredos, em um escopo secreto designado sob chaves predefinidas.

• Nome do escopo do segredo: databricks-package-management
• Chave secreta para index-url: pip-index-url
• Chave secreta para urls de índice extra: pip-extra-index-urls
• Chave secreta para conteúdo de certificação SSL: pip-cert

Criar um escopo de segredo

Um escopo secreto pode ser criado usando os comandos de segredos da CLI do Databricks ou a API REST . Depois de criar o escopo do segredo, configure listas de controle de acesso para conceder acesso de leitura a todos os usuários do workspace. Isso garante que o repositório permaneça seguro e não possa ser alterado por usuários individuais. O escopo de segredo deve usar o nome predefinido de escopo de segredo 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 de pacotes Python

Adicione os detalhes do repositório de pacote do Python usando os nomes de chave secreta predefinidos, com os três campos sendo 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, use o put-secret comando. Para excluir segredos do repositório PyPI, use 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