incubator kie optaplanner

Ein schneller, benutzerfreundlicher Open-Source-KI-Einschränkungslöser für Softwareentwickler

Suchen Sie nach Schnellstarts?

Die Schnellstartanleitungen von OptaPlanner befinden sich im Repository optaplanner-quickstarts.

Schneller Entwicklungsstart

So erstellen und führen Sie es aus dem Quellcode aus:

 $ mvn Clean Install -Dquickly
$ cd optaplanner-beispiele
$ mvn exec:java

Um mit IntelliJ IDEA, Eclipse oder VSCode zu entwickeln, öffnen Sie die Root pom.xml als neues Projekt und konfigurieren Sie eine Run/Debug-Konfiguration wie folgt:

• Typ: Anwendung

• Hauptklasse: org.optaplanner.examples.app.OptaPlannerExamplesApp

• VM-Optionen: -Xmx2G -server (Speicher wird nur benötigt, wenn die großen Datensätze in den Beispielen verwendet werden)

• Programmargumente: (keine)

• Arbeitsverzeichnis: $MODULE_DIR$ (muss in das Verzeichnis optaplanner-examples aufgelöst werden)

• Verwenden Sie den Klassenpfad des Moduls: optaplanner-examples

Mitwirken bei OptaPlanner

Dies ist ein Open-Source-Projekt und Sie sind herzlich willkommen, einen Beitrag zu leisten ❤️!

• Wenn Sie gerade erst mit OptaPlanner beginnen und einen Beitrag leisten möchten, werfen Sie einen Blick auf unsere Starter-Ausgaben. Sie wurden speziell ausgewählt, um für Erstautoren einfacher zu sein.

• Wenn Sie einen Beitrag leisten oder eine Meinungsdiskussion starten möchten, nehmen Sie an unserer Diskussion teil oder senden Sie eine E-Mail direkt an [email protected].

• Wenn Sie ein Problem einreichen möchten, schauen Sie sich das OptaPlanner Jira-Projekt an.

Zeit für eine Veränderung?

Jede Änderung muss über einen GitHub Pull Request (PR) eingereicht werden. OptaPlanner verwendet kontinuierliche Integration (CI). Das OptaPlanner CI führt nach der Übermittlung der PR Prüfungen in Ihrer Branche durch, um sicherzustellen, dass Ihre PR keine Fehler verursacht. Wenn das CI ein potenzielles Problem erkennt, helfen Ihnen unsere freundlichen PR-Betreuer bei der Lösung.

Mitwirken

1. Forken Sie es (https://github.com/kiegroup/optaplanner).

2. Erstellen Sie Ihren Feature-Zweig: ( git checkout -b feature ).

3. Übernehmen Sie Ihre Änderungen mit einem Kommentar: ( git commit -am 'Add some feature' ).

4. Push zum Zweig zu GitHub: ( git push origin feature ).

5. Erstellen Sie eine neue Pull-Anfrage.

Code-Standards

Ihr Code wird bei jedem Maven-Build automatisch gemäß den Import- und Codestilkonventionen formatiert. CI-Prüfungen erzwingen auch diese Konventionen. Stellen Sie daher sicher, dass Sie Ihr Projekt mit Maven erstellen, bevor Sie Ihre PR erstellen:

 MVN-Neuinstallation

Informationen zum Einrichten von Codestilprüfungen finden Sie in den IDE-Setup-Anweisungen.

Erstellen Sie Ihr OptaPlanner-Projekt

Verwenden Sie eine der folgenden Möglichkeiten, um Ihr OptaPlanner-Projekt zu erstellen:

• build-fast : mvn clean install -Dquickly alle Prüfungen und Codeanalysen (~1 Minute)

• ? build-normally : mvn clean install führt Tests aus, prüft den Codestil, überspringt die Dokumentation (~17 Min.)

• ? build-doc : mvn clean install unter optaplanner/optaplanner-docs erstellt die Asciidoctor-Dokumentation target/optaplanner-docs-*/html_single/index.html (~2 Min.)

• ? build-all : mvn clean install -Dfull führt alle Prüfungen durch + erstellt Dokumentations- und Verteilungsdateien (~20 Min.)

OptaPlanner CI-Status

Sie können den CI-Status der OptaPlanner-Repositorys auf der Chain-Status-Webseite überprüfen.

Jenkins CI-Jobs (VPN-Zugang erforderlich)

Alle Jenkins-Jobs finden Sie im OptaPlanner-Ordner: https://eng-jenkins-csb-business-automation.apps.ocp-c1.prod.psi.redhat.com/job/KIE/job/optaplanner

Interessante Jenkins CI-Jobs (benötigen VPN-Zugang):

• Aktualisieren Sie die Quarkus-Version

• Aktualisieren Sie die Drools-Version

• Release-Pipeline (nur in Release-Zweigen verfügbar)

• Post-Release-Pipeline (nur in Release-Zweigen verfügbar)