Bitbucket

Nur Bitbucket Cloud wird unterstützt - AppArch spricht mit api.bitbucket.org. Bitbucket Data Center / Server wird nicht unterstützt.

Bitbucket akzeptiert zwei Arten von Zugängen. App-Passwörter werden nicht angeboten: Atlassian hat sie abgeschafft.

Option 1: OAuth-Client

1. Credentials → Add credential → Bitbucket → Register an application.
2. Öffnen Sie in Bitbucket Workspace settings → OAuth clients → Create OAuth client Ihres Workspaces.
3. Fügen Sie im Tab Authorization die Callback URL aus dem Assistenten exakt so ein, wie sie angezeigt wird.
4. Erteilen Sie im Tab Scopes: Account, Repositories, Pull requests, Webhooks. Der Assistent fragt zusätzlich nach Pipelines: Read and write; damit prüft und schreibt AppArch die Pipelines-Variablen des Runners.
5. Übernehmen Sie Client ID und Secret in den Assistenten und speichern Sie. Ein Workspace-Slug ist optional.
6. Schließen Sie die Autorisierung mit Connect with Bitbucket am Zugang ab.

Bitbucket-Access-Tokens aus diesem Ablauf leben etwa zwei Stunden. AppArch erneuert sie automatisch mit dem gespeicherten Refresh Token.

Option 2: Access Token

1. Credentials → Add credential → Bitbucket → Access token.
2. Erstellen Sie in Bitbucket ein Workspace- oder Repository-Access-Token mit den Berechtigungen repository und pullrequest.
3. Fügen Sie es in den Assistenten ein. Ein Workspace-Slug ist optional.

Vor dem Speichern liest AppArch aus, was das Token darf. Ein Token ohne Lesezugriff auf Repositories wird abgelehnt; eines ohne Schreibzugriff auf Pull Requests wird mit einer Nur-Lesen-Warnung angenommen (keine ArchPilot-Kommentare). Ein Access Token erneuert AppArch nie.

Was es ermöglicht

• ArchPilot kommentiert Pull Requests.
• ArchScan / ArchSecurity-Ergebnisse aus CI-Läufen erscheinen im Panel.

CI (Bitbucket Pipelines)

pipelines:
  pull-requests:
    '**':
      - step:
          image:
            name: hub.apparch.io/collectors/dotnet:latest
            username: $APPARCH_INSTALLATION_ID
            password: $APPARCH_INSTALLATION_KEY
            run-as-user: 0   # the clone belongs to root; a PR run fetches the target branch into it
          script:
            - export APPARCH_Collector__Token="$APPARCH_TOKEN"
            - export APPARCH_Collector__ApiUrl="https://api.yourdomain.com"
            - apparch "$BITBUCKET_CLONE_DIR"

Der Runner erkennt einen Pull-Request-Lauf an Bitbuckets Variable BITBUCKET_PR_ID.