Configurar repositórios de pacotes por defeito

Os administradores das áreas de trabalho podem configurar repositórios de pacotes privados ou autenticados nas áreas de trabalho como repositórios de pacotes predefinidos para notebooks, tarefas, pipelines Lakeflow e aplicações da Databricks. Os repositórios Python aplicam-se a todas estas cargas de trabalho, mas os registos npm aplicam-se apenas às aplicações Databricks.

Se um espaço de trabalho estiver configurado com um repositório de pacotes predefinido, os utilizadores do espaço de trabalho podem instalar pacotes a partir de repositórios internos sem definir explicitamente os valores index-url ou extra-index-url para Python, ou um registo para o npm. Se estes valores forem especificados em código, num caderno ou num ficheiro de app.yaml uma aplicação, têm precedência sobre os valores predefinidos do espaço de trabalho. Consulte Usar repositórios de pacotes predefinidos ao nível do espaço de trabalho para saber como funciona a precedência para aplicações Databricks.

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 do espaço de trabalho podem adicionar ou remover os repositórios de pacotes predefinidos usando a página de definições do administrador 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 em Python, URLs de índice extra, um certificado SSL personalizado ou uma configuração de registo npm.
6. Clique em Guardar para guardar as alterações.

Configure utilizando a CLI de secrets ou a API REST

Para configurar repositórios de pacotes predefinidos usando a CLI ou a API REST, crie um âmbito de segredos 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 de espaços de trabalho podem definir URLs de índice de pip por defeito, URLs de índice extra, um certificado SSL e uma configuração npm, juntamente com tokens e segredos de autenticação, num âmbito secreto designado sob chaves pré-definidas:

• 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
• Chave secreta para configuração de npm: npm-rc (Apenas Databricks Apps)

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 de repositório de pacotes

Adicione detalhes do repositório de pacotes usando os nomes de chaves secretas pré-definidos. Os repositórios Python são aplicáveis a notebooks, jobs, pipelines Lakeflow e Databricks Apps, mas os registos do npm aplicam-se apenas a Databricks Apps.

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>"}'

Node.js

Para as aplicações Databricks, também pode configurar um registo npm predefinido para que as aplicações instalem Node.js pacotes, incluindo pacotes privados, a partir do registo configurado pelo espaço de trabalho. Armazene o conteúdo completo .npmrc do ficheiro, incluindo a URL do registo e qualquer token de autenticação, sob a npm-rc chave secreta:

databricks secrets put-secret --json '{"scope": "databricks-package-management", "key": "npm-rc", "string_value":"registry=https://npm.example.com/\n//npm.example.com/:_authToken=<token>\n"}'

Quando uma aplicação no espaço de trabalho é construída, o Azure Databricks grava este conteúdo no ficheiro da .npmrc aplicação. Para saber como funciona a precedência e como a sobrepor para uma aplicação específica, veja Node.js pacotes.

Modificar ou eliminar segredos do repositório de pacotes

Para modificar os segredos do repositório de pacotes, use o put-secret comando. Para apagar os segredos do repositório de pacotes, 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 the npm configuration secret (Databricks Apps only)
databricks secrets delete-secret databricks-package-management npm-rc

# delete scope
databricks secrets delete-scope databricks-package-management