Tööriistad

Rediacc sisaldab nelja tööriista igapäevaseks tööks oma masinate ja repositooriumidega: failide sünkroonimine SSH üle, SSH-terminal, VS Code integratsioon ja CLI uuendused. Kõik neli töötavad SSH üle. Kaugmasinale ei pea installima agenti ega deemooni. Kui soovid graafilist kasutajaliidest, siis vaata teisele leheküljele.

Failide sünkroonimine (sync)

Edasta faile oma tööjaama ja kaugrepositooriumi vahel, kasutades rsync üle SSH.

Failide üleslaadimine

--local võtab vastu ühe või mitu teed. Iga tee võib olla fail või kataloog. Failid jõuavad asukohta <remote>/<basename>; kataloogi sisu ühineb asukohaga <remote>/. Ühe faili puhul eelista --remote-file, et määrata failile sihtkoha tee otsesõnu.

# Kataloog (sisu ühineb kaugsisuga)
rdc repo sync upload my-app --local ./src --remote /app/src

# Üks fail, mis lisatakse kaugkataloogi (basename säilitatakse)
rdc repo sync upload my-app --local ./config.yml --remote /app/conf

# Üks fail, otsene sihtkoha tee
rdc repo sync upload my-app --local ./config.yml --remote-file /app/conf/config.yml

# Mitu allikat ühes käsus
rdc repo sync upload my-app --local a.yml b.yml ./assets --remote /app

--remote ja --remote-file on üksteist välistavad. --remote-file nõuab täpselt ühte --local teed, mis osutab failile.

--mirror ei saa kombineerida faili allikaga; see kustutaks kaugkataloogis kõrvutised failid.

Failide allalaadimine

Kataloogi puhul kasuta --remote (vaikimisi) või ühe faili puhul --remote-file. Kaks lippu on üksteist välistavad.

# Kataloog
rdc repo sync download my-app --remote /app/data --local ./data

# Üks fail - --local peab olema olemasolev kataloog
rdc repo sync download my-app --remote-file /app/conf/config.yml --local ./local-conf

Sünkroonimise oleku kontrollimine

rdc repo sync status my-app

Valikud

Valik	Kirjeldus
-m, --machine <name>	Sihtkohaks olev masin
<ref> (positsiooniline)	Siht-hoidla viide: name, name:tag, valikuliselt @machine
--local <paths...>	Üks või mitu kohaliku faili või kataloogi teed (üleslaadimine) või kohalik sihtkataloog (allalaadimine)
--remote <path>	Kaugkataloog (suhteliselt repositooriumi ühenduspunktist)
--remote-file <path>	Kaugfaili tee ühe faili üles- või allalaadimiseks (alternatiiv --remote-le)
--dry-run	Kuva muutused eelvaatena ilma ülekandeta
--mirror	Peegelda allikas sihtkohta, kustuta lisafailid (ainult kataloogi allikate puhul)
--verify	Kontrolli kontrollsummasid pärast ülekannet
--confirm	Interaktiivne kinnitamine üksikasjaliku vaatega
--exclude <patterns...>	Välista failimustrid
--skip-router-restart	Jäta marsruuteri serveri taaskäivitamine toimingu järel vahele

SSH-terminal (term)

Ava interaktiivne SSH-seanss masinaga või repositooriumi keskkonda.

Lühisüntaks

Kiireim viis ühenduse loomiseks:

rdc term connect server-1                    # Ühenda masinaga
rdc term connect my-app             # Ühenda repositooriumiga

Käsu käivitamine

Käivita käsk ilma interaktiivset seanssi avamata:

rdc term connect server-1 -c "uptime"
rdc term connect my-app -c "docker ps"

Repositooriumiga ühendamisel seadistatakse DOCKER_HOST automaatselt repositooriumi isoleeritud Dockeri soklile, nii et docker ps näitab ainult selle repositooriumi konteinereid.

Alamkäsk connect

Alamkäsk connect teeb sama otseste lippudega:

rdc term connect server-1
rdc term connect my-app

Konteineri toimingud

Suhtle otse töötava konteineriga:

# Ava kest konteineri sees
rdc repo exec my-app -c <container> -i -- bash

# Vaata konteineri logisid
rdc repo logs my-app -c <container>

# Jälgi logisid reaalajas
rdc repo logs my-app -c <container> --follow

# Vaata konteineri statistikat
rdc repo exec my-app -c <container> -i -- bash --container-action stats

# Käivita käsk konteineris
rdc repo exec my-app -c <container> -- ls -la

Valik	Käsk	Kirjeldus
-c, --container <name>	mõlemad	Sihtkonteiner repositooriumis
--lines <n>	repo logs	Kuvatavate logiridade arv
-f, --follow	repo logs	Jälgi logisid pidevalt
--timestamps	repo logs	Lisa igale reale ajatempel
-i, --interactive	repo exec	Hoia stdin avatuna (vajalik kesta jaoks)
-u, --user <user>	repo exec	Käivita konkreetse kasutajana

VS Code integratsioon (vscode)

Ava kaugne SSH-seanss VS Code’is, eelkonfigureeritud õigete SSH seadetega.

Repositooriumiga ühendamine

rdc vscode connect my-app

See käsk:

1. Tuvastab sinu VS Code paigalduse
2. Konfigureerib SSH-ühenduse failis ~/.ssh/config
3. Säilitab SSH-võtme seansiks
4. Avab VS Code’i kaugneva SSH-ühendusega repositooriumi teele

Konfigureeritud ühenduste loetlemine

rdc vscode list

Ühenduste puhastamine

rdc vscode cleanup

Eemaldab VS Code’i SSH-konfiguratsioonid, mida enam ei vajata.

Konfiguratsiooni kontrollimine

rdc vscode check

Kontrollib VS Code’i paigaldust, Remote SSH laiendust ja aktiivseid ühendusi.

Eeltingimus: Paigalda VS Code’is laiendus Remote - SSH.

VS Code brauseris

Kohalikku VS Code’i pole? Käivita redaktor repositooriumi liivakastist ja ava see mistahes brauseris:

rdc vscode connect my-app --browser

See käsk:

1. Paigaldab avatud lähtekoodiga redaktoriserveri masinale ühe korra (kirjutuskaitstud jagatud tee, kontrollsummaga kinnitatud)
2. Käivitab selle repositooriumi liivakastis, nii et failipuu, integreeritud terminal ja kõik alamprotsessid näevad täpselt seda, mida repositoorium näeb
3. Avab SSH-tunneli kohalikule pordile ja käivitab sinu brauseri seanssipõhise tokeniga URL-iga

Server jätkab tööd pärast tunneli sulgemist; uuesti ühendades kasutatakse seda uuesti. Halda seda käskudega:

rdc vscode serve status my-app
rdc vscode serve stop my-app

Valik	Kirjeldus
--no-open	Prindi URL brauseri avamise asemel
--url-only	Prindi täpselt üks URL-rida stdout-i (skriptimiseks) ja hoia tunnel avatuna
--local <port>	Vali kohaliku tunneli port
--server-provider <id>	Redaktoriserveri teostus: openvscode (vaikimisi) või code-server
--server-archive <file>	Paigalda eellaaditud tarballi kaudu masinalt (internetiühendust pole vaja)

Töötab Linux, macOS, Windows või tahvelarvutist. Ainus kohalik nõue on brauser.

CLI uuendused (update)

Hoia rdc CLI ajakohane.

Uuenduste kontrollimine

rdc update --check-only

Uuenduse rakendamine

rdc update

Uuendused laaditakse alla ja rakendatakse paigal. CLI valib automaatselt sinu platvormile (Linux, macOS või Windows) sobiva binaarfaili. Uus versioon jõustub järgmisel käivitamisel.

Tagasipööramine

rdc update --rollback

Pöördub tagasi eelmisele paigaldatud versioonile. Saadaval ainult pärast uuenduse rakendamist.

Uuenduse olek

rdc update --status

Kuvab praeguse versiooni, uuenduskanali ja automaatse uuendamise konfiguratsiooni.

Väljalaskekanalid

rdc update --channel edge      # Pidevalt juurutatavad tootmisuuendused
rdc update --channel stable    # Edutatud edge'ist pärast 7-päevast leotamist (vaikimisi)
rdc update --status            # Kuva praegune kanal ja versiooni info