Integration der Quellcodeverwaltung

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 3 Minuten Lesedauer

    • Ermöglichen Sie Anwendungsentwicklern die Integration mit einem Git-Quellcodeverwaltungs-Repository. Speichern und verwalten Sie mehrere Versionen einer Anwendung aus einer Instanz außerhalb der Produktion.

    Durch das Verknüpfen einer Anwendung mit der Quellcodeverwaltung können alle Anwendungsentwickler in einer Instanz außerhalb der Produktion:
    • Importieren Sie Anwendungen aus einem Git-Repository.
    • Remote-Changes aus einem Git-Repository abrufen und anwenden.
    • Committen Sie alle lokalen Changes in der Instanz in einem Git-Repository.
    • Erstellen Sie Tags, um eine dauerhafte Verknüpfung zu 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 die Administratorrolle besitzen.
    • Die Instanz außerhalb der Produktion muss Netzwerkzugriff auf das Git-Repository haben.
    • Jede Anwendung muss sich in einem eigenen Git-Repository befinden.
    • Die Anmeldeinformationen des Repository 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

    Nachdem eine Anwendung mit der Quellcodeverwaltung verknüpft wurde, können Anwendungsentwickler das Repository mit ServiceNow Studio verwalten. Von Studio aus können Entwickler Folgendes tun:
    • Bearbeiten Sie die Anmeldeinformationen für das Anwendungs-Repository.
    • Committen Sie alle lokalen Changes 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 Folgen führen (siehe Tipps zur Produktionsbereitstellung) . Stattdessen können Sie Anwendungen in einer Produktionsinstanz verwalten, indem Sie das App-Repository, ein Update Set oder ServiceNow Storeverwenden. Weitere Informationen zum Verwalten von Anwendungen in einer Produktionsinstanz finden Sie unter Anwendungsfreigabe.

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

    Die Plattform ServiceNow bietet eingeschränkte Unterstützung für das Ändern verknüpfter Anwendungsdateien außerhalb einer -Instanz. In Git können Entwickler:
    • Verschieben Sie die Anwendungsdateien in eine andere Git-Verzeichnisstruktur.
    • Bearbeiten Sie Anwendungsdateien außerhalb von ServiceNow Studio.

    Das System generiert eine Eigenschaftstextdatei 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 ihre Anwendungsdateien enthält. Wenn Sie beispielsweise Ihre Anwendung in den Unterordner „ src/app “ verschoben haben, legen Sie path auf path=src/appfest.

    Das System generiert die Datei checksum.txt im Git-Repository, um zu bestimmen, 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 im Rahmen der Quellcodeverwaltung. Der Bereinigungsprozess:
    • Erstellt Upgrade-Protokolleinträge für jede durchgeführte Bereinigungsaktion.
    • Entfernt nicht unterstützte Ordner und Dateien aus dem Repository.
    • Bricht alle Vorgänge der Quellcodeverwaltung ab, wenn eine Systemanwendungsdatei die XML-Schemavalidierung nicht besteht Wenn beispielsweise ein Datenbank-Dictionary-Datensatz die XML-Schemata-Validierung nicht besteht, bricht das System alle Vorgänge ab.
    • Überspringt den aktuellen Vorgang der Quellcodeverwaltung, wenn eine Nicht-Systemanwendungsdatei die XML-Schemavalidierung nicht besteht.

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

    MID-Server-Unterstützung

    Vorhandenen MID-Server verwenden, 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 Datenbewegung zwischen einer ServiceNow -Instanz und externen Anwendungen, Datenquellen und Services zu ermöglichen.

    • Fügen Sie die Erweiterung „bundle“ den Eigenschaften „ glide.attachment.extensions “ hinzu.
    • Wenn MID-Server für den Zugriff auf das Remote-Git-Repository einen Proxy verwenden müssen, gehen Sie wie folgt vor:
      • Fügen Sie der Datei agent\conf\wrapper-override.conf die folgende Zeile hinzu:
      • Wrapper.java.additional.3 = -Dhttps.proxyHost =<proxyHost>
      • Wrapper.java.additional.4 = -Dhttps.proxyPort =<proxyPort>
      • Starten Sie den MID neu
      • Neuen Eintrag in „MID-Sicherheitsrichtlinie“ hinzufügen:
      • Name:<proxy host name>
      • Nur „Aktiv“ aktivieren

    Denrauschen-Quellcodeverwaltungs-Commits

    Überspringen Sie das Entladen von verrauschten Aktualisierungsfeldern in XML-Dateien für alle Metadaten-Datensätze in der Quellcodeverwaltung.