ssh grupo de comandos
O uso CLI Databricks está sujeito à LicençaDatabricks e ao Aviso de PrivacidadeDatabricks, incluindo qualquer fornecimento de Dados de Uso.
Beta
O túnel SSH está em Beta.
O grupo de comandos ssh dentro da CLI do Databricks permite configurar e estabelecer conexões SSH para seu compute e workspace Databricks. Consulte Conectar ao Databricks usando um túnel SSH.
databricks ssh connect
Conecte-se ao seu compute e workspace da Databricks via SSH. Este comando estabelece uma conexão SSH com o compute do Databricks, configurando o túnel SSH e lidando com o proxy da conexão.
databricks ssh connect [flags]
Opções
--accelerator string
O tipo de acelerador de GPU ao se conectar ao AI Runtime. Aceita GPU_1xA10 ou GPU_8xH100.
--auto-approve
Ignorar prompts de confirmação ao instalar extensões de IDE e aplicar configurações de IDE. default: false.
--auto-start-cluster
Iniciar automaticamente o cluster caso ele não esteja em execução. padrão: true.
--base-environment string
Um ambiente base de workspace para pré-configurar dependências do Python ao conectar-se ao compute serverless. Compatível com a versão 4 e abaixo do ambiente serverless; a versão 5 do ambiente serverless não é compatível. Aceita um dos seguintes formatos:
- Nome de exibição, por exemplo
my-workspace-env - Um caminho de arquivo YAML, por exemplo
/Workspace/path/to/env.yaml - ID de recurso, por exemplo
workspace-base-environments/dbe_123
Este sinalizador não pode ser combinado com --cluster.
--cluster string
ID do Databricks para um cluster dedicado de usuário único. Quando esta opção for omitida, o túnel SSH se conecta ao compute serverless.
Este sinalizador não pode ser combinado com --base-environment.
--ide string
IDE para iniciar para a sessão. Aceita vscode ou cursor. Para começar a sessão no seu terminal, omita esta flag e use cd /Workspace/Users/someone@example.com para acessar seu workspace.
--keep-detached-processes
Enquanto o trabalho ainda estiver em andamento, mantenha o túnel SSH e quaisquer processos desanexados da sessão com tmux, setsid ou nohup em execução, delimitados por --server-timeout. Suportado em compute serverless e classic. Enquanto os processos desanexados estiverem em execução, o compute continuará em execução e um cluster classic não terminará automaticamente. Consulte Manter processos desanexados em execução. Default: false.
--max-clients int
Número máximo de clientes SSH. padrão: 10.
--name string
Nome da conexão para reutilizar entre as sessões. Somente compute serverless.
--server-timeout duration
Duração máxima do túnel SSH. O túnel é desligado após essa duração, mesmo se os clientes estiverem conectados. Se você não definir esse sinalizador, a vida útil será o maior entre o default e --shutdown-delay. Se você defini-lo, --shutdown-delay não pode ser maior que esse valor. Default: 24h0m0s.
--shutdown-delay duration
Atraso antes de desligar o túnel após o último cliente se desconectar. default: 10m0s.
--usage-policy-id string
ID da política de uso para o túnel SSH serverless. Somente serverless.
Exemplos
O exemplo a seguir conecta-se ao compute serverless:
databricks ssh connect
O exemplo a seguir se conecta ao compute serverless no Runtime de AI usando um acelerador de GPU:
databricks ssh connect --accelerator GPU_1xA10
O exemplo a seguir se conecta ao compute Serverless usando um ambiente base do Workspace que tem dependências Python pré-configuradas.
databricks ssh connect --base-environment my-workspace-env
O exemplo a seguir se conecta a um cluster dedicado:
databricks ssh connect --cluster 0123-456789-abcdefgh
O exemplo a seguir conecta-se a um cluster usando um perfil específico:
databricks ssh connect --cluster 0123-456789-abcdefgh --profile my-profile
O exemplo a seguir se conecta com um atraso de desligamento personalizado:
databricks ssh connect --cluster 0123-456789-abcdefgh --shutdown-delay 30m
configuração ssh do Databricks
Configure a configuração SSH para conexões ao compute clássico. Somente são suportadas conexões a clusters dedicados (de usuário único). Este comando adiciona uma configuração de host SSH ao seu arquivo de configuração SSH. Após executar a configuração, o senhor pode se conectar com ssh <name>.
Para conexões serverless, use databricks ssh connect. Nenhuma etapa de configuração é necessária.
databricks ssh setup [flags]
Opções
--auto-approve
Ignorar avisos de confirmação ao recriar configurações de host SSH existentes. default: false.
--auto-start-cluster
Iniciar automaticamente o cluster ao estabelecer a conexão SSH. padrão: true.
--cluster string
ID do Databricks para um cluster de usuário único dedicado.
--keep-detached-processes
Enquanto o trabalho ainda estiver em andamento, mantenha o túnel SSH e quaisquer processos desanexados da sessão com tmux, setsid ou nohup em execução, vinculados a --server-timeout. Apenas compute clássico. As conexões serverless não requerem configuração, então para manter processos desanexados em execução no compute serverless, passe este sinalizador para databricks ssh connect. Enquanto os processos desanexados estiverem em execução, o cluster não é encerrado automaticamente. Consulte Manter processos desanexados em execução. A entrada de host SSH gerada aplica este sinalizador cada vez que você se conecta. default: false.
--name string
Nome do host a ser usado na configuração SSH.
--server-timeout duration
Duração máxima do túnel SSH. O túnel é desligado após essa duração, mesmo se os clientes estiverem conectados. Se você não definir esse sinalizador, a vida útil será o maior entre o default e --shutdown-delay. Se você defini-lo, --shutdown-delay não pode ser maior que esse valor. Default: 24h0m0s.
--shutdown-delay duration
O túnel SSH termina após esse atraso se não houver conexões ativas. default: 10m0s.
--ssh-config string
Caminho para o arquivo de configuração SSH. padrão: ~/.ssh/config.
Exemplos
O exemplo a seguir configura o SSH para um cluster:
databricks ssh setup --name my-cluster --cluster 0123-456789-abcdefgh
Após executar a configuração, você poderá se conectar usando o cliente SSH padrão:
ssh my-cluster
Bandeiras globais
--debug
Ativar ou não o registro de depuração.
-h ou --help
Exibir ajuda para a CLI Databricks , o grupo de comandos relacionado ou o comando específico.
--log-file string
Uma sequência de caracteres representando o arquivo no qual logs de saída serão gravados. Se essa opção não for especificada, o default é gravar logs de saída em stderr.
--log-format Formato
O tipo de formato de log, text ou json. O valor default é text.
--log-level string
Uma sequência de caracteres representando o nível de formato log . Caso não seja especificado, o nível de formato log será desativado.
-o, --output Tipo
O tipo de saída do comando, text ou json. O valor default é text.
-p, --profile string
O nome do perfil no arquivo ~/.databrickscfg a ser usado para executar o comando. Se este sinalizador não for especificado, então, se existir, o perfil denominado DEFAULT será usado.
--progress-format Formato
O formato para exibir logs de progresso é: default, append, inplace ou json
-t, --target string
Se aplicável, o pacote de destino a ser usado.