Daytona

Daytona leidžia Termbridge paleisti terminalą ir peržiūrą debesijos smėlio dėžėje. Naudokite tai, kai reikia atkuriamos aplinkos ar debesijos peržiūros arba norite palikti nešiojamąjį kompiuterį nenaudojamą.

Reikalavimai

• Daytona API raktas
• Saugykla URL, kurią smėlio dėžė gali klonuoti
• Git kredencialai, jei saugykla privati

Greita pradžia

Nustatykite vidinę sistemą į Daytona ir pateikite saugyklos konfigūraciją:

export TERMBRIDGE_BACKEND=sandbox-daytona
export TERMBRIDGE_DAYTONA_API_KEY=your_key
export TERMBRIDGE_SANDBOX_REPO=https://github.com/you/your-repo.git
export TERMBRIDGE_SANDBOX_BRANCH=main
export TERMBRIDGE_SANDBOX_PATH=your-repo
export TERMBRIDGE_SANDBOX_NAME=termbridge-sandbox
export TERMBRIDGE_SANDBOX_PUBLIC=true
export TERMBRIDGE_SANDBOX_PREVIEW_PORT=5173
export TERMBRIDGE_SANDBOX_DELETE_ON_EXIT=true

Tada paleiskite Termbridge kaip įprastai:

npx termbridge

Visada nustatykite TERMBRIDGE_SANDBOX_REPO (arba --sandbox-repo). Jei jo nėra, Termbridge šiuo metu naudoja įtaisytąją numatytąją saugyklą, kuri nėra viešai pasiekiama, todėl smėlio dėžė sukuriama, bet klonavimas nepavyksta (#2).

Daytona ryšys

Šios reikšmės perduodamos Daytona SDK. Jei kuri nors iš jų nenustatyta, SDK naudoja savo DAYTONA_API_KEY, DAYTONA_API_URL arba DAYTONA_TARGET kintamąjį.

Tiesioginis smėlio dėžės režimas (be tunelio)

Tiesioginiu režimu Termbridge serveris veikia smėlio dėžėje, o Cloudflare visai nenaudojamas. Bendrinimo URL yra Daytona peržiūros nuoroda į smėlio dėžėje veikiantį serverį.

export TERMBRIDGE_BACKEND=sandbox-daytona
export TERMBRIDGE_SANDBOX_DIRECT=true
export TERMBRIDGE_SANDBOX_SERVER_PORT=8080

TERMBRIDGE_SANDBOX_SERVER_PORT (arba --port) pagal numatytuosius nustatymus yra 8080. Tiesioginiu režimu sukuriama vieša smėlio dėžė, nebent nustatysite TERMBRIDGE_SANDBOX_PUBLIC=false, o UI paslepia terminalų perjungiklį.

Peržiūrą vis tiek galite įjungti nustatę TERMBRIDGE_SANDBOX_PREVIEW_PORT; tiesioginiu režimu ši reikšmė perduodama kaip serverio --proxy prievadas.

Saugyklos klonavimas

Termbridge sukurs smėlio dėžę ir klonuos jūsų saugyklą į jos darbinį katalogą.

Naudokite šiuos nustatymus:

Jei TERMBRIDGE_SANDBOX_PATH nenustatytas, Termbridge nustato jį pagal saugyklos pavadinimą.

Privačios saugyklos

Klonuodami privačias saugyklas, pateikite git prisijungimo duomenis:

export TERMBRIDGE_SANDBOX_GIT_USERNAME=your_github_username
export TERMBRIDGE_SANDBOX_GIT_TOKEN=your_github_token

Taip pat palaikomas TERMBRIDGE_SANDBOX_GIT_PASSWORD; jį nustačius, jis turi pirmenybę prieš prieigos raktą.

Programavimo agentai

Termbridge gali įdiegti programavimo agentus smėlio dėžėje ir sinchronizuoti vietinius autentifikavimo duomenis, kad agentai iškart būtų paruošti naudoti.

Išsamią konfigūraciją, automatinį režimą ir saugumo informaciją rasite vadove Programavimo agentai.

Peržiūros režimas

Norėdami rodyti peržiūros rodinį, nustatykite TERMBRIDGE_SANDBOX_PREVIEW_PORT į prievadą, kurį smėlio dėžėje naudoja kūrimo serveris.

Jei naudojate Vite, būtinai susiekite serverį su visomis sąsajomis:

npm run dev -- --host 0.0.0.0 --port 5173

Termbridge gauna Daytona peržiūros nuorodą ir perduoda ją per Termbridge serverį, kad peržiūra būtų įkelta į UI.

Viešos ir privačios smėlio dėžės

Jei kintamasis nenustatytas, smėlio dėžės yra privačios, išskyrus tiesioginį režimą, kuriame jos yra viešos.

Privačiose smėlio dėžėse Termbridge automatiškai perduoda peržiūros prieigos raktą, kai tarpininkauja peržiūrai.

Valymas ir gyvavimo ciklas

Jei norite ištrinti smėlio dėžes išėjus Termbridge:

export TERMBRIDGE_SANDBOX_DELETE_ON_EXIT=true

Trumpalaikėms arba bandomosioms smėlio dėžėms naudokite prefiksą:

export TERMBRIDGE_SANDBOX_NAME=termbridge-test-$(date +%s)
export TERMBRIDGE_SANDBOX_DELETE_ON_EXIT=true

Taip galėsite kontroliuoti smėlio dėžių naudojimą ir išvengti disko kvotos problemų.

CLI vėliavėlės

Daytona taip pat galite konfigūruoti vėliavėlėmis. Vėliavėlės reikšmė turi pirmenybę prieš atitinkamą aplinkos kintamąjį.

Privataus smėlio dėžės režimo vėliavėlės nėra; naudokite TERMBRIDGE_SANDBOX_PUBLIC=false. Įtaisytame termbridge --help išvestyje vis tiek rodomi --daytona-* pavadinimai ir --backend daytona, kurie atmetami (#1).

Trikčių šalinimas

Peržiūros langas tuščias

• Įsitikinkite, kad kūrimo serveris veikia smėlio dėžėje.
• Naudokite --host 0.0.0.0, kad peržiūros prievadas būtų pasiekiamas.
• Patikrinkite, ar TERMBRIDGE_SANDBOX_PREVIEW_PORT sutampa su kūrimo serverio prievadu.

Nepavyksta sukurti smėlio dėžės dėl kvotos klaidų

• Ištrinkite senas smėlio dėžes Daytona valdymo skydelyje.
• Trumpalaikiams seansams naudokite TERMBRIDGE_SANDBOX_DELETE_ON_EXIT=true.

Nepavyksta klonuoti saugyklos

• Dar kartą patikrinkite saugyklos URL, šaką ir kredencialus.
• Įsitikinkite, kad Git prieigos raktas suteikia skaitymo prieigą prie saugyklos.