Daytona

Daytona ļauj Termbridge palaist termināli un priekšskatījumu mākoņa smilškastē. Izmantojiet to, ja vajadzīga reproducējama vide vai mākoņa priekšskatījums, vai ja vēlaties, lai klēpjdators paliktu dīkstāvē.

Prasības

• Daytona atslēga API
• Repozitorijs URL, kuru smilškaste var klonēt
• Git akreditācijas dati, ja repozitorijs ir privāts

Ātrais sākums

Iestatiet aizmugursistēmu uz Daytona un norādiet repozitorija konfigurāciju:

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

Pēc tam palaidiet Termbridge kā parasti:

npx termbridge

Vienmēr iestatiet TERMBRIDGE_SANDBOX_REPO (vai --sandbox-repo). Ja šī vērtība nav norādīta, Termbridge pašlaik izmanto iebūvētu noklusējuma repozitoriju, kas nav publiski pieejams, tāpēc smilškaste tiek izveidota, bet klonēšana neizdodas (#2).

Daytona savienojums

Tie tiek nodoti Daytona SDK. Ja kāds no tiem nav iestatīts, SDK izmanto savu DAYTONA_API_KEY, DAYTONA_API_URL vai DAYTONA_TARGET mainīgo.

Tiešais smilškastes režīms (bez tuneļa)

Tiešajā režīmā Termbridge serveris darbojas smilškastē, un Cloudflare netiek izmantots. Kopīgošanas URL ir Daytona priekšskatījuma saite uz serveri smilškastē.

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

TERMBRIDGE_SANDBOX_SERVER_PORT (vai --port) pēc noklusējuma ir 8080. Tiešajā režīmā tiek izveidota publiska smilškaste, ja vien neiestatāt TERMBRIDGE_SANDBOX_PUBLIC=false, un UI paslēpj termināļu pārslēdzēju.

Joprojām varat iespējot priekšskatījumu, iestatot TERMBRIDGE_SANDBOX_PREVIEW_PORT; tiešajā režīmā šī vērtība tiek pārsūtīta kā servera ports --proxy.

Repozitorija klonēšana

Termbridge izveidos smilškasti un klonēs jūsu repozitoriju smilškastes darba direktorijā.

Izmantojiet šos iestatījumus:

Ja TERMBRIDGE_SANDBOX_PATH nav iestatīts, Termbridge to nosaka pēc repozitorija nosaukuma.

Privātie repozitoriji

Sniedziet git akreditācijas datus, klonējot privātos repozitorijus:

export TERMBRIDGE_SANDBOX_GIT_USERNAME=your_github_username
export TERMBRIDGE_SANDBOX_GIT_TOKEN=your_github_token

Tiek atbalstīts arī TERMBRIDGE_SANDBOX_GIT_PASSWORD; ja tas ir iestatīts, tas aizstāj tokenu.

Koda veidošanas aģenti

Termbridge var instalēt koda veidošanas aģentus smilškastē un sinhronizēt jūsu vietējo autentifikāciju, lai tie būtu uzreiz gatavi lietošanai.

Pilnu iestatīšanas ceļvedi, automātisko režīmu un drošības informāciju skatiet ceļvedī Koda veidošanas aģenti.

Priekšskatījuma režīms

Lai parādītu priekšskatījuma skatu, iestatiet TERMBRIDGE_SANDBOX_PREVIEW_PORT uz portu, ko izmanto izstrādes serveris smilškastē.

Ja izmantojat Vite, pārliecinieties, ka serveris ir piesaistīts visām saskarnēm:

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

Termbridge iegūst Daytona priekšskatījuma saiti un pārsūta tās pieprasījumus caur Termbridge serveri, lai priekšskatījums tiktu ielādēts UI.

Publiskās un privātās smilškastes

Ja mainīgais nav iestatīts, smilškastes ir privātas, izņemot tiešo režīmu, kurā tās ir publiskas.

Privātām smilškastēm Termbridge automātiski pārsūta priekšskatījuma tokenu, kad tas starpnieko priekšskatījuma pieprasījumus.

Tīrīšana un dzīves cikls

Lai dzēstu smilškastes, kad Termbridge tiek aizvērts:

export TERMBRIDGE_SANDBOX_DELETE_ON_EXIT=true

Īslaicīgām vai testa smilškastēm izmantojiet prefiksu:

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

Tādējādi smilškastes lietojums paliek kontrolējams un tiek novērstas diska kvotas problēmas.

CLI karodziņi

Varat konfigurēt Daytona arī ar karodziņiem. Karodziņam ir priekšroka pār atbilstošo vides mainīgo.

Privātai smilškastei nav karodziņa; izmantojiet TERMBRIDGE_SANDBOX_PUBLIC=false. Iebūvētajā termbridge --help izvadē joprojām tiek rādīti --daytona-* nosaukumi un --backend daytona, kas tiek noraidīti (#1).

Problēmu novēršana

Priekšskatījuma skats ir tukšs

• Pārliecinieties, ka izstrādes serveris darbojas smilškastē.
• Izmantojiet --host 0.0.0.0, lai priekšskatījuma ports būtu sasniedzams.
• Pārbaudiet, vai TERMBRIDGE_SANDBOX_PREVIEW_PORT atbilst izstrādes servera portam.

Smilškasti neizdodas izveidot kvotas kļūdu dēļ

• Izdzēsiet vecās smilškastes Daytona informācijas panelī.
• Īslaicīgām sesijām izmantojiet TERMBRIDGE_SANDBOX_DELETE_ON_EXIT=true.

Neizdodas klonēt repozitoriju

• Vēlreiz pārbaudiet repozitorija URL, atzaru un akreditācijas datus.
• Pārliecinieties, ka tokenam Git ir repozitorija lasīšanas piekļuve.