Git ソースコントロールリポジトリと AES の統合

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む4読むのに数分

    • アプリケーション開発者が App Engine Studio (AES) を Git ソースコントロールリポジトリと統合し、非本番インスタンスから複数のバージョンのアプリケーションを保存および管理できるようにします。

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

    統合の要件

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

    App Engine Studio で利用可能なオプション

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

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

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

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

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

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

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

    MID Server のサポート

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

    ソースコントロール権限

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