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:

| Variabel | Beskrivelse | Standard | | ---------------------- | ----------------------------------------------- | ----------------- | | ARCHGATE_VERSION | Installer en bestemt versjon (f.eks. v0.11.2) | Siste versjon | | ARCHGATE_INSTALL_DIR | Egendefinert installasjonsmappe | ~/.archgate/bin |

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

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:

| Plattform | Arkitektur | Artefakt | | --------- | ---------- | ----------------------- | | macOS | arm64 | archgate-darwin-arm64 | | Linux | x86_64 | archgate-linux-x64 | | Windows | x86_64 | archgate-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 styring. Se guiden Hurtigstart for en gjennomgang.