Töökeskkond

Tee see leht läbi üks kord, kursuse alguses. Kõik järgmised praktikumid lähtuvad sellest, et see on tehtud: masinatel on nimed ja sinu parool, vm1-s on Ansible ja Git ning vm1 SSH-võti on GitHubis.

1 · Ühendus vm1-ga

Klassiarvutis on Windows, aga töö käib mujal. Kooli Proxmoxi klastris on sulle antud kolm AlmaLinux 9 VM-i. vm1 on sinu control node: sinna paigaldad Ansible'i ja Giti ning sealt haldad kõiki kolme masinat, ka vm1 ennast. Alguses töötad ainult vm1-s (localhost), hiljem tulevad juurde vm2 ja vm3.

Juhendaja annab sulle kolm IP-d, kasutajanime ja parooli. Kirjuta need üles:

Nimi	IP	Kasutaja
vm1 (control node)
vm2
vm3

vm1 on sinu control node: sinna paigaldad Ansible'i ja Giti, sinna kloonid repo ja seal jooksevad kõik käsud. Oma arvutis on sul ainult VS Code, mis ühendub vm1-ga üle SSH.

Kas saab ka teisiti?

Kodus võid control node'ina kasutada ka WSL-i oma arvutis (VS Code + WSL). Siis on osa A localhost sinu WSL, mitte AlmaLinux, ja mõned käsud erinevad juhendist. Windows ilma WSL-ita control node'iks ei sobi: Ansible seda ei toeta. Klassis ja juhendis kasutame alati vm1-te.

Ühendu Windowsist vm1-ga:

VS Code (soovitatav)PowerShell

Paigalda laiendus Remote - SSH. Vajuta F1 → Remote-SSH: Connect to Host → <kasutaja>@<vm1-ip>. Terminal avaneb otse vm1-s (Ctrl+ö), failid näed külgpaanil.

ssh <kasutaja>@<vm1-ip>

Esimesel ühendumisel küsitakse host key kinnitust (yes) ja parooli.

Allikas: VS Code Remote-SSH

Juhendajalt saadud parool on kõigil tudengitel sama ja masinad on ühes võrgus. Seega vaheta parool ära. Masinatel pole ka veel nime (prompt näitab localhost), nii et pane neile nimi. Tee mõlemat igas masinas.

vm1 (oled juba sees):

passwd
sudo hostnamectl set-hostname vm1
exec bash

passwd küsib vana parooli, siis kaks korda uut. Liiga lihtsa parooli lükkab AlmaLinux tagasi (BAD PASSWORD). Vali vähemalt 8 märki, tähed ja numbrid segamini. Pane kõigis kolmes masinas sama uus parool. Ansible küsib sudo parooli ühe korra ja kasutab seda kõigil kolmel.

vm2 (vm1 terminalist):

ssh <kasutaja>@<vm2-ip>
passwd
sudo hostnamectl set-hostname vm2
exit

vm3: sama, vm3 nimega.

Oodatav tulemus

vm1 prompt on <kasutaja>@vm1. ssh <kasutaja>@<vm2-ip> hostname vastab vm2, vm3 samamoodi. Kõik järgmised käsud käivad vm1-s, mitte Windowsis.

2 · Tööriistad vm1-s

sudo dnf install -y git ansible-core
ansible-galaxy collection install ansible.posix:1.5.4
git --version
ansible --version
ansible-galaxy collection list ansible.posix

Oodatav tulemus

git version 2.52.0
ansible [core 2.14.18]
  config file = /etc/ansible/ansible.cfg
  ...
  python version = 3.9.25 (...) (/usr/bin/python3)
  jinja version = 3.1.2

Collection    Version
------------- -------
ansible.posix 1.5.4

ansible --version väljundist loe kaht rida:

• ansible [core 2.14.18]: Ansible'i versioon. Sellest sõltub, millised kollektsioonid sobivad.
• python version = 3.9…: Python, millega Ansible jookseb. Sihtmasinates kasutab Ansible nende enda Pythonit (AlmaLinuxis sama 3.9).

Kollektsioon peab sobima Ansible'i versiooniga. Kui ei sobi, näed iga käsu alguses hoiatust Collection ansible.posix does not support Ansible version 2.14.18. Siis paigalda sobiv versioon (ansible-galaxy collection install ansible.posix:1.5.4 --force). Millise Ansible'i versiooniga kollektsioon töötab, näed selle lehel Ansible Galaxy väljal Requires Ansible.

3 · SSH-võti

vm1-s olev võtmepaar teeb kaks asja. Sellega kloonid oma privaatse repo GitHubist. Ja sellega ühendub Ansible vm2 ja vm3 külge. Parooli pole kummalgi juhul vaja.

Loo võti. Vajuta kõigi küsimuste peale Enter:

ssh-keygen -t ed25519 -C "<eesnimi>@vm1"
cat ~/.ssh/id_ed25519.pub

Oodatav tulemus

Üks rida, mis algab ssh-ed25519 AAAA... ja lõpeb <eesnimi>@vm1. See on avalik võti, seda võib jagada. Fail ~/.ssh/id_ed25519 (ilma .pub-ita) on privaatvõti, see ei lahku kunagi vm1-st.

4 · Võti GitHubi ja repo kloonimine

Lisa avalik võti GitHubi:

1. GitHub → paremal üleval profiilipilt → Settings → SSH and GPG keys → New SSH key.
2. Title: vm1, Key type: Authentication Key, Key: kleebi cat väljundist kogu rida.
3. Add SSH key.

Kontrolli vm1-s:

ssh -T git@github.com

Oodatav tulemus

Esimesel korral kinnita yes, siis:

Hi <sinu-github-kasutaja>! You've successfully authenticated, but GitHub does not provide shell access.

Nüüd seadista Git ja klooni repo. Ava juhendaja jagatud Classroom 50 link ja nõustu ülesandega. Sulle tekib privaatne repo organisatsioonis hkhk-automation. Repo lehel vajuta Code → vahekaart SSH → kopeeri aadress (algab git@github.com:).

git config --global user.name "Eesnimi Perenimi"
git config --global user.email "sinu@email.ee"
cd ~
git clone git@github.com:hkhk-automation/<sinu-repo>.git
cd <sinu-repo>
ls

Oodatav tulemus

README.md  ULESANNE.md  logid

Iga praktikum on eraldi Classroom 50 ülesanne ja sellel on oma repo. Igal kohtumisel kloonid uue repo samamoodi. git push töötab sama võtmega, parooli ega tokenit ei küsita.

Allikas: GitHub: SSH-võti kontole

5 · Kodust ligi

Kodust pääsed oma masinatele ainult kooli VPN-iga. Kui VPN on ühendatud, töötab kõik nagu klassis: VS Code Remote-SSH <kasutaja>@<vm1-ip> ja sealt edasi.