Grupo de comandos sandbox

Note

O uso da CLI do Databricks está sujeito à Licença do Databricks e ao Aviso de Privacidade do Databricks, incluindo quaisquer provisionamentos de Dados de Uso.

O sandbox grupo de comandos dentro da CLI do Databricks ajuda você a criar, configurar e acessar ambientes de área restrita do Databricks.

Importante

A Área Restrita do Databricks está em Beta.

Os ambientes de área restrita do Databricks são ambientes de desenvolvimento acessíveis para SSH apoiados pelo isolamento de microVM. Cada área restrita é um ambiente pessoal com ferramentas pré-instaladas (Python, Node.js, Rust e CLI do Databricks) e armazenamento persistente.

Para começar:

databricks auth login --host https://...
databricks sandbox register
databricks sandbox create
databricks sandbox ssh

configuração de área restrita do databricks

Configure o nome e a política de parada automática de uma área restrita.

As --nameconfigurações e --idle-timeout as --no-autostopconfigurações são independentes e você pode passar qualquer combinação.

databricks sandbox config <sandbox-id> [flags]

Arguments

<sandbox-id>

    A ID da área restrita a ser configurada.

Opções

--name string

    Rótulo para a área restrita (máximo de 256 bytes). Passe --name= para limpar.

--idle-timeout string

    Duração do tempo limite ocioso. Defina esse valor como 0 (ou) para desmarcar 0se usar o padrão do gerenciador (10m). Intervalo válido: 1m para 24h.

--no-autostop

    Quando verdadeiro, essa área restrita nunca para automaticamente em ociosidade. Passe --no-autostop=false para reverter.

Sinalizadores globais

Exemplos

databricks sandbox config my-sandbox-1234 --name my-project
databricks sandbox config my-sandbox-1234 --idle-timeout 15m
databricks sandbox config my-sandbox-1234 --idle-timeout 1h30m
databricks sandbox config my-sandbox-1234 --idle-timeout 0
databricks sandbox config my-sandbox-1234 --no-autostop
databricks sandbox config my-sandbox-1234 --no-autostop=false
databricks sandbox config my-sandbox-1234 --idle-timeout 30m --no-autostop=false

criação de área restrita do databricks

Crie um novo ambiente de área restrita.

Cria um ambiente de desenvolvimento pessoal apoiado por uma microVM, bloqueia até que a área restrita esteja em execução e imprima a ID da área restrita.

databricks sandbox create [flags]

Opções

--json

    Retornar resultados no formato JSON.

--name string

    Rótulo para a área restrita (máximo de 256 bytes).

Sinalizadores globais

Exemplos

databricks sandbox create
databricks sandbox create --name my-project
databricks sandbox create --json

padrão da área restrita do databricks

Defina a área restrita padrão usada por databricks sandbox ssh.

O padrão é armazenado localmente por ~/.databricks/sandbox.json perfil. A ID da área restrita é validada no servidor antes de ser gravada.

databricks sandbox default <sandbox-id> [flags]

Apelidos: set-default

Arguments

<sandbox-id>

    A ID da área restrita a ser definida como padrão.

Opções

Sinalizadores globais

Example

databricks sandbox default my-sandbox-1234

exclusão de área restrita do databricks

Excluir um ambiente de área restrita.

Isso termina e remove permanentemente a área restrita especificada. O comando solicita a confirmação interativamente; use --auto-approve para ignorar o prompt.

databricks sandbox delete <sandbox-id> [flags]

Arguments

<sandbox-id>

    A ID da área restrita a ser excluída.

Opções

--auto-approve

    Ignore o prompt de confirmação interativo.

Sinalizadores globais

Exemplos

databricks sandbox delete my-sandbox-1234
databricks sandbox delete my-sandbox-1234 --auto-approve

lista de áreas restritas do databricks

Liste seus ambientes de área restrita.

Mostra todas as áreas restritas associadas à sua conta, incluindo o status atual e a ID.

databricks sandbox list [flags]

Opções

--json

    Retornar resultados no formato JSON.

Sinalizadores globais

Exemplos

databricks sandbox list
databricks sandbox list --json

registro de área restrita do databricks

Gere uma chave SSH dedicada para a área restrita e registre-a no serviço.

Este comando:

  1. Gera uma chave SSH Ed25519 em ~/.ssh/sandbox_ed25519 (se ela não existir).
  2. Registra a chave pública com o serviço de área restrita, rotulado com --name.
  3. Opcionalmente, atualize ~/.ssh/config com uma Host sandbox-gw entrada.

Após o registro, databricks sandbox ssh usa essa chave automaticamente.

databricks sandbox register [flags]

Opções

--name string

    Rótulo para a chave registrada (padrão para o nome do host deste computador). Passe --name= para registrar sem um rótulo.

Sinalizadores globais

Exemplos

databricks sandbox register
databricks sandbox register --name my-laptop

ssh de área restrita do databricks

SSH para seu ambiente de área restrita padrão ou específico. Argumentos extras depois -- são passados diretamente para ssh.

databricks sandbox ssh [sandbox-id] [-- <ssh-args-or-command>...] [flags]

Arguments

[sandbox-id]

    ID de área restrita opcional. Se omitido, usará sua área restrita padrão.

Opções

--gateway string

    Nome do host do gateway de área restrita (detectado automaticamente do perfil, se vazio).

--port string

    Porta SSH do gateway de área restrita. Padrão: 2222.

Sinalizadores globais

Exemplos

databricks sandbox ssh
databricks sandbox ssh my-sandbox-1234
databricks sandbox ssh -- ls -la /home
databricks sandbox ssh my-sandbox-1234 -- cat /etc/os-release
databricks sandbox ssh -- -L 8080:localhost:8080

Chaves ssh do sandbox de databricks

Gerenciar chaves SSH registradas no serviço de área restrita.

databricks sandbox ssh-key [command]

Comandos disponíveis

Opções

Sinalizadores globais

lista de chaves de ssh de área restrita do databricks

Listar chaves SSH registradas com o serviço de área restrita.

Cada linha mostra o hash da chave atribuída pelo servidor (usado para excluir a chave), o nome fornecido pelo usuário e os carimbos de data/hora de última utilização e criação. A chave registrada localmente (de databricks sandbox register) é marcada quando seu hash corresponde a uma das entradas listadas.

databricks sandbox ssh-key list [flags]

Opções

--json

    Retornar resultados no formato JSON.

Sinalizadores globais

Exemplos

databricks sandbox ssh-key list
databricks sandbox ssh-key list --json

Exclusão de chaves ssh sandbox databricks

Exclua uma chave SSH registrada no serviço de área restrita.

O hash de chave é o identificador retornado por databricks sandbox ssh-key list. Após a exclusão, as tentativas de SSH que usam a chave privada correspondente não são bem-sucedidas até que você registre a chave novamente.

databricks sandbox ssh-key delete <key-hash> [flags]

Arguments

<key-hash>

    O hash de chave a ser excluído.

Opções

Sinalizadores globais

Example

databricks sandbox ssh-key delete a1b2c3d4e5f6...

início da área restrita do databricks

Ative um ambiente de área restrita interrompido.

Inicializa a microVM de backup e bloqueia até que a área restrita atinja a execução (ou até 10 minutos). Executar esse comando em uma área restrita já em execução é um no-op.

databricks sandbox start <sandbox-id> [flags]

Arguments

<sandbox-id>

    A ID da área restrita a ser ativada.

Opções

Sinalizadores globais

Example

databricks sandbox start my-sandbox-1234

status da área restrita do databricks

Mostrar o status detalhado de um ambiente de área restrita.

databricks sandbox status <sandbox-id> [flags]

Arguments

<sandbox-id>

    A ID da área restrita a ser inspecionada.

Opções

--json

    Retornar resultados no formato JSON.

Sinalizadores globais

Exemplos

databricks sandbox status my-sandbox-1234
databricks sandbox status my-sandbox-1234 --json

Databricks Sandbox stop

Interrompa um ambiente de área restrita em execução.

Encerra a microVM de backup, mas preserva o registro de área restrita e seu armazenamento persistente. Parar uma área restrita já parada é um no-op.

databricks sandbox stop <sandbox-id> [flags]

Arguments

<sandbox-id>

    A ID da área restrita a ser interrompida.

Opções

Sinalizadores globais

Example

databricks sandbox stop my-sandbox-1234

Sinalizadores globais

--debug

  Indica se deve habilitar o registro em log de depuração.

-h ou --help

    Exiba ajuda para a CLI do Databricks ou o grupo de comandos relacionado ou o comando relacionado.

--log-file corda

    Uma cadeia de caracteres que representa o arquivo onde serão gravados os logs de saída. Caso esse sinalizador não seja especificado, o padrão é registrar os logs de saída no stderr.

--log-format formato

    O tipo de formato de log, text ou json. O valor padrão é text.

--log-level corda

    Uma cadeia de caracteres que representa o nível de formato de log. Se não for especificado, o nível de formato de log será desabilitado.

-o, --output tipo

    O tipo de saída do comando, text ou json. O valor padrão é text.

-p, --profile corda

    O nome do perfil no arquivo ~/.databrickscfg, que deverá ser usado para executar o comando. Se esse sinalizador não for especificado, se existir, o perfil nomeado DEFAULT será usado.

--progress-format formato

    O formato para exibir logs de progresso: default, append, inplace ou json

-t, --target corda

    Se aplicável, o destino do pacote a ser usado