Installare la CLI di CapDAG

Il comando capdag pianifica ed esegue macchine e singole cap, installa ed esegue cartucce e crea lo scheletro di nuove cartucce (vedi il riferimento della CLI di CapDAG). Questa pagina elenca tutti i modi per installarlo. Qualunque tu usi, verifica che funzioni:

capdag --version

Piattaforme

capdag è pubblicato per macOS su Apple silicon (darwin-arm64) e Linux su x86_64 (linux-x86_64). Non c’è ancora una build per i Mac Intel, per Linux su arm64 né per Windows: nessuno dei modi qui sotto lo installa lì. La pagina dei download e il manifest della release elencano sempre per che cosa è stata compilata una release.

Che cosa viene installato

capdag è un bundle: l’eseguibile capdag e, accanto, una directory bundled-cartridges/. Il bundle porta un elenco firmato delle sue cartucce, che l’eseguibile verifica con le chiavi compilate al suo interno quando le trova, quindi i due devono restare insieme. Ogni pacchetto qui sotto installa l’intero bundle e mette nel tuo PATH un collegamento a capdag: un collegamento, mai una copia, perché capdag trova bundled-cartridges/ a partire dalla posizione reale dell’eseguibile.

Homebrew (macOS su Apple silicon, Linux su x86_64)

brew install machinefabric/tap/capdag

apt (Debian, Ubuntu)

Il comando capdag è nel repository di pacchetti MachineFabric, come pacchetto per amd64. Aggiungere il repository una volta serve ogni pacchetto MachineFabric: se lo hai già aggiunto per un altro, passa all’ultima riga.

curl -fsSL https://release.machinefabric.com/packages/keys/repo-signing-prod.asc \
  | sudo gpg --dearmor -o /usr/share/keyrings/machinefabric.gpg
echo "deb [signed-by=/usr/share/keyrings/machinefabric.gpg] https://release.machinefabric.com/packages/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/machinefabric.list
sudo apt update && sudo apt install capdag

Il bundle viene installato in /opt/capdag, e /usr/bin/capdag vi rimanda.

dnf (Fedora, RHEL)

Lo stesso repository, aggiunto una volta per ogni pacchetto MachineFabric. capdag vi si trova come pacchetto per x86_64:

sudo tee /etc/yum.repos.d/machinefabric.repo >/dev/null <<'EOF'
[machinefabric]
name=MachineFabric
baseurl=https://release.machinefabric.com/packages/rpm/$basearch
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://release.machinefabric.com/packages/keys/repo-signing-prod.asc
EOF
sudo dnf install capdag

Il bundle viene installato in /opt/capdag, e /usr/bin/capdag vi rimanda.

Download diretto

Ogni release è pubblicata come un archivio per piattaforma, elencato con il suo digest SHA-256 nel manifest della release, https://release.machinefabric.com/capdag-cli/manifest. Il manifest elenca le piattaforme per cui una release è stata compilata e gli installer di ciascuna; una piattaforma che non vi compare non ha ancora una build. L’archivio di una piattaforma si trova a

https://release.machinefabric.com/capdag-cli/release/<version>/capdag-<version>-<platform>.tar.gz

con <platform> una di quelle che il manifest elenca per quella release: darwin-arm64 o linux-x86_64.

Scarica l’archivio, confrontalo con il digest del manifest, estrailo e collega capdag da una directory del tuo PATH:

version=1.617.6310       # l'ultima versione della release è nel manifest
platform=darwin-arm64
curl -fLO "https://release.machinefabric.com/capdag-cli/release/$version/capdag-$version-$platform.tar.gz"
shasum -a 256 "capdag-$version-$platform.tar.gz"     # confrontalo con lo sha256 del manifest
tar xzf "capdag-$version-$platform.tar.gz"           # estrae capdag-bundle/
sudo ln -s "$PWD/capdag-bundle/capdag" /usr/local/bin/capdag

Collegalo; non copiare l’eseguibile fuori da capdag-bundle/. Lascia la directory dov’è. Le release precedenti e gli altri installer di ciascuna sono elencati nella pagina dei download.

Aggiornare

Aggiorna con lo strumento con cui hai installato:

capdag self update sostituisce il bundle dove si trova — l’eseguibile e bundled-cartridges/ insieme — con l’ultima release, e la installa solo quando la firma del manifest della release risale alle chiavi compilate nel capdag che hai: vedi capdag self update.

Avanti

Costruisci ed esegui una cartuccia, oppure cerca un comando nel riferimento della CLI di CapDAG.