でのソースコントロール統合 ServiceNow スタジオ

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:4分
  • アプリケーション開発者が Git ソースコントロールリポジトリと統合できるようにします。非本番インスタンスから、グローバルアプリケーションまたはスコープ対象アプリケーションの複数のバージョンを保存および管理します。

    アプリケーションをソースコントロールにリンクすると、非本番インスタンスですべてのアプリケーション開発者が次の操作を実行できます。
    • Git リポジトリからアプリケーションをインポートします。
    • Git リポジトリからリモート変更をプルして適用します。
    • インスタンスのすべてのローカル変更を Git リポジトリにコミットします。
    • 指定されたバージョンのアプリケーションに永続的にリンクするタグを作成します。
    • 分岐を作成して、アプリケーションの複数のバージョンを同時に管理します。

    統合の要件

    アプリケーションをソースコントロールにリンクするには
    • ユーザーにはアドミンロールが必要です。
    • 非本番インスタンスには、Git リポジトリへのネットワークアクセスが必要です。
    • 各アプリケーションは、それ自体の Git リポジトリ内に存在する必要があります。
    • リポジトリユーザーの認証情報は、読み取りおよび書き込みアクセス権を付与する必要があります。
    注:
    インスタンス上のすべてのアプリケーション開発者は、リポジトリごとに 1 組の認証情報を共有します。

    ServiceNow スタジオ で利用可能なオプション

    アプリケーションをソースコントロールにリンクした後に、アプリケーション開発者は、ServiceNow スタジオをリポジトリ管理に使用できます。開発者は ServiceNow スタジオ から次のことができます
    • アプリケーションリポジトリの認証情報を編集します。
    • インスタンスのすべてのローカル変更をコミットします。
    • リポジトリからのリモート変更を適用します。
    • 分岐を作成します。
    • 分岐を切り替えます。
    • リモートリポジトリからアプリケーションをインポートします。

    ソースコントロール統合は、本番インスタンスでのアプリケーションの管理をサポートしていません。代わりに、アプリケーションリポジトリ、更新セット、または ServiceNow スタジオ を使用して、本番インスタンスでアプリケーションを管理できます。本番インスタンスでのアプリケーション管理の詳細については、「アプリケーションの共有」を参照してください。

    Git リポジトリから利用可能なオプション

    ServiceNow AI Platformは、インスタンスの外部でリンクされたアプリケーションファイルを変更するための限定的なサポートを提供します。開発者は Git から次の操作を実行できます。
    • アプリケーションファイルを別の Git ディレクトリ構造に移動します。
    • ServiceNow スタジオ の外部でアプリケーションファイルを編集します。

    リポジトリのルートレベルで、sn_source_control.properties と呼ばれるプロパティテキストファイルが生成されます。アプリケーションファイルを別の Git ディレクトリ構造に移動するために、アプリケーション開発者は path パラメーターを設定して、アプリケーションファイルを含むサブフォルダーパスを指定できます。たとえば、アプリケーションを src/app サブフォルダーに移動した場合は、pathpath=src/app に設定します。

    システムは、ServiceNow スタジオ の外部でアプリケーションファイルが変更されたかどうかを判断するために、Git リポジトリに checksum.txt ファイルを生成します。ファイルのチェックサム値が現在のチェックサム値と一致する場合、統合は検証とサニタイズのプロセスをスキップします。チェックサム値が一致しない場合、統合はソースコントロール操作の一部としてアプリケーションファイルを検証してサニタイズします。サニタイズプロセス:
    • 実行されたサニタイズアクションごとに、アップグレードログエントリを作成します。
    • サポートされていないフォルダーとファイルをリポジトリから削除します。
    • システムアプリケーションファイルが XML スキーマの検証に失敗した場合、すべてのソースコントロール操作を中止します。たとえば、データベースディクショナリレコードが XML スキーマの検証に失敗した場合、システムはすべての操作を中止します。
    • 非システムアプリケーションファイルが XML スキーマの検証に失敗した場合、現在のソースコントロール操作をスキップします。

    Git 統合は、sn_source_control.properties ファイルにリストされているアプリケーションパス内のコンテンツのみをサニタイズします。アプリケーションパス外のリポジトリコンテンツは無視されます。

    MID サーバー でのサポート

    既存の MID サーバー を使用して、ソースコントロールリポジトリに接続します。MID サーバーを介してアプリケーションを接続すると、ファイアウォールの背後にあるリポジトリにアクセスできます。

    ソースコントロール権限

    ロールと協力者の詳細については、「アプリケーションコラボレーション」を参照してください。