ssh kommandogrupp

Anmärkning

Databricks CLI-användning omfattas av Databricks-licensen och Databricks sekretessmeddelande, inklusive eventuella användningsdatabestämmelser.

Viktigt!

SSH-tunneln är i Beta.

Med ssh kommandogruppen i Databricks CLI kan du konfigurera och upprätta SSH-anslutningar till databricks-beräknings- och arbetsytan. Se Ansluta till Databricks med hjälp av en SSH-tunnel.

Databricks SSH Connect

Anslut till databricks-beräknings- och arbetsytan via SSH. Detta kommando upprättar en SSH-anslutning till Databricks beräkning, sätter upp SSH-tunneln och hanterar anslutningsproxyn.

databricks ssh connect [flags]

Options

--accelerator string

    GPU-acceleratorns typ när du ansluter till AI Runtime. Accepterar GPU_1xA10 eller GPU_8xH100.

--auto-approve

    Hoppa över bekräftelsemeddelanden när du installerar IDE-tillägg och tillämpar IDE-inställningar. Förvald: false.

--auto-start-cluster

    Starta klustret automatiskt om det inte körs. Förvald: true.

--base-environment string

    En basmiljö för arbetsytan för att förkonfigurera Python beroenden vid anslutning till serverlös beräkning. Stöds med serverlös miljö version 4 och senare; serverlös miljö version 5 stöds inte. Accepterar något av följande format:

  • Ett visningsnamn, till exempel my-workspace-env
  • En YAML-filsökväg, till exempel /Workspace/path/to/env.yaml
  • Ett resurs-ID, till exempel workspace-base-environments/dbe_123

    Den här flaggan kan inte kombineras med --cluster.

--cluster string

    Databricks-ID för ett dedikerat kluster med en användare. När det här alternativet utelämnas ansluter SSH-tunneln till serverlös beräkning.

    Den här flaggan kan inte kombineras med --base-environment.

--ide string

    IDE att starta för sessionen. Accepterar vscode eller cursor. Om du vill starta sessionen i terminalen utelämnar du den här flaggan och använder cd /Workspace/Users/someone@example.com sedan för att komma åt din arbetsyta.

--keep-detached-processes

    Medan arbetet fortfarande pågår, håll SSH-tunneln och alla processer frånkopplade från sessionen med tmux, setsid, eller nohup körande, begränsad av --server-timeout. Stöds på serverless och klassisk beräkning. Medan fristående processer körs fortsätter beräkningen att köra, och ett klassiskt kluster avslutas inte automatiskt. Se Håll fristående processer igång. Förvald: false.

--max-clients int

    Maximalt antal SSH-klienter. Förvald: 10.

--name string

    Anslutningsnamn som ska återanvändas mellan sessioner. Endast serverlös beräkning.

--server-timeout duration

    Maximal livslängd för SSH-tunneln. Tunneln stängs av efter denna tid, även om klienterna är anslutna. Om du inte sätter denna flagga är livslängden längre av standarden och --shutdown-delay. Om du sätter det får det --shutdown-delay inte vara längre än detta värde. Förvald: 24h0m0s.

--shutdown-delay duration

    Vänta innan du stänger ner tunneln efter att den sista klienten kopplat bort. Förvald: 10m0s.

--usage-policy-id string

    Användningspolicy-ID för den serverlösa SSH-tunneln. Endast serverlöst.

Globala flaggor

Examples

Följande exempel ansluter till serverlös beräkning:

databricks ssh connect

Följande exempel ansluter till serverlös beräkning på AI Runtime med hjälp av en GPU-accelerator:

databricks ssh connect --accelerator GPU_1xA10

I följande exempel ansluts till serverlös beräkning med hjälp av en arbetsytebasmiljö som har Python beroenden förkonfigurerade.

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

Följande exempel ansluter till ett dedikerat kluster:

databricks ssh connect --cluster 0123-456789-abcdefgh

Följande exempel ansluter till ett kluster med en specifik profil:

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

Följande exempel ansluter med en anpassad avstängningsfördröjning:

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

databricks ssh-konfiguration

Konfigurera SSH-konfiguration för anslutningar till klassisk beräkning. Endast anslutningar till dedikerade kluster (en användare) stöds. Det här kommandot lägger till en SSH-värdkonfiguration i SSH-konfigurationsfilen. När installationen har körts kan du ansluta med ssh <name>.

För serverlösa anslutningar använder du databricks ssh connect. Inget installationssteg krävs.

databricks ssh setup [flags]

Options

--auto-approve

    Hoppa över bekräftelsemeddelanden när du återskapar befintliga SSH-värdkonfigurationer. Förvald: false.

--auto-start-cluster

    Starta klustret automatiskt när du upprättar SSH-anslutningen. Förvald: true.

--cluster string

    Databricks-ID för ett dedikerat kluster med en användare.

--keep-detached-processes

    Medan arbetet fortfarande pågår, håll SSH-tunneln och alla processer frånkopplade från sessionen med tmux, setsid, eller nohup körande, begränsad av --server-timeout. Endast klassisk beräkning. Serverlösa anslutningar kräver ingen installation, så för att hålla fristående processer igång på serverlös beräkning, skicka denna flagga till databricks ssh connect istället. Medan frikopplade processer körs avslutas inte klustret automatiskt. Se Håll fristående processer igång. Den genererade SSH-värdposten applicerar denna flagga varje gång du ansluter upp. Förvald: false.

--name string

    Värdnamn som ska användas i SSH-konfigurationen.

--server-timeout duration

    Maximal livslängd för SSH-tunneln. Tunneln stängs av efter denna tid, även om klienterna är anslutna. Om du inte sätter denna flagga är livslängden längre av standarden och --shutdown-delay. Om du sätter det får det --shutdown-delay inte vara längre än detta värde. Förvald: 24h0m0s.

--shutdown-delay duration

    SSH-tunneln avslutas efter denna fördröjning om det inte finns några aktiva anslutningar. Förvald: 10m0s.

--ssh-config string

    Sökväg till SSH-konfigurationsfilen. Förvald: ~/.ssh/config.

Globala flaggor

Examples

I följande exempel konfigureras SSH-konfiguration för ett kluster:

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

När installationen har körts kan du ansluta med SSH-standardklienten:

ssh my-cluster

Globala flaggor

--debug

  Om felsökningsloggning ska aktiveras.

-h eller --help

    Visa hjälp för Databricks CLI eller den relaterade kommandogruppen eller det relaterade kommandot.

--log-file sträng

    En sträng som representerar filen som utdataloggarna ska skrivas till. Om den här flaggan inte anges är standardvärdet att skriva utdataloggar till stderr.

--log-format Format

    Loggformattypen, text eller json. Standardvärdet är text.

--log-level sträng

    En sträng som representerar loggformatnivån. Om det inte anges inaktiveras loggformatnivån.

-o, --output typ

    Kommandots utdatatyp, text eller json. Standardvärdet är text.

-p, --profile sträng

    Namnet på profilen i ~/.databrickscfg-filen som ska användas för att köra kommandot. Om den här flaggan inte anges används den namngivna DEFAULT profilen om den finns.

--progress-format Format

    Formatet för att visa förloppsloggar: default, append, inplaceeller json

-t, --target sträng

    Om tillämpligt, paketmålet som ska användas