Configurar repositórios de pacotes Python padrão

Os administradores de espaços de trabalho podem configurar repositórios de pacotes privados ou autenticados dentro de espaços de trabalho como a configuração pip padrão para blocos de anotações sem servidor, trabalhos sem servidor e computação clássica.

Se um espaço de trabalho estiver configurado com um repositório padrão de pacotes Python, os utilizadores no espaço de trabalho poderão instalar pacotes de repositórios Python internos sem definir explicitamente os valores index-url ou extra-index-url. No entanto, se esses valores forem especificados no código ou em um bloco de anotações, eles terão precedência sobre os padrões do espaço de trabalho.

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

Configurar dependências padrão para um espaço de trabalho

Os administradores de espaço de trabalho podem adicionar ou remover os repositórios de pacotes Python padrão usando a página de configurações de administração do espaço de trabalho.

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

Configuração usando a CLI de 'secrets' ou a API REST

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

Nome do escopo secreto predefinido

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

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

Criar o escopo secreto

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

Adicione os detalhes do repositório de pacotes Python usando os nomes de chaves secretas predefinidos, com todos 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 privados do repositório PyPI

Para modificar os segredos do repositório PyPI, use o put-secret comando. Para excluir segredos do repositório PyPI, use delete-secret como 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