AES Integration mit einem Git-Quellcodeverwaltungs-Repository

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

    • Ermöglichen Sie Anwendungsentwicklern, App Engine Studio (AES) in ein Git-Quellcodeverwaltungs-Repository zu integrieren, um mehrere Versionen einer Anwendung aus einer Instanz außerhalb der Produktion zu speichern und zu verwalten.

    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 App Engine Studio

    Nach dem Verknüpfen einer Anwendung mit der Quellcodeverwaltung können Anwendungsentwickler App Engine Studio verwenden, um das Repository zu verwalten. Von App Engine 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.

    Die Quellcodeverwaltungsintegration unterstützt nicht die Verwaltung von Anwendungen in einer Produktionsinstanz. Stattdessen können Sie Anwendungen in einer Produktionsinstanz verwalten, indem Sie das App-Repository, ein Update Set oder App Engine Studioverwenden. 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 App Engine 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 App Engine 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 Quellcodeverwaltungsvorgänge 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 Quellcodeverwaltungsvorgang, wenn eine Nicht-Systemanwendungsdatei die XML-Schemavalidierung fehlschlägt.

    Die Git-Integration 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

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

    Berechtigungen für Quellcodeverwaltungsrolle

    Weitere Informationen zu Rollen und Mitarbeitenden finden Sie unter Anwendungszusammenarbeit.