Schnellstart

Erkennen Sie Ihre erste Verletzung in 10 Minuten. Kein DevOps-Team erforderlich.

1. Git verbinden

Legen Sie in Ihrem Workspace unter Credentials → Add credential einen Git-Zugang für GitHub, GitLab (gitlab.com oder selbstverwaltet), Bitbucket Cloud oder Azure DevOps an. Siehe Einen Git-Anbieter verbinden.

2. Ein Projekt registrieren

Wählen Sie ein Repository mit der verbundenen Anmeldeinformation aus und erstellen Sie Ihr Projekt. AppArch generiert ein projektspezifisches Runner-Token.

3. Regeln definieren

Beginnen Sie mit einer vorgefertigten Vorlage (Clean, Hexagonal, Layered) oder schreiben Sie Ihre eigene arch.yaml-Datei:

version: 2
style: hexagonal
layers:
  - { name: presentation, paths: ["src/ui/**"] }
  - { name: domain,       paths: ["src/domain/**"] }
  - { name: infrastructure, paths: ["src/infra/**"] }
rules:
  - { id: RULE-014, forbid: "presentation → infrastructure" }
  - { id: RULE-002, forbid: "domain → *", except: ["std"] }

4. In Ihre CI-Pipeline einbinden

Fügen Sie den Runner zu Ihrer CI-Pipeline hinzu (Beispiel für GitLab CI):

# Image pulls are authorized with your INSTALLATION credential, not the project token
# (Settings → CI/CD → Variables):
#   DOCKER_AUTH_CONFIG = {"auths":{"hub.apparch.io":{"auth":"base64(<installation-id>:<installation-key>)"}}}
archpilot:
  image: hub.apparch.io/collectors/dotnet:latest
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
  variables:
    APPARCH_Collector__Token: "$APPARCH_TOKEN"
    APPARCH_Collector__ApiUrl: "https://api.yourdomain.com"
  script:
    # Optional flags: --modules archpilot,archscan (pin what runs)
    #                 --fail-on critical (fail this step when findings at/above the level exist)
    - apparch "$CI_PROJECT_DIR"

Beim nächsten Mal, wenn ein PR/MR geöffnet wird, hinterlässt AppArch zeilenweise Kommentare. Weitere Einzelheiten finden Sie im Abschnitt Integrationen.