Grupo de comandos ssh

Nota:

El uso de la CLI de Databricks está sujeto a la licencia de Databricks y al aviso de privacidad de Databricks, incluidas las disposiciones de datos de uso.

Importante

El túnel SSH está en beta.

El ssh grupo de comandos de la CLI de Databricks permite configurar y establecer conexiones SSH con el proceso y el área de trabajo de Databricks. Consulte Conexión a Databricks mediante un túnel SSH.

conexión ssh de databricks

Conéctese al área de trabajo y el proceso de Databricks a través de SSH. Este comando establece una conexión SSH para el cálculo de Databricks, configurando el túnel SSH y gestionando el proxy de conexión.

databricks ssh connect [flags]

Options

--accelerator string

    Tipo de acelerador de GPU al conectarse al entorno de ejecución de IA. Acepta GPU_1xA10 o GPU_8xH100.

--auto-approve

    Omita las solicitudes de confirmación al instalar extensiones ide y aplicar la configuración del IDE. Predeterminado: false.

--auto-start-cluster

    Inicie automáticamente el clúster si no se está ejecutando. Predeterminado: true.

--base-environment string

    Un entorno base del área de trabajo para configurar previamente Python dependencias al conectarse al proceso sin servidor. Compatible con la versión 4 y posterior del entorno sin servidor; No se admite la versión 5 del entorno sin servidor. Acepta uno de los siguientes formatos:

  • Un nombre para mostrar, por ejemplo, my-workspace-env
  • Una ruta de acceso de archivo YAML, por ejemplo /Workspace/path/to/env.yaml
  • Un identificador de recurso, por ejemplo, workspace-base-environments/dbe_123

    Esta marca no se puede combinar con --cluster.

--cluster string

    Identificador de Databricks para un clúster de un solo usuario dedicado. Cuando se omite esta opción, el túnel SSH se conecta al proceso sin servidor.

    Esta marca no se puede combinar con --base-environment.

--ide string

    IDE que se va a iniciar para la sesión. Acepta vscode o cursor. Para iniciar la sesión en el terminal, omita esta marca y después use cd /Workspace/Users/someone@example.com para acceder al área de trabajo.

--keep-detached-processes

    Mientras el trabajo sigue en curso, mantén el túnel SSH y cualquier proceso separado de la sesión con tmux, , o nohup en ejecución, delimitado por --server-timeoutsetsid. Compatible con servidores sin servidor y computación clásica. Mientras se ejecutan procesos separados, el clúster no termina automáticamente. Ver Mantener procesos separados en funcionamiento. Predeterminado: false.

--max-clients int

    Número máximo de clientes SSH. Predeterminado: 10.

--name string

    Nombre de conexión para reutilizar entre sesiones. Solo proceso sin servidor.

--server-timeout duration

    Vida útil máxima del túnel SSH. El túnel se cierra tras este periodo, incluso si los clientes están conectados. Si no configuras esta bandera, la duración es la mayor entre el valor predeterminado y --shutdown-delay. Si lo configuras, --shutdown-delay no puede ser más largo que este valor. Predeterminado: 24h0m0s.

--shutdown-delay duration

    Retrasa antes de cerrar el túnel después de que el último cliente se desconecte. Predeterminado: 10m0s.

--usage-policy-id string

    ID de política de uso para el túnel SSH sin servidor. Solo sin servidor.

Marcas globales

Examples

En el ejemplo siguiente se conecta al proceso sin servidor:

databricks ssh connect

En el ejemplo siguiente se conecta al proceso sin servidor en el entorno de ejecución de IA mediante un acelerador de GPU:

databricks ssh connect --accelerator GPU_1xA10

En el ejemplo siguiente se conecta al proceso sin servidor mediante un entorno base de área de trabajo que tiene Python dependencias preconfiguradas.

databricks ssh connect --base-environment my-workspace-env

En el ejemplo siguiente se conecta a un clúster dedicado:

databricks ssh connect --cluster 0123-456789-abcdefgh

En el ejemplo siguiente se conecta a un clúster mediante un perfil específico:

databricks ssh connect --cluster 0123-456789-abcdefgh --profile my-profile

En el ejemplo siguiente se conecta con un retraso de apagado personalizado:

databricks ssh connect --cluster 0123-456789-abcdefgh --shutdown-delay 30m

configuración de ssh de databricks

Configure la configuración de SSH para las conexiones al proceso clásico. Solo se admiten las conexiones a clústeres dedicados (de usuario único). Este comando agrega una configuración de host SSH al archivo de configuración de SSH. Después de ejecutar la instalación, puede conectarse a ssh <name>.

En el caso de las conexiones sin servidor, use databricks ssh connect. No se requiere ningún paso de configuración.

databricks ssh setup [flags]

Options

--auto-approve

    Omita las solicitudes de confirmación al volver a crear configuraciones de host SSH existentes. Predeterminado: false.

--auto-start-cluster

    Inicie automáticamente el clúster al establecer la conexión SSH. Predeterminado: true.

--cluster string

    Identificador de Databricks para un clúster de un solo usuario dedicado.

--keep-detached-processes

    Mientras el trabajo sigue en curso, mantén el túnel SSH y cualquier proceso separado de la sesión con tmux, , o nohup en ejecución, delimitado por --server-timeoutsetsid. Solo cómputo clásico. Las conexiones serverless no requieren configuración, así que para mantener procesos separados ejecutándose en computación serverless, pasa esta bandera a ssh connect de databricks . Mientras se ejecutan procesos separados, el clúster no termina automáticamente. Ver Mantener procesos separados en funcionamiento. La entrada generada del host SSH aplica esta bandera cada vez que te conectas. Predeterminado: false.

--name string

    Nombre de host que se va a usar en la configuración de SSH.

--server-timeout duration

    Vida máxima del servidor SSH. El túnel se cierra tras este periodo, incluso si los clientes están conectados. Si no configuras esta bandera, la duración es la mayor entre el valor predeterminado y --shutdown-delay. Si lo configuras, --shutdown-delay no puede ser más largo que este valor. Predeterminado: 24h0m0s.

--shutdown-delay duration

    El túnel SSH termina tras este retraso si no hay conexiones activas. Predeterminado: 10m0s.

--ssh-config string

    Ruta de acceso al archivo de configuración ssh. Predeterminado: ~/.ssh/config.

Marcas globales

Examples

En el ejemplo siguiente se configura la configuración de SSH para un clúster:

databricks ssh setup --name my-cluster --cluster 0123-456789-abcdefgh

Después de ejecutar la instalación, puede conectarse mediante el cliente SSH estándar:

ssh my-cluster

Marcas globales

--debug

  Indica si se va a habilitar el registro de depuración.

-h o --help

    Mostrar ayuda para la CLI de Databricks o el grupo de comandos relacionado o el comando relacionado.

--log-file cadena

    Cadena que representa el archivo en el que se van a escribir registros de salida. Si no se especifica esta marca, el valor predeterminado es escribir registros de salida en stderr.

--log-format formato

    Tipo de formato de registro: text o json. El valor predeterminado es text.

--log-level cadena

    Cadena que representa el nivel de formato de registro. Si no se especifica, el nivel de formato de registro está deshabilitado.

-o, --output tipo

    Tipo de salida del comando, text o json. El valor predeterminado es text.

-p, --profile cadena

    Nombre del perfil en el archivo ~/.databrickscfg que se usará para ejecutar el comando. Si no se especifica esta marca, si existe, se usa el perfil denominado DEFAULT .

--progress-format formato

    Formato para mostrar los registros de progreso: default, append, inplaceo json

-t, --target cadena

    Si procede, el destino del paquete que se va a usar