Git リポジトリからの Bot の復元

すべての Bot とその依存ファイルを、Git リポジトリからサーバー リポジトリに復元できます。このリストア オプションは、オンプレミス デプロイでのみ使用でき、クラウド デプロイではサポートされていません。

前提条件

Git から Bot を復元する前に、次のことを確認してください。

  • Git の Bot のバックアップが必要です。
  • AAE_Admin ロールが割り当てられている必要があります。

Git リポジトリから Bot を復元する際には、以下の点に注意してください。

  • 外部の Git リポジトリからすべてのまたは差分の Bot とファイルを復元できます。外部の Git リポジトリから特定の Bot またはファイルを選択的に復元することはできません。
  • Git 復元プロセスには、ある程度のダウンタイムが必要です。復元プロセスが実行されている場合、次の公開ワークスペース操作は無効になります。
    • チェックアウト
    • クローンを作成
    • Bot を実行してスケジュール設定
    • キュー付きの Bot を実行
    • Bot をインポート/エクスポート
  • 復元プロセスが実行されている場合、非公開ワークスペースからのチェックイン操作は許可されません。ただし、残りの操作には非公開ワークスペースを使用できます。
  • Bot は、空のリポジトリにも空でないリポジトリにも復元できます。
  • 実行中の復元プロセスを中止することはできません。
Git 復元機能は、以下のシナリオで重要です。
  • サーバー リポジトリが破損したため、新しいサーバー リポジトリで開始する。
  • Bot を別の Git ブランチに復元したい。

    たとえば、Git に 2 つのブランチDev と Test があり、それぞれ Dev と Test の Control Room に統合されているとします。Test ブランチでは Dev ブランチからコンテンツをプルでき、Git の Bot を Test Control Room で復元できます。

手順

  1. Control Room に管理者ユーザーとしてログインします。
  2. 左側のペインで [オートメーション] をクリックします。
    使用可能な Bot とフォームのリストが表示されます。
  3. [公開] ワークスペースの [Git からリストア] オプションをクリックします。
    [Git から復元] ダイアログ ボックスが表示され、Git 復元プロセス中はすべてのパブリック リポジトリ操作が無効になることを示す警告が表示されます。
  4. Git リポジトリに重複ファイルがある場合は、Git リポジトリの [既存のファイルを上書き] または [既存のファイルをスキップ] を選択します。
  5. リポジトリが空か空でないかに基づいて、次のいずれかのオプションを選択します。
    • 完全な空ではないリポジトリにファイルを復元するには、関連付けられているリポジトリの Git 資格情報を入力します。
      注: 部分的に満たされたリポジトリに既存の Git の設定を使用することはできません。
    • ファイルを完全に空のリポジトリに復元するには、ファイルの復元の Git リポジトリを選択します。
    オプションアクション
    既存の Git 構成設定を使用 このオプションを選択すると、Control Room で設定された Git リポジトリからデータが復元されます。
    注: [管理] > [設定] > [リモート Git リポジトリ統合] から、Control Room がリモート Git リポジトリに接続していることを確認します。
    手動設定を使用 他のリポジトリからデータを復元するには、このオプションを選択します。
    1. 次の形式のユーザー名を含む HTTPS リポジトリ パスを入力します。

      https://<username>@bitbucket.org/companyname/product.git

    2. ブランチ名を入力します。
    3. Git リポジトリのパスワード、または生成された Git トークンを入力します。
    4. 確認のために、パスワードまたは Git トークンを再入力します。
    注: 既存の Git 構成と同じ設定を使用している場合は、エラーが発生します。同じ設定を使用するには、まず、[管理] > [設定] > [リモート Git リポジトリ統合] 内のリモート Git リポジトリ統合設定を削除してから、この手動設定オプションで同じ設定を行います。
  6. オプション: [プロキシ経由で Git に接続する] のチェックボックスを選択します。
    1. プロキシのホスト名または IP アドレスを入力します。
    2. ポート番号を入力します。
    3. オプション: 認証のチェック ボックスを選択し、ユーザー名とパスワードを入力します。
  7. [続行] をクリックして、復元プロセスを続行します。
    Git から Bot および依存ファイルの復元が開始されます。このプロセスには多少時間がかかります。
    復元プロセスが正常に完了すると、自動的に [オートメーション] ページに戻ります。依存ファイルの元の構造を維持したまま、Bot と依存ファイルが新しいサーバー リポジトリに復元されます。

一部の Bot を復元した後に Git 復元プロセスが失敗した場合は、次のオプションを備えた公開ワークスペースにリダイレクトされます。復元プロセスを完了するには、必要なオプションを選択します。

オプション アクション
復元を元に戻す このオプションは、復元されたすべての Bot を消去します。
注: このオプションは、Git リポジトリから復元されたパブリック Bot を削除します。
復元を再開 Git 復元プロセスは、終了したところから再開されます。
復元されたファイルのみを保持する このオプションは、復元されたファイルを保持し、復元プロセスを終了します。