archi bot 製品ドキュメント

この翻訳は機械生成です(ベータ版)。正本は英語のガイドです。

復元ソース

バックアップと復元ソース

Create Workspace が注入できる、データベース、WAR、リポジトリにリンクされた復元アーティファクトを確認、アップロード、整理、選択します。

顧客管理者プラットフォーム運用担当者

最終更新

安全なサンプルデータでカタログスナップショットのメトリクスと「アーティファクトインベントリ」「バックアップのアップロード」タブを表示している Console のバックアップ管理。
安全なデータを使った Console レンダリングの例: バックアップ管理は、ワークスペースが利用する前に、カタログスナップショットとインベントリタブを表示した状態で、承認済みの復元アーティファクトを Console が認識できることを確認します。

バックアップ管理の目的

バックアップ管理は、承認済みのデータベース、WAR、リポジトリにリンクされた復元ファイルが、ワークスペースで使用される前に Console から認識できることを確認します。アップロードとリポジトリの関連付けによって、Create が新しいワークスペースに注入できるものが決まるため、ストレージアクセスの問題は通常ここで最初に現れます — ワークスペースの復元を中断させる前にです。

シードされた復元素材が顧客に必要な場合は最初のワークスペース作成前にこのページを使い、また復元カタログを整理する必要があるときはいつでも使用してください。

誰が何をできるか

カタログの確認は顧客メンバーと運用担当者が利用できます。バックアップのアップロード、編集、関連付け、削除には顧客メンバーのアクセス権が必要です。 そのアクセス権がない場合、「アップロード」コントロールと行ごとの管理アクションは無効のままになります。サービストークンとストレージの内部は運用担当者が所有し、このページでは公開されません。

ページを開いてヘッダーを読む

ページは バックアップ管理 で開きます。ヘッダーには 2 つのコントロールがあります。

  • 更新 — ストレージからカタログを再読み込みします。
  • アップロード — アップロードフォームに切り替えます。アップロードのアクセス権がない場合は無効になります。

このページから Create に復元ソースが固定されている場合、タイトルの横に ワークスペース復元を選択済み バッジが表示されます。

カタログスナップショットを読む

折りたたみ可能な カタログスナップショット には 4 つのメトリクスが表示されます。スナップショットを隠す / スナップショットを表示 を使って折りたたんだり展開したりします。

メトリクス何を伝えるか
カタログCreate から見えるアーティファクトの総数と、現在のインベントリフィルター適用後に残る数。
管理対象アップロード直接アップロードしたアーティファクトと、カタログ内にあるオブジェクトストレージバックアップの数。
リポジトリリンク済み少なくとも 1 つのリポジトリ関連付けを持つアーティファクトと、カタログに供給しているストレージバケットの数。
ワークスペース選択Create が待機している復元ソース(ある場合)。何も固定されていない場合は「なし」と表示されます。

カタログスナップショットを展開したバックアップ管理。「カタログ」「管理対象アップロード」「リポジトリリンク済み」「ワークスペース選択」のメトリクスが「アーティファクトインベントリ」「バックアップのアップロード」タブの上に表示されている。

2 つのタブを切り替える

スナップショットの下には 2 つのタブがあります。

  • アーティファクトインベントリ — フィルター、並べ替え可能な列、ページ送りを備えた復元向けカタログ。
  • バックアップのアップロード — 管理対象の復元アーティファクトを追加するためのフォーム。アップロードのアクセス権がない場合、このタブは無効になります。

管理対象バックアップをアップロードする

管理対象アップロードは、ファイルとメタデータが保存された後、新しいワークスペースの復元候補になります。

  1. バックアップのアップロード タブを開きます(またはヘッダーの アップロード ボタンを使用します)。
  2. バックアップファイル を選択します。
  3. データベース の種類 — Oracle または SQL Server — を選択します。
  4. 明確な 表示名バックアップ日 を設定します。
  5. アーティファクトの内容が顧客に分かるように 説明 を追加します。
  6. 任意で リポジトリと関連付け(任意) にクローン URL を入力すると、Create がそのリポジトリに対してバックアップを自動的に推奨できます。
  7. バックアップのアップロード を選択します。進行状況バーにアップロードの割合が表示され、完了するとページはインベントリに戻ります。

バックアップファイルピッカー、データベースセレクター、表示名、バックアップ日、接続済みの Git プロバイダーを表示する「アップロードコンテキスト」サイドパネルを備えた「バックアップのアップロード」タブ。

スキーマはアップロード時に AFM がデフォルトになり、アップロードフォームにはスキーマフィールドはありません。スキーマは後で バックアップを編集 から調整できます。

表示名や説明に資格情報や接続文字列を含めないでください。これらのフィールドは、顧客が復元ポイントを選ぶ際に読むカタログメタデータです。

右側の アップロードコンテキスト パネルは、フォームの入力中も、接続済みの Git プロバイダー、現在のワークスペースバックアップ選択、カタログバケットを表示し続けます。これは読み取り専用のコンテキストであり、追加のステップではありません。

アーティファクトインベントリを操作する

アーティファクトインベントリ タブは、Create 向けの復元カタログです。フィルターカードには 6 つのコントロールがあります。

フィルター用途
検索名前、URL、説明、またはリポジトリで一致させます。
ソース管理対象アップロードまたはオブジェクトストレージに絞り込みます。
データベースOracle または SQL Server に限定します。
関連付けリポジトリにリンクされた、またはリンクされていないアーティファクトを表示します。
リポジトリgitlab.example.com/group/repo のような特定のリポジトリパスに一致させます。
バケット1 つのストレージバケットに限定します。

いずれかのフィルターが有効になると リセット コントロールが表示されます。リストヘッダーには 合計フィルター済み表示中 の数が表示されるため、フィルターが期待どおりに機能していることを確認できます。

行を選択すると、その詳細 — データベースの種類、バケット、リンク済みリポジトリ数 — がカタログの操作中も 選択中のアーティファクト カードに保持されます。オブジェクトストレージバケットは、バケットメタデータが現在の結果に付随している場合にのみ表示されます。

結果を並べ替えてページ送りする

インベントリテーブルの列 — 名前DBサイズアップロード日 — は並べ替え可能です。列ヘッダーを選択すると昇順と降順が切り替わります。テーブルの下で ページサイズ(10 から 1000)を設定し、前へ次へ で結果を移動します。フッターには現在のページと一致総数が表示されます。

ワークスペースの復元ソースを選択する

  1. インベントリでアーティファクトを見つけます。
  2. その行をクリックするか、行アクションの ワークスペース用に選択 を使用します。
  3. 選択したアーティファクトは、変更するまで Create フローに引き継がれ、スナップショットの ワークスペース選択 メトリクスもそれに合わせて更新されます。

Create が復元ソースを実際に待機しているとき、ページには通知が表示され、インベントリは起動元のリポジトリにリンクされたバックアップに事前フィルターされます。リンクされたものがない場合、Console は一致するデータベースカタログにフォールバックします。

リポジトリの関連付けを管理する

バックアップをリポジトリにリンクすると、そのリポジトリが Create で使用されたときに Console が自動的に推奨できるようになります。

  1. 行アクションで 関連付けを管理(リンクアイコン)を選択します。選択したバックアップの関連付けダイアログが開きます。
  2. 既存のリンクは 現在のリポジトリ の下に表示されます。ゴミ箱コントロールで削除できます。削除前に Console が確認を求めます。
  3. リンクを追加するには、プロバイダー — GitLab、GitHub、Bitbucket、または Azure DevOps — を選び、接続済みのプロバイダーからリポジトリを選択します。
  4. プロバイダーが接続されていない場合は、カスタム URL を使用 にチェックを入れ、代わりに完全なクローン URL を貼り付けます。ダイアログ内からプロバイダーを 接続 したり、リポジトリリストを 更新 したりすることもできます。
  5. 優先度 を設定し、適切な場合は このリポジトリのデフォルト をチェックしたままにします。
  6. 関連付けを追加(既存リンクの更新時は 関連付けを保存)を選択します。
  7. 完了したらダイアログを閉じます。

リポジトリの参照には接続済みのプロバイダーが必要です。ない場合はカスタムクローン URL を使用してください。ダイアログにはプロバイダーが接続されているかどうかが表示されるため、検索が利用可能かどうかが分かります。

アップロードフォームの任意の リポジトリと関連付け フィールドは、ここで作成される関連付けと同じものです — アップロード時に最初のリンクをシードし、後で調整できます。

バックアップを編集する

顧客が見るカタログ詳細を更新するには、バックアップを編集(行アクションの鉛筆アイコン)を使用します。

  1. そのアーティファクトの バックアップを編集 を開きます。
  2. 表示名データベース の種類、スキーマ(デフォルトは AFM)、説明 を更新します。
  3. 変更を保存 を選択します。

表示名は必須で、残りは任意のメタデータです。

バックアップを削除する

カタログからアーティファクトを削除するには、削除(ゴミ箱アイコン)を使用します。削除前に Console がネイティブダイアログで確認を求めます。バックアップを削除すると復元候補から外れるため、まずアクティブなワークスペース起動用に固定されていないことを確認してください — スナップショットの ワークスペース選択 メトリクスを確認します。

関連ガイド

完了の条件

  • ワークスペースが利用する前に、承認済みの復元ファイルを Console が認識できる。
  • アップロードされたバックアップに、明確な表示名、データベースの種類、バックアップ日が付いている。
  • リポジトリの関連付けにより、各バックアップが Create が優先すべきリポジトリを指している。
  • Create を起動する前に、選択された復元ソースが確認されている。