Quellcodeverwaltungsintegration

Ermöglichen Sie Anwendungsentwicklern die Integration mit einem Git-Quellcodeverwaltungs-Repository. Speichern und verwalten Sie mehrere Versionen einer Anwendung von einer Nicht-Produktionsinstanz aus.

Durch das Verknüpfen einer Anwendung mit der Quellcodeverwaltung können alle Anwendungsentwickler in einer Nicht-Produktionsinstanz:

• Importieren Sie Anwendungen aus einem Git-Repository.
• Remote-Changes aus einem Git-Repository abrufen und anwenden
• Übernehmen Sie alle lokalen Änderungen an der Instanz in ein Git-Repository.
• Erstellen Sie Tags, um eine dauerhafte Verknüpfung mit einer bestimmten Version einer Anwendung herzustellen.
• Erstellen Sie Verzweigungen, um mehrere Versionen einer Anwendung gleichzeitig zu verwalten.

Integrationsanforderungen

So verknüpfen Sie eine Anwendung mit der Quellcodeverwaltung:

• Der Benutzer muss über die Administratorrolle verfügen.
• Die Nicht-Produktionsinstanz muss über Netzwerkzugriff auf das Git-Repository verfügen.
• Jede Anwendung muss sich in einem eigenen Git-Repository befinden.
• Die Anmeldeinformationen des Repository-Benutzers müssen Lese- und Schreibzugriff gewähren.

Hinweis:

Alle Anwendungsentwickler in der Instanz verwenden einen einzigen Satz Anmeldeinformationen pro Repository .

Verfügbare Optionen ab ServiceNow Studio

Nach dem Verknüpfen einer Anwendung mit der Quellcodeverwaltung können Anwendungsentwickler das Repository mit ServiceNow Studio verwalten. Von Studio aus können Entwickler Folgendes tun:

• Bearbeiten Sie die Anmeldeinformationen des Anwendungs-Repositorys.
• Übernehmen Sie alle lokalen Änderungen in der Instanz.
• Anwenden von Remote-Changes aus dem Repository.
• Erstellen Sie eine Verzweigung.
• Verzweigungen wechseln.
• Importieren Sie eine Anwendung aus einem Remote-Repository.

Es wird nicht empfohlen, die Quellcodeverwaltung zum Verwalten von Anwendungen in einer Produktionsinstanz zu verwenden. Die Bereitstellung in der Produktion kann zu unbeabsichtigten Konsequenzen führen, siehe Tipps zur Produktionsbereitstellung. Stattdessen können Sie Anwendungen in einer Produktionsinstanz mithilfe des Anwendungs-Repository, eines Update Sets oder ServiceNow Storeverwalten. Weitere Informationen zum Verwalten von Anwendungen in einer Produktionsinstanz finden Sie unter Anwendungsfreigabe.

Optionen, die in einem Git-Repository verfügbar sind

Die ServiceNow -Plattform bietet eingeschränkten Support für das Ändern verknüpfter Anwendungsdateien außerhalb einer Instanz. In Git können Entwickler:

• Verschieben Sie Anwendungsdateien in eine andere Git-Verzeichnisstruktur.
• Bearbeiten Sie Anwendungsdateien außerhalb von ServiceNow Studio.

Das System generiert eine Eigenschaftentextdatei mit dem Namen sn_source_control.properties auf der Stammebene des Repositorys. Um Anwendungsdateien in eine andere Git-Verzeichnisstruktur zu verschieben, können Anwendungsentwickler den Parameter path festlegen, um den Unterordnerpfad anzugeben, der die Anwendungsdateien enthält. Beispiel: Wenn Sie Ihre Anwendung in den Unterordner src/app verschoben haben, legen Sie path auf path=src/appfest.

Das System generiert eine checksum.txt -Datei im Git-Repository, um festzustellen, ob Anwendungsdateien außerhalb von Studiogeändert wurden. Wenn der Prüfsummenwert aus der Datei mit dem aktuellen Prüfsummenwert übereinstimmt, überspringt die Integration den Validierungs- und Bereinigungsprozess. Wenn die Prüfsummenwerte nicht übereinstimmen, validiert und bereinigt die Integration die Anwendungsdateien als Teil des Quellcodeverwaltungsvorgangs. Der Bereinigungsprozess:

• Erstellt Upgrade-Protokolleinträge für jede durchgeführte Bereinigungsaktion.
• Entfernt nicht unterstützte Ordner und Dateien aus dem Repository.
• Bricht alle Quellcodeverwaltungsvorgänge ab, wenn eine Systemanwendungsdatei die XML-Schemavalidierung nicht besteht. Beispiel: Wenn ein Datenbank-Dictionary-Datensatz die XML-Schemavalidierung nicht besteht, bricht das System alle Vorgänge ab.
• Überspringt den aktuellen Quellcodeverwaltungsvorgang, wenn eine Nicht-Systemanwendungsdatei die XML-Schemavalidierung nicht besteht.

Die Quellcodeverwaltungsintegration bereinigt nur Inhalte innerhalb des Anwendungspfads, der in der Datei sn_source_control.properties aufgeführt ist. Repository-Inhalt außerhalb des Anwendungspfads wird ignoriert.

MID-Server-Unterstützung

Verwenden Sie einen vorhandenen MID-Server, um eine Verbindung zu einem Quellcodeverwaltungs-Repository herzustellen. Das Verknüpfen oder Importieren einer Anwendung über einen MID Server ermöglicht den Zugriff auf Repositorys hinter einer Firewall.

Konfigurieren Sie den MID-Server für die Integration der Quellcodeverwaltung

Konfigurieren Sie einen MID-Server für die Quellcodeverwaltungsintegration, um die Kommunikation und die Bewegung von Daten zwischen einer ServiceNow -Instanz und externen Anwendungen, Datenquellen und Services zu ermöglichen.

• Fügen Sie die Erweiterung „bundle“ den Eigenschaften „ glide.attachement.extensions “ hinzu.
• Wenn die MID Server einen Proxy durchlaufen müssen, um auf das Remote-GIT-Repository zuzugreifen, gehen Sie wie folgt vor:
  • Fügen Sie der Datei agent\conf\wrapper-override.conf die folgende Zeile hinzu:
  • wrapper.java.additionial.3=-Dhttps.proxyHost=<proxyHost>
  • wrapper.java.additionial.4=-Dhttps.proxyPort=<proxyPort>
  • Starten Sie den MID neu
  • Fügen Sie einen neuen Eintrag in „MID-Sicherheitsrichtlinie“ hinzu:
  • Name:<proxy host name>
  • Aktivieren Sie nur „Aktiv“.

Quellcodeverwaltungs-Commits entrauschen

Überspringen Sie das Entladen von verrauschten Aktualisierungsfeldern für einen Metadatensatz in XML-Dateien in die Quellcodeverwaltung.

• Tipps zur Produktionsbereitstellung
  Wenn Sie Anpassungen für Anwendungen auf der Plattform ServiceNow® entwickeln, stellen Sie sie über das Anwendungs-Repository in einer Produktionsinstanz bereit. In diesem Thema werden die Probleme zwischen der Installation einer Anwendung aus dem Anwendungs-Repository und der Installation eines Git-Repositorys mit Quellcodeverwaltung untersucht, und es werden Warnungen dazu gegeben.
• Verfügbare Quellcodeverwaltungsvorgänge
  Die Quellcodeverwaltungsintegration unterstützt hauptsächlich Vorgänge von Studio, kann aber auch einige Operationen direkt aus dem GIT-Repository unterstützen.
• Importieren Sie die Anwendung oder Anwendungsanpassung aus der Quellcodeverwaltung
  Importieren Sie eine Anwendung oder Anwendungsanpassung aus einem Quellcodeverwaltungs-Repository, um die Entwicklung in dieser Instanz fortzusetzen.
• Verknüpfen Sie eine Anwendung oder Anwendungsanpassung mit der Quellcodeverwaltung
  Durch die Verknüpfung einer Anwendung oder Anwendungsanpassung mit der Quellcodeverwaltung können Anwendungsentwickler Änderungen aus einem Git-Repository verwalten.
• Migrieren Sie den Verlauf der abgeschlossenen Update Sets in die Quellcodeverwaltung
  Bei der Verknüpfung mit der Quellcodeverwaltung ermöglicht diese Funktion Anwendungsentwicklern die Möglichkeit, die Informationen in abgeschlossenen Update Sets in den Verlauf der Quellcodeverwaltung zu migrieren.
• Bearbeiten Sie eine Git-Repository-Konfiguration
  Sie können ein Git-Repository bearbeiten, um die Netzwerkprotokollauswahl, die Anmeldeinformationen oder andere Feldeinträge zu ändern.
• Remote-Changes übernehmen
  Anwendungsentwickler können Changes aus einem verknüpften GIT-Repository abrufen, um Remote-Changes auf die lokale Instanz anzuwenden.
• Changes committen
  Anwendungsentwickler können ihre Änderungen an der Instanz im verknüpften Git-Repository festschreiben. Sie können entweder einige Änderungen zum Festlegen auswählen oder alle Änderungen an der Instanz auf einmal festlegen.
• Stash für lokale Änderungen ausführen
  Anwendungsentwickler können Changes entfernen und lokal speichern, um sie später anzuwenden.
• Verzweigung wechseln
  Anwendungsentwickler können zu einer anderen Repository-Verzweigung wechseln, um mit einer anderen Version der Anwendung zu arbeiten.
• Verzweigung erstellen
  Anwendungsentwickler können eine Verzweigung erstellen, um mit einer neuen Version einer vorhandenen Anwendung zu arbeiten.
• Legen Sie die Standardverzweigung fest
  Legen Sie eine Standardverzweigung fest, wenn Sie eine andere Verzweigung als die Hauptverzweigung für neue Änderungen oder für Ihr Haupt-Entwicklungs-Repository verwenden möchten.
• Stashes verwalten
  Anwendungsentwickler können Changes, für die ein Stash ausgeführt wurde, in Studio anwenden oder löschen.
• Konflikte lösen
  Anwendungsentwickler können auswählen, welche Anwendungsdateiversion verwendet werden soll, wenn Remote-Changes oder Changes, für die ein Stash ausgeführt wurde, übernommen werden.
• Commit-Verlauf anzeigen
  Anwendungsentwickler können den Commit-Verlauf von Anwendungen anzeigen, die mit einem Quellcodeverwaltungs-Repository verbunden sind.
• Verschieben Sie Anwendungsdateien in einem GIT-Repository
  Verschieben Sie mit der Quellcodeverwaltung verknüpfte Anwendungsdateien in einen beliebigen Ordner des Repositorys. Ermöglichen Sie Anwendungsentwicklern, unterstützende Inhalte wie automatisierte Tests im selben Repository wie die von ihnen unterstützten Anwendungen zu speichern.
• Kollisionsvermeidung
  Vermeiden Sie es, eine Anwendungsdatei über verschiedene Update Sets hinweg zu ändern, um eine nahtlose Experience während des Commit-Prozesses zu gewährleisten.
• Delta wird geladen
  „Delta Loading“ ist eine optimierte Methode zum Laden einer Anwendung aus einem Git-Repository.
• Entrauschen Sie Ihre Quellcodeverwaltungs-Commits
  Als Quellcodeverwaltungsentwickler können Sie die Git-Verzweigungen zusammenführen, ohne Rauschen aus den Feldern zu erhalten, die vom System automatisch aktualisiert werden.