IronFlock CLI

ironflock to narzędzie wiersza poleceń do obsługi oprogramowania IronFlock na maszynie. Za jego pomocą podłączasz maszynę z Linuksem do IronFlock jako urządzenie, zapisujesz IronFlockOS na pendrivie USB, karcie SD lub dysku, zastępujesz Linuksa działającej maszyny systemem IronFlockOS, na urządzeniach z IronFlockOS instalujesz aktualizacje, wycofujesz je i przeprowadzasz reset, a także instalujesz IronFlock Appliance i dbasz o niego.

ironflock to jeden statyczny plik binarny dla każdej platformy. Nie potrzebuje środowiska uruchomieniowego ani żadnego innego pakietu. W systemie Linux lub macOS instalujesz go jednym poleceniem:

curl -fsSL https://instance-registry.ironflock.com/dl/cli/install.sh | sudo bash

Skrypt sprawdza pobrany plik kluczem wydań IronFlock, zanim zainstaluje /usr/local/bin/ironflock. Później sudo ironflock self-update aktualizuje go do najnowszego wydania. Strona Instalacja objaśnia każdy krok, wcześniejszą weryfikację skryptu i aktualizację.

Polecenia są pogrupowane według produktu: ironflock agent dla agenta urządzenia, ironflock appliance dla IronFlock Appliance, ironflock os dla IronFlockOS. Czasownik znaczy to samo w każdej grupie. Polecenia dotyczące całej maszyny, takie jak ironflock status, nie należą do żadnej grupy. ironflock --help wyświetla listę poleceń, a ironflock <command> --help opisuje jedno z nich.

Polecenia według zadań

Każde polecenie przyjmuje flagi globalne. Należą do nich --yes, która odpowiada na pytanie polecenia, oraz --json, która zapisuje wynik jako jeden obiekt JSON do odczytu przez program.

# Zainstaluj ironflock i podłącz tę maszynę z Linuksem jako urządzenie z device.flock, jednym poleceniem
curl -fsSL https://instance-registry.ironflock.com/dl/cli/install.sh | sudo bash -s -- agent install -c device.flock
 
# Sprawdź, czy ta maszyna może uruchomić agenta urządzenia i połączyć się z hostami z device.flock
ironflock doctor -c device.flock
 
# Zapisz IronFlockOS dla urządzenia z device.flock na nośniku /dev/sdb
sudo ironflock os flash -c device.flock -d /dev/sdb
 
# Pokaż plan zastąpienia Linuksa tej maszyny systemem IronFlockOS, niczego nie zmieniając
sudo ironflock os install -c device.flock --dry-run
 
# Pokaż stan urządzenia ze swojego laptopa, przez SSH
ironflock --host pi@device-17 status

Systemy

Wydanie publikuje ironflock dla Linuksa na amd64, arm64 i 32-bitowym ARM (v5 do v7) oraz dla macOS na Apple silicon i Intel.

Polecenie, które nie działa w danym systemie, mimo to w nim istnieje: kończy się kodem wyjścia 3, zanim cokolwiek sprawdzi. Polecenia agent wymagają Linuksa opartego na Debianie lub Ubuntu z systemd. os install wymaga Linuksa z systemd na 64-bitowym firmware UEFI (amd64 lub arm64). Polecenia appliance opisuje strona Polecenia Appliance.

Na urządzeniu z IronFlockOS obraz dostarcza agenta urządzenia razem z systemem. Dlatego agent install i agent remove odmawiają tam działania z kodem wyjścia 3, a agent configure -c przekazuje urządzeniu inny plik .flock.

Z --host każde polecenie poza completion działa na innej maszynie z Linuksem przez SSH. Z Maca uruchamiasz w ten sposób polecenia agent, os install i polecenia urządzenia z IronFlockOS.

Wydania IronFlockOS nowsze niż 0.15.0 mają ironflock na urządzeniu, jako /usr/bin/ironflock. IronFlockOS 0.15.0 i starsze go nie mają: polecenia urządzenia uruchamiaj z innego komputera z --host, jako użytkownik SSH urządzenia (Dostęp SSH):

ironflock --host operator@kitchen-pc os update --reboot --yes

Uwaga: Komunikaty i pola JSON polecenia mówią swarm na to, co IronFlock Studio i ta dokumentacja nazywają projektem, oraz „swarm owner” na właściciela projektu. Na przykład pole agent.swarm w wyniku ironflock status --json podaje projekt urządzenia.

W tej sekcji

• Instalacja: polecenie instalacyjne, weryfikacja skryptu, bazowy adres pobierania i kopia lustrzana Appliance, uzupełnianie klawiszem Tab, ironflock version i ironflock self-update.
• Flagi, wyjście i kody wyjścia: flagi globalne, stdout i JSON, pytania, root, sekrety i kody wyjścia, czyli zasady obowiązujące każde polecenie.
• Zdalne maszyny przez SSH: --host dla jednej maszyny, --hosts i --parallel dla wielu.
• Polecenia agenta urządzenia: instalacja, konfiguracja, aktualizacja, usunięcie, restart, zatrzymanie i uruchomienie agenta urządzenia oraz odczyt jego logu.
• Status i Doctor: co z IronFlock działa na maszynie i czy maszyna może uruchomić agenta urządzenia.
• Zapis IronFlockOS na nośniku: lista obrazów i nośników oraz zapis IronFlockOS z plikiem .flock urządzenia.
• Zastąpienie Linuksa systemem IronFlockOS: zamiana działającej maszyny z Linuksem w urządzenie z IronFlockOS.
• Aktualizacja, wycofanie i reset: utrzymywanie urządzenia z IronFlockOS w aktualnym stanie, powrót do poprzedniego wydania lub reset.
• Polecenia Appliance: instalacja, konfiguracja, aktualizacja i obsługa IronFlock Appliance na maszynie.