Gå til innholdet

Installasjon

Den raskeste måten å installere Archgate på. Ingen Node.js eller pakkebehandler nødvendig:

Terminal window
# macOS / Linux
curl -fsSL https://cli.archgate.dev/install-unix | sh
# Windows (PowerShell)
irm https://cli.archgate.dev/install-windows | iex
# Windows (Git Bash / MSYS2)
curl -fsSL https://cli.archgate.dev/install-unix | sh

Dette laster ned en forhåndskompilert binærfil for din plattform og installerer den til ~/.archgate/bin/. Installatøren oppdager shell-profilene dine og tilbyr å legge mappen til PATH.

På Windows oppdager PowerShell-installatøren også Git Bash shell-profiler (.bashrc, .bash_profile, .profile) og tilbyr å konfigurere PATH der også.

Du kan tilpasse installasjonen med miljøvariabler:

VariabelBeskrivelseStandard
ARCHGATE_VERSIONInstaller en bestemt versjon (f.eks. v0.11.2)Siste versjon
ARCHGATE_INSTALL_DIREgendefinert installasjonsmappe~/.archgate/bin

Du kan også laste ned binærfiler direkte fra GitHub Releases.

På Windows kan du installere Archgate med Windows Package Manager:

Terminal window
winget install Archgate.Archgate

Dette installerer en liten, portabel wrapper og legger archgate i PATH. Ved første kjøring lastes plattformbinærfilen ned, sjekksummen verifiseres, og filen mellomlagres i ~/.archgate/bin/ — samme cache som alle andre installasjonsmetoder bruker, så du laster ikke ned noe på nytt når du bytter mellom dem.

Oppgrader med winget upgrade Archgate.Archgate.

Installer Archgate globalt med din foretrukne Node.js-pakkebehandler:

Terminal window
# npm
npm install -g archgate
# Bun
bun install -g archgate
# Yarn
yarn global add archgate
# pnpm
pnpm add -g archgate

Dette installerer en lettvekts-wrapper som delegerer til en plattformspesifikk binærfil. CLI-en er en frittstående binærfil kompilert med Bun — Node.js trengs bare for npm/yarn/pnpm-wrapperen.

Du kan også legge til Archgate som en utviklingsavhengighet i prosjektet ditt og kjøre den gjennom pakkebehandlerens script runner. Dette er nyttig for å låse en bestemt versjon per prosjekt eller kjøre sjekker i CI uten global installasjon.

Terminal window
# npm
npm install -D archgate
# Bun
bun add -d archgate
# Yarn
yarn add -D archgate
# pnpm
pnpm add -D archgate

Deretter kjører du Archgate via pakkebehandleren din:

Terminal window
# npm / Yarn / pnpm
npx archgate check
# Bun
bun run archgate check

Eller legg til et script i package.json:

{ "scripts": { "check:adrs": "archgate check" } }
Terminal window
# Works with any package manager
npm run check:adrs
bun run check:adrs
yarn check:adrs
pnpm check:adrs

Archgate leverer forhåndskompilerte binærfiler for følgende plattformer:

PlattformArkitekturArtefakt
macOSarm64archgate-darwin-arm64
Linuxx86_64archgate-linux-x64
Windowsx86_64archgate-win32-x64

Riktig binærfil lastes ned automatisk fra GitHub Releases ved første kjøring og hurtiglagres i ~/.archgate/bin/.

Terminal window
archgate --version

Du bør se den installerte versjonen skrevet ut til stdout.

Hvis du bruker proto (moonrepos verktøykjedebehandler), kan du installere Archgate direkte som en proto-plugin — ingen Node.js eller npm nødvendig.

Legg til pluginen i .prototools:

[plugins.tools]
archgate = "github://archgate/proto-plugin"

Deretter installerer og bruker du den som et hvilket som helst annet proto-verktøy:

Terminal window
proto install archgate
archgate check

Proto administrerer binærfilen for deg, inkludert versjonslåsing og automatisk installasjon. For å låse en bestemt versjon, legg den til i roten av .prototools:

archgate = "0.15.0"
[plugins.tools]
archgate = "github://archgate/proto-plugin"

Du kan også liste tilgjengelige versjoner og administrere installasjoner med proto-kommandoer:

Terminal window
proto list-remote archgate # liste tilgjengelige versjoner
proto install archgate 0.15.0 # installere en bestemt versjon
proto pin archgate 0.15.0 # låse versjon i .prototools

Etter installasjonen, kjør archgate init i prosjektet ditt for å sette opp linting og guardrails. Se guiden Hurtigstart for en gjennomgang.