Masina ülesseadmine

Esimese masina käivitamiseks on neli sammu: loo konfiguratsioon, registreeri server, valmista see ette ja seadista vajadusel infrastruktuur avalikule liiklusele.

1. samm: loo konfiguratsioon

Konfiguratsioon on nimega konfiguratsioonifail, mis salvestab sinu SSH-mandaadid, masinate definitsioonid ja repositooriumi seosed. Mõtle sellest kui projekti tööruumist.

rdc config init my-infra --ssh-key ~/.ssh/id_ed25519

Valik	Nõutud	Kirjeldus
--ssh-key <path>	Jah	Tee sinu SSH privaatvõtmeni. Tilde (~) laiendatakse automaatselt.
--renet-path <path>	Ei	Kohandatud tee renet-binaarfailini kaugmasinates. Vaikimisi kasutatakse standardset paigaldusasukohta.

See loob konfiguratsioonifaili nimega my-infra ja salvestab selle asukohta ~/.config/rediacc/my-infra.json. Vaikekonfiguratsioon (kui nime ei anta) salvestatakse failina ~/.config/rediacc/rediacc.json.

Sul võib olla mitu konfiguratsioonifaili (nt production, staging, dev). Nende vahel saad lülituda iga käsu puhul lipuga --config.

2. samm: lisa masin

Registreeri kaugserver masinana konfiguratsioonis:

rdc machine add server-1 --ip 203.0.113.50 --user deploy

Valik	Nõutud	Vaikeväärtus	Kirjeldus
--ip <address>	Jah	-	Kaugserveri IP-aadress või hostinimi
--user <username>	Jah	-	SSH-kasutajanimi kaugserveris
--port <port>	Ei	22	SSH-port
--datastore <path>	Ei	/mnt/rediacc	Tee serveris, kuhu Rediacc salvestab krüptitud repositooriume

Pärast masina lisamist käivitab rdc automaatselt ssh-keyscan, et hankida serveri hostimisvõtmed. Seda saad käivitada ka käsitsi:

rdc machine scan-keys server-1

Kõigi registreeritud masinate vaatamiseks:

rdc machine list

3. samm: seadista masin

Valmista kaugserver ette kõigi vajalike sõltuvustega:

rdc machine setup server-1

See käsk:

1. Laadib renet-binaarfaili serverisse üles SFTP kaudu
2. Paigaldab Docker, containerd ja cryptsetup (kui neid pole)
3. Loob rediacc süsteemikasutaja (UID 7111)
4. Loob andmehoidla kataloogi ja valmistab selle ette krüptitud repositooriumide jaoks

Valik	Nõutud	Vaikeväärtus	Kirjeldus
--datastore <path>	Ei	/mnt/rediacc	Andmehoidla kataloog serveris
--datastore-size <size>	Ei	95%	Kui suur osa saadaolevast kettaruumist eraldatakse andmehoidlale
--debug	Ei	false	Luba tõrkeotsinguks üksikasjalik väljund

Seadistust on vaja käivitada iga masina kohta ainult üks kord. Vajadusel on seda ohutu uuesti käivitada.

Andmesalvestuse taustasüsteemid

Andmesalv on masinapõhine salvestuspesa, mis hoiab krüptitud repositooriumi pilte. machine setup loob vaikimisi kohaliku andmesalve: silmus-toetatud BTRFS-failisüsteemi serveri enda kettal, mille suurus määratakse lipuga --datastore-size (vaikimisi 95% saadaolevast kettast). See on õige taustasüsteem peaaegu iga ühemasinalise juurutuse jaoks ega vaja midagi peale serveri enda.

Andmesalve suuruse määramine

--datastore-size võtab vastu protsendi (95%) või absoluutse suuruse (50G, 1T). Andmesalve saab hiljem veebis suurendada:

rdc datastore resize ds-server-1 --size 200G

Andmesalve sees olevate repositooriumide suurus määratakse sõltumatult repo create ajal ja neid saab töö ajal laiendada, nii et sul pole vaja andmesalve ette liigselt ette valmistada.

Ceph RBD taustasüsteem

Jagatud, horisontaalselt skaleeruva või Kubernetese-toega salvestuse jaoks initsialiseeri andmesalv selle asemel välisel Ceph-klastril. Andmesalv elab siis RBD-pildil (BTRFS selle peal, ilma pildipõhise LUKS-kihita) ja fork’id kasutavad BTRFS-reflinkide asemel RBD copy-on-write kloone.

# 1. Salvesta masina Ceph-viide (pesa + RBD-pilt, mitte salajane)

# 2. Initsialiseeri andmesalv Ceph-taustasüsteemil
rdc datastore create ds-server-1 -m server-1 --backend ceph --pool rbd --image datastore-server1 --size 100G

Ceph-võtmerõngad jäävad masinatesse; konfiguratsioonifail sisaldab ainult mittesalajasi pesa- ja pildiviiteid. Ceph on ka salvestuskiht, mida Kubernetese klastrid tarbivad ceph-csi kaudu. Vaata juhendit Kubernetes klastrite ja püsivate köidete jaoks ning Arhitektuur kahe taustasüsteemi võrdluseks.

Hostimisvõtmete haldamine

Kui serveri SSH hostimisvõti muutub (nt pärast uuesti paigaldamist), uuenda salvestatud võtmeid:

rdc machine scan-keys server-1

See uuendab sinu konfiguratsioonis selle masina knownHosts välja.

SSH ühenduvuse testimine

Pärast masina lisamist veendu, et sellega on võimalik ühenduda:

rdc term connect server-1 -c "hostname"

See avab masinaga SSH-ühenduse ja käivitab käsu. Kui see õnnestub, on sinu SSH-konfiguratsioon korrektne.

Üksikasjalikuma diagnostika saamiseks käivita:

rdc doctor

Vihje: SSH-ühenduvuse kontrollimiseks käivita rdc term connect <machine> -c "hostname" või kasuta otse ssh.

Infrastruktuuri konfiguratsioon

Masinate jaoks, mis peavad liiklust avalikult teenindama, konfigureeri infrastruktuuriseaded:

Infrastruktuuri seadistamine

rdc machine infra set server-1 \
  --public-ipv4 203.0.113.50 \
  --base-domain example.com \
  --cert-email admin@example.com \
  --cf-dns-token your-cloudflare-api-token

Valik	Ulatus	Kirjeldus
--public-ipv4 <ip>	Masin	Avalik IPv4-aadress; puhverserveri sisenemispunktid luuakse ainult konfigureeritud aadressiperekondade jaoks
--public-ipv6 <ip>	Masin	Avalik IPv6-aadress; puhverserveri sisenemispunktid luuakse ainult konfigureeritud aadressiperekondade jaoks
--base-domain <domain>	Masin	Rakenduste alusdomeen (nt example.com)
--cert-email <email>	Konfiguratsioon	E-post Let’s Encrypt TLS-sertifikaatide jaoks (jagatud masinate vahel)
--cf-dns-token <token>	Konfiguratsioon	Cloudflare DNS-i API token ACME DNS-01 väljakutsete jaoks (jagatud masinate vahel)
--tcp-ports <ports>	Masin	Komaga eraldatud lisatavad TCP-pordid edasisaatmiseks (nt 25,143,465,587,993)
--udp-ports <ports>	Masin	Komaga eraldatud lisatavad UDP-pordid edasisaatmiseks (nt 53)

Masina ulatusega valikud salvestatakse iga masina kohta eraldi. Konfiguratsiooni ulatusega valikud (--cert-email, --cf-dns-token) on jagatud kõigi konfiguratsiooni masinate vahel. Seadista need üks kord ja need kehtivad kõikjal.

Infrastruktuuri vaatamine

rdc machine infra show server-1

Serverisse lükkamine

Genereeri ja rakenda Traefiki pöördpuhverserveri konfiguratsioon serverisse:

rdc machine infra push server-1

See käsk:

1. Rakendab renet-binaarfaili kaugmasinasse
2. Konfigureerib Traefiki pöördpuhverserveri, ruuteri ja systemd-teenused
3. Loob Cloudflare’i DNS-kirjed masina alamdomeeni jaoks (server-1.example.com ja *.server-1.example.com), kui --cf-dns-token on seadistatud

DNS-samm on automaatne ja idempotentne: see loob puuduvad kirjed, uuendab muutunud IP-dega kirjeid ja jätab juba korrektse olekuga kirjed vahele. Kui Cloudflare’i tokenit pole seadistatud, jäetakse DNS vahele koos hoiatusega. Repositooriumipõhised metamärgi DNS-kirjed (automaatmarsruutide jaoks) luuakse automaatselt, kui käivitad rdc repo up.

Pilveettevalmistamine

Selle asemel et luua VM-e käsitsi, saad konfigureerida pilvepakkuja ja lasta rdc-l masinaid automaatselt ette valmistada OpenTofu abil.

Eeltingimused

Paigalda OpenTofu: opentofu.org/docs/intro/install

Veendu, et sinu SSH-konfiguratsioonis on rdc-ga registreeritud võti:

# Loeb võtmefaili ja lisab sisu /credentials/ssh alla.
rdc config ssh set --key ~/.ssh/id_ed25519

Pilvepakkuja lisamine

rdc machine provider add my-linode \
  --provider linode/linode \
  --token $LINODE_API_TOKEN \
  --region us-east \
  --type g6-standard-2

Valik	Nõutud	Kirjeldus
--provider <source>	Jah*	Tuntud pakkuja allikas (nt linode/linode, hetznercloud/hcloud)
--source <source>	Jah*	Kohandatud OpenTofu pakkuja allikas (tundmatute pakkujate jaoks)
--token <token>	Jah	Pilvepakkuja API token
--region <region>	Ei	Uute masinate vaikeregioon
--type <type>	Ei	Vaikimisi eksemplari tüüp/suurus
--image <image>	Ei	Vaikimisi operatsioonisüsteemi kujutis
--ssh-user <user>	Ei	SSH-kasutajanimi (vaikimisi: root)

* Nõutud on kas --provider või --source. Kasuta --provider tuntud pakkujate jaoks (sisseehitatud vaikeväärtused). Kasuta --source koos lisalippudega --resource, --ipv4-output, --ssh-key-attr kohandatud pakkujate jaoks.

Masina ettevalmistamine

rdc machine provision prod-2 --provider my-linode

See üks käsk:

1. Loob VM-i pilvepakkujas OpenTofu kaudu
2. Ootab SSH-ühenduvust
3. Registreerib masina sinu konfiguratsioonis
4. Paigaldab reneti ja kõik sõltuvused
5. Konfigureerib Traefiki puhverserveri ja Cloudflare’i DNS-i (tuvastab automaatselt alusdomeeni kõrvalmasinatest või kasuta --base-domain otse)

Valik	Kirjeldus
--provider <name>	Pilvepakkuja nimi (allikast add-provider)
--region <region>	Asenda pakkuja vaikeregioon
--type <type>	Asenda vaikimisi eksemplari tüüp
--image <image>	Asenda vaikimisi operatsioonisüsteemi kujutis
--base-domain <domain>	Infrastruktuuri alusdomeen. Tuvastab automaatselt kõrvalmasinatest, kui pole määratud
--no-infra	Jäta infrastruktuuri konfiguratsioon (puhverserver ja DNS) täielikult vahele
--debug	Näita üksikasjalikku ettevalmistuse väljundit

Masina ettevalmistuse tühistamine

rdc machine deprovision prod-2

Hävitab VM-i OpenTofu kaudu ja eemaldab selle sinu konfiguratsioonist. Nõuab kinnitust, välja arvatud juhul kui kasutatakse --force. Töötab ainult masinatega, mis on loodud käsuga machine provision.

Pakkujate loetlemine

rdc machine provider list

Vaikeväärtuste seadistamine

Seadista vaikeväärtused, et neid poleks vaja igal käsul täpsustada:

rdc config field set --pointer /defaults/machine --new '"server-1"'   # Vaikemasin
rdc config set team my-team                   # Vaikimisi tiim konfiguratsioonihoidla jaoks

Pärast vaikemaskina seadistamist saad käskudest -m server-1 ära jätta:

rdc repo create my-app -m my-server --size 10G

Mitu konfiguratsiooni

Halda mitut keskkonda nimega konfiguratsioonifailidega:

# Loo eraldi konfiguratsioonid
rdc config init production --ssh-key ~/.ssh/id_prod
rdc config init staging --ssh-key ~/.ssh/id_staging

# Kasuta konkreetset konfiguratsiooni
rdc repo list -m server-1 --config production
rdc repo list -m staging-1 --config staging

Kõigi konfiguratsioonide vaatamine:

rdc config list

Praeguse konfiguratsiooni üksikasjade kuvamine:

rdc config show