IronFlock CLI

ironflock, bir makinedeki IronFlock yazılımı için komut satırı aracıdır. Bu araçla bir Linux makinesini IronFlock’a cihaz olarak bağlarsınız, IronFlockOS’u bir USB belleğe, SD karta veya diske yazarsınız, çalışan bir makinedeki Linux’u IronFlockOS ile değiştirirsiniz ve IronFlockOS cihazlarını güncelleyip önceki sürüme geri alır ve sıfırlarsınız; ayrıca bir IronFlock Appliance’ı kurar ve onunla ilgilenirsiniz.

ironflock, her platform için tek bir statik ikili dosyadır. Ne bir çalışma ortamına ne de başka bir pakete ihtiyaç duyar. Linux veya macOS’a tek satırla kurun:


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

Betik, /usr/local/bin/ironflock dosyasını kurmadan önce indirilen dosyayı IronFlock sürüm anahtarına göre denetler. Daha sonra sudo ironflock self-update aracı en yeni sürüme getirir. Kurulum sayfası her adımı, betiği önceden nasıl doğrulayacağınızı ve aracı nasıl güncelleyeceğinizi açıklar.

Komutlar ürüne göre gruplanır: cihaz ajanı için ironflock agent, IronFlock Appliance için ironflock appliance, IronFlockOS için ironflock os. Bir fiil her grupta aynı anlama gelir. ironflock status gibi makinenin bütünüyle ilgili komutların grubu yoktur. ironflock --help komutları listeler, ironflock <command> --help ise tek bir komutu açıklar.

Göreve Göre Komutlar

Görev	Komut	Referans
Bir Linux makinesini bir cihaz yapılandırma dosyasının (`.flock`) cihazı olarak IronFlock’a bağlama	`ironflock agent install`	Cihaz Ajanı Komutları
Kurulu ajana başka bir `.flock` dosyası veya başka proxy ayarları verme	`ironflock agent configure`	Cihaz Ajanı Komutları
Ajanın kendini kanalındaki sürüme güncellemesini sağlama	`ironflock agent update`	Cihaz Ajanı Komutları
Ajanı kaldırma ve kurulumunun değiştirdiklerini geri alma	`ironflock agent remove`	Cihaz Ajanı Komutları
Cihaz ajanını yeniden başlatma	`ironflock agent restart`	Cihaz Ajanı Komutları
Cihaz ajanını tekrar başlatılana kadar durdurma	`ironflock agent stop`	Cihaz Ajanı Komutları
Cihaz ajanını başlatma	`ironflock agent start`	Cihaz Ajanı Komutları
Cihaz ajanının günlüğünü okuma	`ironflock agent logs`	Cihaz Ajanı Komutları
Bir makinede IronFlock’tan nelerin bulunduğunu ve çalışıp çalışmadığını görme	`ironflock status`	Status ve Doctor
Bir makinenin cihaz ajanını çalıştırıp çalıştıramayacağını ve IronFlock’a erişip erişemediğini denetleme	`ironflock doctor`	Status ve Doctor
Bir sürücüye yazılabilecek IronFlockOS görüntülerini listeleme	`ironflock os images`	IronFlockOS’u Bir Sürücüye Yazma
Bir görüntünün yazılabileceği sürücüleri listeleme	`ironflock os drives`	IronFlockOS’u Bir Sürücüye Yazma
IronFlockOS’u ve bir cihazın `.flock` dosyasını bir sürücüye veya bir görüntü dosyasına yazma	`ironflock os flash`	IronFlockOS’u Bir Sürücüye Yazma
Çalışan bir makinenin Linux’unu IronFlockOS ile değiştirme	`ironflock os install`	Linux’u IronFlockOS ile Değiştirme
Bir IronFlockOS cihazını kanalındaki sürüme güncelleme	`ironflock os update`	Güncelleme, Geri Alma ve Sıfırlama
Diğer yuvadaki IronFlockOS sistemine geri dönme	`ironflock os rollback`	Güncelleme, Geri Alma ve Sıfırlama
Bir IronFlockOS cihazını yeni yazılmış bir cihazın durumuna sıfırlama	`ironflock os reset`	Güncelleme, Geri Alma ve Sıfırlama
Bu makinede bir IronFlock Appliance kurma, yapılandırma, güncelleme ve onunla ilgilenme	`ironflock appliance`	Appliance Komutları
`ironflock` sürümünü ve daha yeni bir sürümün çıkıp çıkmadığını gösterme	`ironflock version`, `ironflock version --check`	Kurulum
`ironflock` aracını en yeni sürümle değiştirme	`ironflock self-update`	Kurulum
Komut satırlarını Tab tuşuyla tamamlama	`ironflock completion`	Kurulum
Bir komutu SSH üzerinden başka bir makinede veya birçok makinede çalıştırma	`--host`, `--hosts`	SSH Üzerinden Uzak Makineler

Her komut genel bayrakları kabul eder. Bunların arasında komutun sorusunu yanıtlayan --yes ve sonucu bir programın okuyabileceği tek bir JSON nesnesi olarak yazan --json bulunur.


# ironflock'u kurun ve bu Linux makinesini device.flock dosyasının cihazı olarak bağlayın, tek satırda
curl -fsSL https://instance-registry.ironflock.com/dl/cli/install.sh | sudo bash -s -- agent install -c device.flock
 
# Bu makinenin cihaz ajanını çalıştırıp çalıştıramayacağını ve device.flock dosyasındaki ana bilgisayarlara erişip erişemediğini denetleyin
ironflock doctor -c device.flock
 
# device.flock dosyasının cihazı için IronFlockOS'u /dev/sdb sürücüsüne yazın
sudo ironflock os flash -c device.flock -d /dev/sdb
 
# Bu makinenin Linux'unu IronFlockOS ile değiştirme planını gösterin ve hiçbir şeyi değiştirmeyin
sudo ironflock os install -c device.flock --dry-run
 
# Bir cihazın durumunu dizüstü bilgisayarınızdan SSH üzerinden gösterin
ironflock --host pi@device-17 status

Sistemler

ironflock, her sürümde Linux için amd64, arm64 ve 32 bit ARM (v5 ile v7 arası), macOS için Apple silicon ve Intel üzerinde çalışacak şekilde yayımlanır.

Komutlar	Linux	macOS
`version`, `completion`	evet	evet
`self-update`	evet; bir IronFlockOS cihazında çıkış kodu 3, çünkü orada `ironflock` aracını `os update` günceller	evet
`status`, `doctor`	evet	evet; `status` sistemi ve hiçbir şeyin kurulu olmadığını gösterir
`os images`, `os drives`, `os flash`	evet	evet
`agent ...`, `os install`	evet	çıkış kodu 3
`os update`, `os rollback`, `os reset`	yalnızca bir IronFlockOS cihazında	çıkış kodu 3

Bir sistemde çalışmayan bir komut o sistemde de bulunur: hiçbir şeye bakmadan çıkış kodu 3 ile sona erer. agent komutları, systemd kullanan Debian veya Ubuntu tabanlı bir Linux gerektirir. os install, 64 bit UEFI firmware (amd64 veya arm64) üzerinde systemd kullanan bir Linux gerektirir. appliance komutları Appliance Komutları sayfasında açıklanır.

Bir IronFlockOS cihazında cihaz ajanı, görüntüyle birlikte sistemin parçası olarak gelir. Bu nedenle agent install ve agent remove orada çıkış kodu 3 ile çalışmayı reddeder; agent configure -c ise cihaza başka bir .flock dosyası verir.

--host ile completion dışındaki her komut SSH üzerinden başka bir Linux makinesinde çalışır. Bir Mac’ten agent komutlarını, os install komutunu ve bir IronFlockOS cihazının komutlarını bu şekilde çalıştırırsınız.

0.15.0’dan sonraki IronFlockOS sürümleri ironflock aracını cihazda /usr/bin/ironflock olarak taşır. IronFlockOS 0.15.0 ve öncesi taşımaz: cihazın komutlarını başka bir bilgisayardan --host ile, cihazın SSH kullanıcısı olarak çalıştırın (SSH Erişimi):


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

Not: Komutun mesajları ve JSON alanları, IronFlock Studio’nun ve bu belgelerin proje dediği şey için swarm, proje sahibi için de “swarm owner” der. Örneğin ironflock status --json çıktısındaki agent.swarm alanı, cihazın projesini belirtir.

Bu Bölümde

Kurulum: kurulum satırı, betiği doğrulama, indirme tabanı ve bir Appliance’ın yansısı, Tab ile tamamlama, ironflock version ve ironflock self-update.
Bayraklar, Çıktı ve Çıkış Kodları: her komut için geçerli olan genel bayraklar, stdout ve JSON, sorular, root, gizli bilgiler ve çıkış kodları.
SSH Üzerinden Uzak Makineler: tek bir makine için --host, birçok makine için --hosts ve --parallel.
Cihaz Ajanı Komutları: cihaz ajanını kurma, yapılandırma, güncelleme, kaldırma, yeniden başlatma, durdurma ve başlatma ile günlüğünü okuma.
Status ve Doctor: bir makinede IronFlock’tan nelerin çalıştığı ve makinenin cihaz ajanını çalıştırıp çalıştıramayacağı.
IronFlockOS’u Bir Sürücüye Yazma: görüntüleri ve sürücüleri listeleme ve IronFlockOS’u bir cihazın .flock dosyasıyla birlikte yazma.
Linux’u IronFlockOS ile Değiştirme: çalışan bir Linux makinesini bir IronFlockOS cihazına dönüştürme.
Güncelleme, Geri Alma ve Sıfırlama: bir IronFlockOS cihazını güncel tutma, bir önceki sürüme dönme veya cihazı sıfırlama.
Appliance Komutları: bir makinede IronFlock Appliance kurma, yapılandırma, güncelleme ve onunla ilgilenme.