Kurulum

Tek bir satır ironflock aracını Linux veya macOS’a kurar. /usr/local/bin klasörüne yazdığı için root gerektirir. Daha sonra ironflock self-update aracı en yeni sürüme getirir, ironflock version --check ise daha yeni bir sürümün çıkıp çıkmadığını söyler.

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

Kurulum Satırı Ne Yapar

1. Sistemi (Linux veya macOS) ve makinenin mimarisini belirler: Linux’ta amd64, arm64 veya 32 bit ARM (v5 ile v7 arası), macOS’ta Apple silicon veya Intel. Apple silicon’da Rosetta 2 altında çalışan bir kabuk da Apple silicon derlemesini alır.
2. version.txt dosyasını ve bu makine için o sürümün ironflock dosyasını https://instance-registry.ironflock.com/dl/cli/ adresinden indirir.
3. İkisini de betiğin taşıdığı IronFlock sürüm anahtarına göre denetler. Linux’ta OpenPGP imzasını (.asc) sqv veya gpgv ile denetler. macOS’ta, önceden hiçbir şey kurmak gerekmesin diye aynı anahtarın düz RSA imzasını (.sig) sistemin /usr/bin/openssl aracıyla denetler.
4. İkili dosyayı /usr/local/bin/ironflock olarak, orada bulunan dosyanın yerine kurar. Yeni dosya eskisinin yanına kopyalanır ve eskisinin üzerine yeniden adlandırılır; böylece o anda çalışan bir ironflock, başlatıldığı ikili dosyayı kullanmaya devam eder. /usr/local/bin klasörü olmayan bir Mac’te betik bu klasörü oluşturur.
5. ironflock aracını bash -s -- ifadesinden sonra verilen bağımsız değişkenlerle çalıştırır. Bağımsız değişken verilmezse yalnızca kurar ve sonraki adımı belirtir.

amd64 işlemcili bir Linux makinesinde çıktı şöyle görünür:

Download base: https://instance-registry.ironflock.com/dl
Downloading ironflock 2.0.2 (linux/amd64)...
Signature verified (key F6C94D96CE315377ACA7C8EA4990543373212788).
Installed ironflock 2.0.2 as /usr/local/bin/ironflock.

Connect this machine to IronFlock with:
  sudo ironflock agent install -c /path/to/device.flock
All commands: ironflock --help
Tab completion in your shell: ironflock completion --help

Bir Mac’te belirttiği sonraki adım, bir cihaz için IronFlockOS’u bir USB belleğe veya SD karta yazan ironflock os flash komutudur. Daha önce orada bulunan bir ironflock dosyasını değiştirdiğinde Installed satırı , in place of the one that was there. ile biter.

Gereksinimler

• Root — betik /usr/local/bin klasörüne yazar. Betiği sudo bash ile çalıştırın.
• curl veya wget — indirmeler için.
• Linux’ta base64 ile sqv veya gpgv — imza denetimi için. apt, sqv ve gpgv paketlerinden birine bağımlıdır; bu yüzden her Debian ve Ubuntu sisteminde bunlardan biri bulunur. İkisi de yoksa betik durur ve apt install gpgv komutunu belirtir.
• macOS’ta hiçbir ek araç gerekmez: sistemle gelenler yeterlidir.

Betiği bir POSIX kabuğu çalıştırır: bash, sh, dash veya BusyBox ash.

Eksik veya Hatalı İmza

Eksik veya hatalı bir imza, betiği herhangi bir şey kurmadan önce durdurur; daha önce kurulmuş bir ironflock olduğu gibi kalır. Betik çıkış kodu 1 ve stderr’e yazdığı tek bir satırla sona erer, örneğin:

install.sh: https://instance-registry.ironflock.com/dl/cli/linux/amd64/2.0.2/ironflock is not signed by IronFlock: not installing it

Başarısız bir indirme de betiği aynı şekilde durdurur: hiçbir şey kurulmaz.

Tek Satırda Kurma ve Komut Çalıştırma

bash -s -- ifadesinden sonraki bağımsız değişkenler, ironflock kurulduktan sonra ona iletilir. Bu satır ironflock aracını kurar ve makineyi device.flock adlı cihaz yapılandırma dosyasının (.flock) cihazı olarak IronFlock’a bağlar:

curl -fsSL https://instance-registry.ironflock.com/dl/cli/install.sh | sudo bash -s -- agent install -c device.flock

curl ... | bash altında betiğin standart girdisi betiğin kendisidir. Bu nedenle betik, ironflock aracının terminalinizden okumasını sağlar; böylece komutun soruları yine size ulaşır ve onları her zamanki gibi yanıtlarsınız. Terminal yoksa (bir cloud-init betiği, CI) ironflock hiçbir girdi almaz: soru soran bir komut, --yes eklemediğiniz sürece çıkış kodu 4 ile sona erer. Betik, ironflock aracının çıkış koduyla sona erer. Komut, ironflock agent install bölümünde açıklanır.

Güncelleme

sudo ironflock self-update, IronFlock sürüm anahtarına göre aynı denetimlerden sonra ironflock aracını en yeni sürümle değiştirir (ironflock self-update). ironflock version --check elinizdeki sürümü ve daha yeni bir sürümün çıkıp çıkmadığını gösterir (ironflock version).

Bu sayfanın başındaki kurulum satırı da günceller: onu yeniden çalıştırın; satır /usr/local/bin/ironflock dosyasını güncel sürümle değiştirir.

Bir IronFlockOS cihazında ironflock sistemle birlikte gelir ve onu sistemle birlikte ironflock os update günceller.

Önce Kurulum Betiğini Doğrulama

install.sh dosyasının kendisini root olarak çalışmadan önce denetlemek için onu imzasıyla birlikte indirin, sürüm anahtarını içe aktarın ve imzayı gpg ile doğrulayın:

curl -fsSLO https://instance-registry.ironflock.com/dl/cli/install.sh
curl -fsSLO https://instance-registry.ironflock.com/dl/cli/install.sh.asc
curl -fsSL https://instance-registry.ironflock.com/dl/cli/ironflock-bootstrap.asc | gpg --import
gpg --verify install.sh.asc install.sh

gpg, F6C9 4D96 CE31 5377 ACA7 C8EA 4990 5433 7321 2788 parmak izine sahip anahtarla atılmış geçerli bir imza bildirmelidir. Parmak izini İmza Anahtarları sayfasındaki IronFlock Bootstrap anahtarıyla karşılaştırın. Ardından doğrulanmış betiği bağımsız değişken olmadan veya ironflock için bağımsız değişkenlerle çalıştırın:

sudo bash install.sh
sudo bash install.sh agent install -c device.flock

İndirme Tabanı

ironflock ve kurulum betiği IronFlock bulutundan, https://instance-registry.ironflock.com/dl adresinden indirir. Farklı bir indirme tabanı, örneğin ağınızdaki bir yansı (mirror), iki yoldan biriyle belirtilir. Bir IronFlock Appliance’ın cihazı için birkaç komut, Appliance’ın indirme yansısını kendiliğinden bulur:

Kurulum betiği indirme tabanının altından cli/version.txt ve cli/<system>/<arch>/<version>/ironflock dosyalarını, her birini .asc ve .sig imzasıyla birlikte okur. İndirme tabanı ne olursa olsun bunları taşıdığı sürüm anahtarına göre denetler; bu yüzden bir yansı, IronFlock’un imzalı dosyalarını değiştirmeden sunar. ironflock, IronFlockOS kataloğunu ve görüntülerini ironflockos/ altından, cihaz ajanını device-agent/ altından, cli/ altından da en yeni sürümü (version.txt, self-update ve version --check için) ve ironflock ikili dosyalarını (self-update için ve --host için diğer platformlarınkini) okur.

sudo, varsayılan olarak kabuğunuzun değişkenlerini aktarmaz. Değişkeni sudo ifadesinden sonra ayarlayın veya bayrağı verin:

# ironflock'u bir yansıdan kurun
curl -fsSL https://mirror.example.com/dl/cli/install.sh | sudo IRONFLOCK_DL_BASE=https://mirror.example.com/dl bash
 
# Bu makineyi yansıdaki ajanla bağlayın
sudo ironflock agent install -c device.flock --download-base https://mirror.example.com/dl

İki komut indirme tabanını farklı kullanır. agent update, ajanın kendi güncelleme sunucusundan, yani .flock dosyasındaki update_url adresinden güncellenmesini sağlar; indirme tabanı bunu değiştirmez. os update önce bayrağı, sonra değişkeni, sonra ajanın .flock dosyasındaki update_url adresini kullanır. --host üzerinden indirme tabanı diğer makineye de iletilir; içinde kullanıcı adı ve parola bulunan bir indirme tabanı (https://user:[email protected]/dl) hiçbir makineye ulaşılmadan çıkış kodu 2 ile sona erer.

IronFlock Appliance Cihazları

Bir IronFlock Appliance’ın verdiği .flock dosyası, ajanın güncelleme sunucusu (update_url) olarak Appliance’ın indirme yansısını belirtir; örneğin http://10.0.0.5:15002/dl ya da Appliance bir alan adıyla çalışıyorsa https://registry.<domain>/dl. Ne --download-base ne de IRONFLOCK_DL_BASE ayarlı olduğunda agent install, doctor ve os install dosyalarını bu yansıdan alır; böylece Appliance’a erişen ama ironflock.com’a erişemeyen bir makine bağlanabilir veya dönüştürülebilir. IronFlock bulutuna ait bir .flock dosyası bulutun bir ana bilgisayarını belirtir ve bulutu kullanır.

• Yansının vermedikleri, bir uyarıyla IronFlock bulutunun indirme tabanının altındaki aynı yoldan gelir: agent install için stderr’de bir Warning: satırı ve --json sonucunda warnings alanında bir girdi, os install için planda bir uyarı, doctor için download_tree denetiminin bir warning sonucu. agent install ve os install yalnızca bir dosyayı ne yansı ne de bulut verdiğinde başarısız olur; hata o zaman ikisini de belirtir.
• agent install ve os install yansıya doğrudan, buluta ise varsa proxy üzerinden erişir.
• Appliance’ın kendi CA’sından sertifikası olan bir HTTPS yansısı yalnızca makinenin sistemi o CA’ya güveniyorsa çalışır.

Bazı indirmeler yine başka yerlerden gelir:

• install.sh ve ironflock ikili dosyası ironflock.com’dan gelir. --host ile ikili dosya sizin bilgisayarınızdan makineye gider (SSH Üzerinden Uzak Makineler).
• agent install dağıtımın paketlerini ve Docker’ı kendi sunucularından alır.
• self-update ve version --check önce bayrağı, sonra değişkeni, yoksa IronFlock bulutunu okur; Appliance’ın yansısını okumaz.

Kurulumdan sonra ajan güncellemelerini Appliance’tan alır. Bkz. Uç Cihazlar.

Tab ile Tamamlama

ironflock completion, Tab tuşuna bastığınızda kabuğunuzun ironflock komut satırlarını tamamlamasını sağlayan betiği yazdırır.

ironflock completion <shell>

Kabuk bash, zsh veya fish olabilir. Linux ve macOS’ta çalışır. Root gerekmez. Hiçbir şey sormaz. Komutun kendine ait bayrağı yoktur; genel bayraklar geçerlidir.

Yazdığınız kabukta tamamlama için kabuğunuzun satırını çalıştırın. Her yeni kabukta tamamlama için satırı üçüncü sütundaki dosyaya ekleyin:

Betik şunları tamamlar:

• komutları ve bayraklarını;
• birkaç değerden birini alan bayrakların değerlerini: os images komutunun --channel, --variant ve --kernel bayrakları, os update komutunun --channel bayrağı ve os flash komutunun --installer-confirm, --installer-after ve --installer-allow-usb bayrakları;
• -c için bir .flock dosyasını;
• --hosts, --proxy-password-file, --wifi-password-file, --image-file, --output, --drive ve --disk için kabuğun dosya adlarını.

Diğer bayraklar ve diğer komutların bağımsız değişkenleri hiçbir şey tamamlamaz. Betik tamamlamak için uyan sözcükleri ironflock aracına sorar; ironflock da kendi komut listesinden yanıt verir: tamamlama hiçbir komut çalıştırmaz, hiçbir sürücüyü listelemez, hiçbir şey indirmez ve satır --host içerse bile başka hiçbir makineye ulaşmaz. --host veya --hosts ile ironflock completion, tıpkı --help gibi bu makinede yanıtlanır.

# Yazdığınız bash'te tamamlama
eval "$(ironflock completion bash)"
 
# Her yeni bash'te tamamlama
echo 'eval "$(ironflock completion bash)"' >> ~/.bashrc

$ eval "$(ironflock completion bash)"
$ ironflock os images --kernel <Tab>
rt   std

--json ile sonuç, bir JSON nesnesi içindeki betiktir:

{"shell":"bash","script":"..."}

Eksik veya bilinmeyen bir kabuk ya da birden fazla kabuk, hatalı bir komut satırıdır: çıkış kodu 2 döner ve hata, kabul edilen kabukları belirtir.

ironflock version

ironflock ikili dosyasının sürümünü ve derlendiği platformu yazdırır. --check ile indirme sunucusuna daha yeni bir sürümün çıkıp çıkmadığını da sorar.

ironflock version [flags]

Linux ve macOS’ta çalışır. Root gerekmez. Hiçbir şey sormaz. Genel bayraklar geçerlidir.

# Bu makinedeki ironflock sürümü
ironflock version
 
# Aynısı JSON olarak
ironflock version --json
 
# SSH üzerinden başka bir makinede çalışan ikili dosya: aynı sürüm, o makinenin platformu
ironflock --host pi@device-17 version
 
# Daha yeni bir sürüm çıktı mı?
ironflock version --check

ironflock 2.0.2 linux/amd64

{"version":"2.0.2","os":"linux","arch":"amd64"}

--host üzerinden platform, diğer makinenin platformudur, örneğin ironflock 2.0.2 linux/arm64: diğer makine, kendi platformu için derlenmiş aynı sürümden bir ikili dosya çalıştırır.

Bir geliştirme derlemesi kendi commit’ini belirtir: 2.0.0-23-g5b38681, 2.0.0 sürümünden 23 commit sonraki 5b38681 commit’inin derlemesidir.

Daha Yeni Bir Sürüm Çıktı mı?

--check, indirme tabanının (--download-base, yoksa IRONFLOCK_DL_BASE, yoksa IronFlock bulutu) cli/version.txt dosyasını okur ve onu, ikili dosyanın taşıdığı IronFlock sürüm anahtarıyla imzasına (.asc) göre denetler. Sunucuya agent configure komutunun ayarladığı proxy (/etc/ironflock/proxy.env) üzerinden, yoksa ortamın proxy’si üzerinden sorar. Bu dosyayı yalnızca root okuyabildiği için root olmadan ortamınkini kullanır. En yeni sürümü soran komutlar yalnızca version --check ve self-update komutlarıdır; hiçbir komut bunu kendiliğinden yapmaz.

stdout’taki ikinci bir satır ne bulduğunu ve daha yeni bir sürümü neyin kurduğunu söyler: self-update ya da IronFlockOS’ta os update.

$ ironflock version --check
ironflock 2.0.3 linux/amd64
ironflock 2.1.0 is out at https://instance-registry.ironflock.com/dl. 'sudo ironflock self-update' installs it.

version.txt bu ikili dosyanın sürümünü belirttiğinde ikinci satır This is the newest release. olur. Bu ikili dosya daha yeniyse, yani sürümden sonraki bir geliştirme derlemesiyse, satır bunu söyler. x.y.z-N-g<commit> biçimindeki bir geliştirme derlemesi x.y.z sürümünden daha yeni, bir sonraki sürümden daha eski sayılır; N = 0 ile x.y.z ile aynı yerdedir ve satır daha yeni bir sürüm çıkmadığını söyler.

--json ile nesnenin iki alanı daha olur: version.txt dosyasının belirttiği latest_version ve bunun bu ikili dosyadan daha yeni olup olmadığını belirten newer.

{"version":"2.0.3","os":"linux","arch":"amd64","latest_version":"2.1.0","newer":true}

Daha yeni bir sürüm çıkmış olsun ya da olmasın çıkış kodu 0’dır. Sunucu yanıt vermediğinde, version.txt dosyası olmadığında ya da dosya anahtarla imzalanmamışsa çıkış kodu 1’dir. --host üzerinden ilk satır, version komutunda olduğu gibi bu derlemenin ikili dosyasını belirtir ve sunucuya diğer makine sorar.

ironflock self-update

Çalışan ironflock ikili dosyasını en yeni sürümle ya da --version ile belirtilen sürümle (daha eski bir sürüm de olabilir) değiştirir. Sürüm, diskteki herhangi bir şey değişmeden önce IronFlock sürüm anahtarına göre denetlenir.

ironflock self-update [flags]

Çalıştığı sistemler: Linux ve macOS; IronFlockOS’ta çalışmaz. Root: /usr/local/bin/ironflock için gerekir (İkili Dosyayı Kim Değiştirebilir). Sorular: evet, hangi sürümün hangisinin yerini aldığını söyledikten sonra; --yes yanıtlar.

# ironflock'u en yeni sürüme güncelleyin; komut önce sorar
sudo ironflock self-update
 
# Soru sormadan güncelleyin ve sonucu JSON olarak okuyun
sudo ironflock self-update --yes --json
 
# Daha eski bir sürüme geri dönün
sudo ironflock self-update --version 2.0.3
 
# Başka bir makinede kurulu ironflock'u güncelleyin
ironflock --host pi@device-17 self-update --yes

Neyi, Neyle Değiştirir

• Dosya. Çalışan ikili dosya, tüm sembolik bağlantılar çözülerek: bir bağlantının gösterdiği dosya değiştirilir, bağlantı kalır. Komut her şeyden önce dosyayı belirtir. Bir ajan kurulumunun /opt/ironflock/device-init klasörü o kurulumun kaydını tutar, ironflock içermez; komut ona dokunmaz.
• Sürüm. --version olmadan en yenisi: indirme tabanının (--download-base, yoksa IRONFLOCK_DL_BASE, yoksa IronFlock bulutu) cli/version.txt dosyasının belirttiği sürüm; kurulum satırının okuduğu dosya da budur. Bir sürümün ikili dosyası cli/<system>/<arch>/<version>/ironflock dosyasıdır. Kanal yoktur: başka bir ağaç, örneğin bir yansı, başka bir indirme tabanıdır.
• Proxy. İndirmeler agent configure komutunun ayarladığı proxy (/etc/ironflock/proxy.env) üzerinden, yoksa ortamdaki HTTP_PROXY, HTTPS_PROXY ve NO_PROXY üzerinden gider. sudo ile ve --host üzerinden çalışan bir komutun ortamında proxy yoktur. Dosya root’a aittir; bu yüzden root olmadan yapılan bir çalıştırma ortamın proxy’sini kullanır ve bunu söyler. Komut, dosyanınkini kullandığında da bunu söyler.
• Yapılacak bir şey yok. İkili dosya zaten o sürümse ya da ondan daha yeniyse (ondan sonraki bir geliştirme derlemesi), komut bunu söyler ve soru sormadan, indirme yapmadan çıkış kodu 0 ile sona erer; sonucun outcome değeri current olur. --version olmadan asla daha eski bir sürüme dönmez.

Denetimler

İkili dosya değiştirilmeden önce:

1. version.txt, çalışan ikili dosyanın taşıdığı IronFlock sürüm anahtarıyla atılmış imzasına göre denetlenir.
2. Yeni ikili dosya, aynı anahtarla atılmış imzasına ve derleme bilgilerine göre denetlenir: ironflock programı olmalı, bu platform için ve değiştirilmemiş bir kaynak ağacından derlenmiş olmalıdır.
3. Eskisinin yanına, aynı klasöre, eskisinin modu, sahibi ve grubuyla yazılır ve bir kez çalıştırılır (version --json). İstenen sürüm olduğunu ve bu platform için olduğunu söylemesi gerekir. İmza hiçbir sürüme bağlı değildir; bu yüzden en yeni sürümün yerine sunulan daha eski, imzalı bir ikili dosya burada reddedilir.
4. Ancak bundan sonra tek adımda eskisinin üzerine yeniden adlandırılır.

sqv veya gpgv gerekmez: ironflock imzaları kendisi denetler.

Bir denetimden geçemeyen dosya asla ikili dosyanın yerini almaz ve yanındaki yeni dosya yeniden silinir. Başarısız olan, reddedilen ya da kesilen bir çalıştırma eski ikili dosyayı olduğu gibi bırakır. Dosya değiştirilirken çalışan bir ironflock komutu, başladığı dosyayla devam eder. Yazma ile yeniden adlandırma arasında ikinci bir Ctrl-C ya da bir elektrik kesintisi yeni dosyayı (ikili dosyanın yanında .ironflock.new-*) geride bırakabilir; onu elle silin.

İkili Dosyayı Kim Değiştirebilir

Komut, ikili dosyanın klasörüne yazma izni gerektirir ve yeni dosyanın sahibini ve grubunu koruyabilmesi için ikili dosyanın sahibi ve grubunun bir üyesi olarak ya da root olarak çalışmalıdır. Kurulum satırının aracı koyduğu /usr/local/bin/ironflock için bu root demektir. Aksi hâlde komut herhangi bir şey indirmeden önce çıkış kodu 3 ile sona erer, sahibi veya grubu belirtir ve sudo ile yazılacak komut satırını belirtir.

IronFlockOS ve Diğer Makineler

• IronFlockOS ironflock aracını sistemiyle birlikte getirir ve her işletim sistemi güncellemesi sistemi bütünüyle değiştirir. Orada komut hiçbir şeye bakmadan çıkış kodu 3 ile sona erer ve os update komutunu belirtir. IronFlockOS yükleyici belleğinde agent komutları gibi reddeder.
• --host üzerinden çalışan ikili dosya, çalıştırmanın komut bitince silinen kopyasıdır. Bu yüzden komut bunun yerine makinenin /usr/local/bin/ironflock dosyasını günceller. Bu dosya yoksa çıkış kodu 3 ile sona erer ve kurulum satırını belirtir. Çalışmayan ya da sürümünü söylemeyen kurulu bir ironflock da herhangi bir şey indirilmeden önce komutu çıkış kodu 3 ile sonlandırır: kurulum satırı ironflock aracını yeniden kurar.
• Birkaç makinede (birden fazla --host ya da --hosts ile), --yes verildiğinde her makine kendi /usr/local/bin/ironflock dosyasını günceller.

Sonuç

$ sudo ironflock self-update
This ironflock is 2.0.3, at /usr/local/bin/ironflock.
Download base: https://instance-registry.ironflock.com/dl (from default)
The downloads go through the proxy of the install's record (/etc/ironflock/proxy.env).
The newest release at https://instance-registry.ironflock.com/dl is ironflock 2.1.0 (its version.txt is signed by key F6C94D96CE315377ACA7C8EA4990543373212788).
ironflock 2.1.0 replaces 2.0.3 at /usr/local/bin/ironflock.
A command of ironflock that runs now goes on with 2.0.3; the next one runs 2.1.0.
? Install ironflock 2.1.0? Yes
Downloading ironflock 2.1.0 for linux/amd64 from https://instance-registry.ironflock.com/dl.
Signature verified (key F6C94D96CE315377ACA7C8EA4990543373212788): the program ironflock for linux/amd64.
The new file says it is ironflock 2.1.0 linux/amd64; it is in place.
ironflock at /usr/local/bin/ironflock is updated from 2.0.3 to 2.1.0.

İkili dosya, yanıttan sonra indirilir. Terminal olmadan ya da --json ile komut --yes gerektirir. --json ile, zaten en yeni sürüm olan bir ikili dosya için:

{"outcome":"current","path":"/usr/local/bin/ironflock","version":"2.1.0","latest_version":"2.1.0"}

Çıkış Kodları