ssh 명령 그룹

비고

Databricks CLI 사용은 Databricks 라이선스 및 Databricks 개인 정보 보호 고지, 그리고 모든 사용 데이터 관련 조항의 적용을 받습니다.

중요합니다

SSH 터널은 베타에 있습니다.

ssh Databricks CLI 내의 명령 그룹을 사용하면 Databricks 컴퓨팅 및 작업 영역에 대한 SSH 연결을 설정하고 설정할 수 있습니다. SSH 터널을 사용하여 Databricks에 연결을 참조하세요.

Databricks SSH Connect

SSH를 통해 Azure Databricks 컴퓨트와 작업 공간에 연결하세요. 이 명령어는 Azure Databricks 컴퓨트에 SSH 연결을 설정하고, SSH 터널을 설정하며, 연결 프록시를 처리합니다.

Tip

Databricks CLI 버전 1.23.0 이상에서는 서버리스 컴퓨트 및 전용 클러스터의 세션에 Unity 게이트웨이용으로 미리 설정된 명령어가 포함되어 claudecodex 있습니다. SSH 세션에서 코딩 에이전트 실행을 참조하세요.

databricks ssh connect [flags]

Options

--accelerator string

    AI 런타임에 연결할 때 GPU 가속기 유형입니다. GPU_1xA10 또는 GPU_8xH100를 수락합니다.

--auto-approve

    IDE 확장을 설치하고 IDE 설정을 적용할 때 확인 프롬프트를 건너뜁니다. 기본값: false.

--auto-start-cluster

    클러스터가 실행되고 있지 않으면 클러스터를 자동으로 시작합니다. 기본값: true.

--base-environment string

    서버리스 컴퓨팅에 연결할 때 Python 종속성을 미리 구성하는 작업 영역 기본 환경입니다. 서버리스 환경 버전 4 이하에서 지원됩니다. 서버리스 환경 버전 5는 지원되지 않습니다. 다음 형식 중 하나를 허용합니다.

• 표시 이름(예: my-workspace-env
• YAML 파일 경로(예: /Workspace/path/to/env.yaml
• 리소스 ID(예: workspace-base-environments/dbe_123

    이 플래그는 .와 함께 --cluster사용할 수 없습니다.

--cluster string

    전용 단일 사용자 클러스터에 대한 Databricks ID입니다. 이 옵션을 생략하면 SSH 터널이 서버리스 컴퓨팅에 연결됩니다.

    이 플래그는 .와 함께 --base-environment사용할 수 없습니다.

--ide string

    세션에 대해 시작할 IDE입니다. vscode 또는 cursor를 수락합니다. 터미널에서 세션을 시작하려면 이 플래그를 생략한 다음 작업 영역에 액세스하는 데 사용합니다 cd /Workspace/Users/someone@example.com .

--keep-detached-processes

    작업이 진행 중인 동안, SSH 터널과 세션 tmux에서 분리된 프로세스는 , , setsid또는 nohup 실행 --server-timeout중인 상태로 유지하세요. 서버리스와 클래식 컴퓨트에서 지원됩니다. 분리된 프로세스가 실행되는 동안에도 컴퓨트는 계속 실행되며, 클래식 클러스터는 자동으로 종료되지 않습니다. 분리 된 프로세스 실행 상태를 유지하세요. 기본값: false.

--max-clients int

    SSH 클라이언트의 최대 수입니다. 기본값: 10.

--name string

    세션 간에 다시 사용할 연결 이름입니다. 서버리스 컴퓨팅만 해당합니다.

--server-timeout duration

    SSH 터널의 최대 수명. 이 시간 이후에는 클라이언트가 연결되어 있어도 터널이 종료됩니다. 이 플래그를 설정하지 않으면, 기본 플래그와 --shutdown-delay중 수명이 더 깁니다. 설정 --shutdown-delay 하면 이 값보다 길어질 수 없습니다. 기본값: 24h0m0s.

--shutdown-delay duration

    마지막 클라이언트가 연결이 끊긴 후 터널을 종료하기 전에 지연하세요. 기본값: 10m0s.

--usage-policy-id string

    서버리스 SSH 터널의 사용 정책 ID. 서버리스만 가능합니다.

전역 플래그

예시

다음 예제에서는 서버리스 컴퓨팅에 연결합니다.

databricks ssh connect

다음 예제에서는 GPU 가속기를 사용하여 AI 런타임에서 서버리스 컴퓨팅에 연결합니다.

databricks ssh connect --accelerator GPU_1xA10

다음 예제에서는 Python 종속성이 미리 구성된 작업 영역 기본 환경을 사용하여 서버리스 컴퓨팅에 연결합니다.

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

다음 예제에서는 전용 클러스터에 연결합니다.

databricks ssh connect --cluster 0123-456789-abcdefgh

다음 예제에서는 특정 프로필을 사용하여 클러스터에 연결합니다.

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

다음 예에서는 사용자 지정 종료 지연이 적용되는 과정을 설명합니다.

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

databricks ssh 설정

클래식 컴퓨팅에 대한 연결에 대한 SSH 구성을 설정합니다. 전용(단일 사용자) 클러스터에 대한 연결만 지원됩니다. 이 명령은 SSH 구성 파일에 SSH 호스트 구성을 추가합니다. 설치 프로그램을 실행한 ssh <name>후 .

서버리스 연결의 경우 databricks ssh connect를 사용합니다. 설치 단계가 필요하지 않습니다.

databricks ssh setup [flags]

Options

--auto-approve

    기존 SSH 호스트 구성을 다시 만들 때 확인 프롬프트를 건너뜁니다. 기본값: false.

--auto-start-cluster

    SSH 연결을 설정할 때 클러스터를 자동으로 시작합니다. 기본값: true.

--cluster string

    전용 단일 사용자 클러스터에 대한 Databricks ID입니다.

--keep-detached-processes

    작업이 진행 중인 동안, SSH 터널과 세션 tmux에서 분리된 프로세스는 , , setsid또는 nohup 실행 --server-timeout중인 상태로 유지하세요. 클래식 컴퓨팅만 해당합니다. 서버리스 연결은 설정이 필요하지 않으니, 분리된 프로세스를 서버리스 컴퓨트에서 계속 실행하려면 이 플래그를 Databrick의 ssh connect 에 전달하세요. 분리된 프로세스가 실행되는 동안, 클러스터가 자동으로 종료되지는 않습니다. 분리 된 프로세스 실행 상태를 유지하세요. 생성된 SSH 호스트 항목은 연결할 때마다 이 플래그를 적용합니다. 기본값: false.

--name string

    SSH 구성에서 사용할 호스트 이름입니다.

--server-timeout duration

    SSH 터널의 최대 수명. 이 시간 이후에는 클라이언트가 연결되어 있어도 터널이 종료됩니다. 이 플래그를 설정하지 않으면, 기본 플래그와 --shutdown-delay중 수명이 더 깁니다. 설정 --shutdown-delay 하면 이 값보다 길어질 수 없습니다. 기본값: 24h0m0s.

--shutdown-delay duration

    활성 연결이 없으면 SSH 터널은 이 지연 후에 종료됩니다. 기본값: 10m0s.

--ssh-config string

    SSH 구성 파일의 경로입니다. 기본값: ~/.ssh/config.

전역 플래그

예시

다음 예제에서는 클러스터에 대한 SSH 구성을 설정합니다.

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

설치 프로그램을 실행한 후 표준 SSH 클라이언트를 사용하여 연결할 수 있습니다.

ssh my-cluster

전역 플래그

--debug

  디버그 로깅을 사용할지 여부입니다.

-h 또는 --help

    Databricks CLI 또는 관련 명령 그룹 또는 관련 명령에 대한 도움말을 표시합니다.

--log-file 문자열

    출력 로그를 쓸 파일을 나타내는 문자열입니다. 이 플래그가 지정되지 않으면 출력 로그는 기본적으로 stderr에 기록됩니다.

--log-format 포맷

    로그 형식 형식 text 또는 json. 기본값은 text입니다.

--log-level 문자열

    로그 형식 수준을 나타내는 문자열입니다. 지정하지 않으면 로그 형식 수준을 사용할 수 없습니다.

-o, --output 유형

    명령 출력 형식 text 또는 json. 기본값은 text입니다.

-p, --profile 문자열

    명령을 실행하는 데 사용할 파일의 프로필 ~/.databrickscfg 이름입니다. 이 플래그를 지정하지 않으면, 존재하는 경우 DEFAULT로 명명된 프로필이 사용됩니다.

--progress-format 포맷

    진행률 로그를 표시할 형식: default, append, inplace또는 json

-t, --target 문자열

    해당하는 경우 사용할 번들 대상