Zusammenfassung

Veröffentlicht am 07. März 2027

• Unterstützung für Push-Ereignisse eingestellt - Wir haben die Unterstützung für Push-Ereignisse eingestellt. Wenn Sie die Verarbeitung von Push-Ereignissen aktiviert hatten, hat Acrolinx einen Kommentar zu jedem Commit gepostet. Ab dieser Version 4.2.7 ist es nicht mehr erforderlich, „push“ in der Konfigurationsoption :allowed-event-types anzugeben. Die Integration verarbeitet nur noch Pull-Request-Ereignisse.

• Anzeige des Analyse-Dashboards direkt aus den Prüfungsergebnissen - Wir verwenden keinen veralteten Endpunkt mehr, um das Inhaltsanalyse-Dashboard abzurufen. Die Integration ruft die Daten jetzt direkt aus den Prüfungsergebnissen ab.

• Abhängigkeits-Updates - Wir haben notwendige Abhängigkeits-Updates in diese Version aufgenommen.

• Behebung von Sicherheitsschwachstellen - Wir haben einige Sicherheitsschwachstellen behoben.

Zusammenfassung

Veröffentlicht am 11. November 2024

Diese Service-Version enthält Abhängigkeits-Updates und die Behebung von Schwachstellen.

Zusammenfassung

Veröffentlicht am 29. August 2024

Diese Service-Version ermöglicht Ihnen den Zugriff auf Beispiel-JSON-Konfigurationsdateien über die Kommandozeilenoptionen --sample-json-config und --sample-files. Wir haben auch einige Abhängigkeiten aktualisiert, Sicherheitsschwachstellen behoben und die Protokollmeldungen verbessert.

Weitere Informationen zur Konfiguration der Git-Hosting-Integration mithilfe von JSON-Konfigurationsdateien finden Sie unter Formatmigration für Konfigurationsdateien und Repository-Registrierung.

Zusammenfassung

Veröffentlicht am 22. April 2024

In dieser Version haben wir die Konfigurationsoption :file-size-limit für Pull-Requests verfügbar gemacht. Wir haben auch einige routinemäßige Wartungsarbeiten und Sicherheitskorrekturen durchgeführt.

Erfahren Sie mehr über die Verwendung von :file-size-limit in Konfigurationen erklärt.

Zusammenfassung

Veröffentlicht am 3. November 2023

Diese Service-Version behebt einen Fehler, der die Statusinformationen von Pull-Requests beeinträchtigte. Wenn eine nicht unterstützte Pull-Request-Aktivität auftrat, änderte sich der Status des Pull-Requests in „erfolgreich“.

Die derzeit von uns unterstützten GitHub-Pull-Request-Aktivitäten sind:

• opened

• reopened

• synchronize

Wir haben auch weitere Informationen zu den Protokolleinträgen hinzugefügt, um eine bessere Überwachung zu ermöglichen.

Zusammenfassung

Veröffentlicht am 6. Juli 2023

Diese Service-Version behebt einen Fehler, der auftrat, wenn die erste Datei in einem Pull-Request nicht erfolgreich geprüft wurde. In diesem Fall konnten Sie den Link zum Inhaltsanalyse-Dashboard in Ihren Ergebnissen nicht sehen. Wir haben auch einige Sicherheitsupdates vorgenommen.

Zusammenfassung

Veröffentlicht am 12. Juni 2023

Verbesserungen und Korrekturen an Protokolleinträgen, um die Überwachung des privaten Beta-Feature-Flags innerhalb der Acrolinx für GitHub-Integration zu erleichtern.

Zusammenfassung

Veröffentlicht am 15. Mai 2023

In dieser Version haben wir ein Feature-Flag hinzugefügt, das die Stapelzuordnung von Styleguides für Markdown-Dateien ermöglicht, die mit Metadaten versehen wurden. Wie üblich haben wir auch Sicherheitslücken behoben.

Plattformunterstützung

Diese Version erfordert:

• Acrolinx-Plattform Version 2022.02 oder höher (nur Private Cloud)

Verbesserungen

• Feature-Flag für Ziel-Stapelzuordnung - Wir haben ein privates Beta-Feature-Flag hinzugefügt, das die Ziel-Stapelzuordnung für Markdown-Dateien über benutzerdefinierte Dokumentenfelder ermöglicht. Erfahren Sie mehr darüber, wie es funktioniert.

Version 4.1.3

Veröffentlicht am 28. April 2023

Diese Version behebt einen Fehler bei der parallelen Verarbeitung, der dazu führen konnte, dass sowohl die Baseline- als auch die Webhook-Worker die Verarbeitung einstellten.

Version 4.1.2

Veröffentlicht am 20. März 2023

Diese kleine Service-Version behebt einen Fehler, der dazu führte, dass die Baseline in eine Endlosschleife geriet.

Version 4.1.1

Veröffentlicht am 6. März 2023

Kleine Version für Wartung und Code-Refactoring.

Version 4.1.0

Veröffentlicht am 16. Februar 2023

Dies ist eine wichtige Version mit zwei neuen Funktionen, die Fehler bei Prüfungen und bei der Konfiguration von Dateien reduzieren. Wir haben auch unsere Bibliotheken aktualisiert, um einige hohe CVEs zu beheben.

Plattformunterstützung

Diese Version erfordert Folgendes:

• Acrolinx-Plattform Version 2021.12 oder höher (nur Private Cloud)

Verbesserungen

Wiederholungsmechanismus für alle HTTP-Aufrufe an Acrolinx, GitHub und Azure DevOps Git

Diese Version erweitert die Implementierung von Wiederholungsmechanismen konsistent für alle HTTP-Aufrufe. Bisher war dies nur für jene Aufrufe implementiert, die nach Ihren Beobachtungen häufig fehlschlagen.

Der Mechanismus wird bei allen Aufrufen der Acrolinx-API und der jeweiligen APIs der von uns unterstützten Git-Hosting-Anbieter, nämlich GitHub und Azure DevOps Git, verwendet. Der Mechanismus führt Wiederholungsversuche durch, wenn HTTP-Antworten mit Statuscodes empfangen werden, die auf eine vorübergehende Nichtverfügbarkeit der Server hinweisen, und erhöht so die Wahrscheinlichkeit erfolgreicher Antworten. Dies führt zu einer geringeren Auswirkung der Nichtverfügbarkeit der Server und einer erhöhten Zuverlässigkeit der Kommunikation zwischen der Integration und den oben genannten Plattformen.

EDN- zu JSON-Formatmigration für Konfigurationsdateien und Repository-Registrierung

Die Acrolinx für Git-Hosting-Integration kann nun ihre Konfiguration und die Remote-Repository-Registrierung aus JSON-Dateien lesen. Alle drei Arten von Konfigurationsdateien: die benutzerspezifische lokale Konfigurationsdatei, die globale Konfigurationsdatei und die Konfigurationsdatei auf Repository-Ebene sowie die Repository-Registrierung können sowohl in EDN als auch in JSON angegeben werden, wobei JSON das Format ist, das Vorrang hat.

Wie die Remote-Konfigurationsdateien und die Repository-Registrierung gelesen werden

Wenn die Integration eine JSON-Datei erkennt, liest sie die Remote-Konfiguration aus dieser Datei und ignoriert die EDN-Konfigurationsdatei. Die Remote-EDN-Konfiguration wird nur dann gelesen, wenn keine JSON-Datei im Repository vorhanden ist.

Die oben genannten Leseregeln und die Formatpriorität gelten auch für die Repository-Registrierungsdatei. Wir haben Unterstützung für das Lesen und Schreiben des Repo-Status aus und in die JSON-Repository-Registrierungsdatei bereitgestellt.

Unterstützung für JSON-Kommentare

Das JSON-Format unterstützt keine Kommentare, wir haben jedoch Unterstützung für Kommentare als Objekte und Schlüssel-Wert-Paare bereitgestellt, bei denen der Name des Kommentarobjekts oder der Schlüsselname mit zwei Schrägstrichen (//) beginnt.

Zum Beispiel:

{   "//comment001": "Ein Kommentar",
        ":foo0": [{"//comment0001": "Ein Kommentar in einem Array"},
                "foo"],
        ":foo1": {
                "//comment001": "Noch ein Kommentar",
                ":foo2": "foo2"
        }
}

Wenn die Dateien gelesen werden, werden die Kommentare ignoriert. Für die zukünftige Kompatibilität empfehlen wir, dass die Kommentarschlüssel eindeutig sind.

Namenskonvention für die Konfigurationsoptionen

Beachten Sie, dass sich die Namenskonvention für die Konfigurationsoptionen nicht geändert hat. Wenn Sie also die Konfigurationsoptionen in Ihren JSON-Dateien angeben, stellen Sie sicher, dass sie mit einem Doppelpunkt (:) beginnen.

Namenskonvention für die Konfigurationsdateien

Sie müssen sicherstellen, dass die benutzerspezifische lokale Konfigurationsdatei mit der Erweiterung .json endet. Die Dateinamen lauten wie folgt:

• Globaler Konfigurationsdateiname: global-config.json

• Konfigurationsdateiname auf Repository-Ebene: acrolinx-config.json

• Repository-Registrierungsdateiname: repositories.json.

Fehlerbehebungen

Die folgenden Sicherheitsschwachstellen wurden behoben

Abhängigkeit (Version)	CVSS-Bewertung	CVE	Gefunden in
org.eclipse.jetty/jetty-client ( 9.4.44.v20210927)	NIEDRIG HOCH	CVE-2022-2047 CVE-2022-2048	o.github.atomisthq/jibbit > com.cognitect.aws/api > com.cognitect/http-client
com.github.jnr:jnr-posix (3.0.53)	HOCH	CVE-2014-4043	com.unbounce:clojure-dogstatsd-client@0.7.0 > com.datadoghq:java-dogstatsd-client@2.11.0 > com.github.jnr:jnr-unixsocket@0.27 > com.github.jnr:jnr-posix@3.0.53

Zusammenfassung

Veröffentlicht am 28. Dezember 2022

Dies ist eine riesige Version voller neuer Funktionen und Fehlerbehebungen. Oh, und Sie haben vielleicht den neuen Namen bemerkt! Lesen Sie weiter, um all die aufregenden Dinge zu sehen, die wir in dieser Version hinzugefügt haben.

Plattformunterstützung

Diese Version erfordert Folgendes:

• Acrolinx-Plattform Version 2021.12 oder höher (nur Private Cloud)

Eingestellte Unterstützung

Wir haben die Unterstützung für Folgendes eingestellt:

• GitHub 2.0.x, 3.1.1, 3.2.0, 3.3.0, 3.4.0 und 3.5.0.

Verbesserungen

Neuer Name, gleiche Funktionalität

Die Integrationen für GitHub und Azure DevOps Git haben jetzt eine gemeinsame Quellcodebasis. Sie werden nun als zwei verschiedene Git-Dienstanbieter unter einer Integration verfügbar sein, der neu veröffentlichten Git-Hosting-4.0-Integration. Bei der Installation der Integration können Sie konfigurieren, welche Integration Sie installieren möchten.

Aktualisierte Konfigurationsoption

Die Konfigurationsoption :secret heißt jetzt :gh-secret. Bitte ändern Sie Ihre Hauptkonfigurationsdatei entsprechend.

Vollständige Unterstützung für die meisten Konfigurationsoptionen (Azure DevOps Git)

Die meisten Konfigurationsoptionen werden jetzt für die Verarbeitung von Pull-Requests in Azure DevOps Git unterstützt. Weitere Details finden Sie am Ende der Versionshinweise.

Verringerte Verzögerung der Ereigniswarteschlange von 10 Sekunden auf 0,1 Sekunden

Aufgrund erheblicher Verbesserungen des GitHub-Cloud-Systems (des Git-Dienstes selbst) konnten wir die Verzögerung der Ereigniswarteschlange drastisch von 10 auf 0,1 Sekunden reduzieren! In der Praxis bedeutet dies, dass die Kommentare und der Status jetzt bis zu 10 Sekunden schneller an den Git-Hosting-Dienst (GitHub oder Azure DevOps) gesendet werden.

ACROLINX_LOGGING_TARGET-Option entfernt

Die Umgebungsvariable ACROLINX_LOGGING_TARGET, die zur Umleitung der Protokollausgabe an die Standardausgabe verwendet wurde, wurde aufgrund einer Änderung in der Logback-Bibliothek entfernt.

Wir empfehlen den folgenden Ansatz:

Innerhalb der JAR-Datei kann die Datei logback-stdout.xml verwendet werden, um die Protokollausgabe umzuleiten. Sie befindet sich im Klassenpfad und kann wie folgt verwendet werden:

java -Dlogback.configurationFile=logback-stdout.xml -jar JARFILE ...

Dadurch wird die Protokollausgabe an die Standardausgabe umgeleitet.

Benutzeroberfläche wurde entfernt

Die Benutzeroberfläche der Git-Hosting-Integration wurde entfernt. Der Hauptgrund dafür ist, dass alle über die frühere Benutzeroberfläche bereitgestellten Informationen jetzt über Befehlszeilenoptionen und das Protokollsystem verfügbar sind. Das bedeutet, dass wir mehr Zeit für neue Funktionen aufwenden können, anstatt eine alte, ungenutzte zu pflegen!

Fehlerbehebungen

Sensible Header wurden möglicherweise in den Protokollen ausgegeben

Mit Azure DevOps 1.1 wurde die vom Azure DevOps-System zurückgegebene persistente Sitzungs-ID in einigen Protokolleinträgen ausgegeben. Dies wurde auf der Ebene des Ausnahmesystems behoben (HTTP-Header werden in diesen Ausnahmefällen nicht mehr in der Protokollausgabe ausgegeben).

Acrolinx ignorierte Dateien, wenn die Konfigurationsoption :allowed-filename-matches eine Zeichenfolge war

Ein Fehler wurde für die Konfigurationsoption :allowed-filename-matches behoben. Bisher prüfte die Integration keine Dateien, wenn der Wert dieser Konfigurationsoption eine Zeichenfolge (kein Vektor von Zeichenfolgen) war. Die Konfigurationsoption funktioniert jetzt wie vorgesehen.

Wichtige Informationen

Aktuelle Unterschiede zwischen der Unterstützung von GitHub und Azure DevOps:

• Der Azure DevOps Git-Modus unterstützt nur die Verarbeitung von Pull-Request-Ereignissen.

• Die Konfigurationsoption :ignored-senders kann je nach Unterschieden in den APIs dieser Dienste unterschiedliche Bedeutungen haben:

  • GitHub: Benutzername

  • Azure DevOps: E-Mail-Adresse

• Die Konfigurationsoption :use-skip-label bezieht sich auf das Pull-Request-Label in GitHub und auf das Pull-Request-Tag in Azure DevOps (unterschiedliche Terminologie zwischen den Git-Dienstanbietern).

• Die Konfigurationsoption :allow-merges-from-default wird in Azure DevOps Git noch nicht unterstützt.

Zusammenfassung

Veröffentlicht am 19. Oktober 2022

In dieser Version haben wir die Art und Weise verbessert, wie Acrolinx Ihre Dateien prüft. Wir haben uns auch um einige Schwachstellen in Drittanbieter-Bibliotheken gekümmert. Wir empfehlen Ihnen daher, auf diese Version von Acrolinx für Git Hosting zu aktualisieren.

Plattformunterstützung

Acrolinx für Git Hosting Version 3.6.0 erfordert Folgendes:

• Acrolinx-Plattform Version 2021.03 oder höher.

Verbesserungen

Verbesserte Verarbeitung von Pull-Request-Ereignissen

In der Vergangenheit konnten Sie Pull-Requests parallel an die Acrolinx-Plattform senden, sie wurden jedoch sequenziell verarbeitet. Dies bedeutete, dass die durchschnittliche Anzahl der Dateien in jedem Pull-Request die Verarbeitungszeit beeinflusste. Das haben wir verbessert!

Acrolinx verarbeitet eingehende Pull-Requests jetzt so schnell wie möglich und parallel. Mit dieser Verbesserung kann Acrolinx alle aktiven Sprachserver voll auslasten. Acrolinx sendet so viele Dateien wie möglich an die Acrolinx-Plattform, aber nicht mehr, als Sie für :acrolinx-parallel-workers konfigurieren. Lesen Sie mehr darüber in Konfigurationen.

Senden der JAR-Protokollausgabe an stdout

Sie können die JAR-Protokollausgabe jetzt an die Standardausgabe senden. Setzen Sie dazu die Umgebungsvariable ACROLINX_LOGGING_TARGET auf den Wert stdout. Erfahren Sie mehr in unserem Artikel Protokollierung und Überwachung.

Aktualisierte Drittanbieter-Bibliotheken

Wir haben einige Schwachstellen in den von uns verwendeten Drittanbieter-Bibliotheken gefunden. Deshalb haben wir die Bibliothek auf eine Version aktualisiert, in der die Schwachstellen nicht mehr vorhanden sind. Zeit, Ihren Teil zu tun – aktualisieren Sie Ihre Acrolinx-Integration!

Weitere Details finden Sie in der National Vulnerability Database.