始める前に
- 関連するグループコンテンツと個人情報をエクスポートする権限。
- ソースアプリケーション、エクスポート形式、意図した送信先のドキュメント。
- 外向き通知と外部統合を封じ込めた、分離されたテスト送信先。
1。パッケージで何ができる必要があるかを決めます。
エクスポートボタンを選択する前に、意図した結果を書いてください。退任するメンバー向けの読めるコピー、別のアプリケーションへの移行、既存サービスの完全なリカバリでは、必要な材料が異なります。1つのエクスポートが最初の目的には十分でも、残り2つには不十分な場合があります。
BookStackはこの区別を明確にしています。コンテンツのエクスポートおよびインポートツールは、バックアップと復元を目的としたものではありません。可読なHTMLまたはPDFのコピーは役立ちますが、アプリケーションのリカバリセットを暗黙のうちに置き換えるべきではありません。 BookStackのコンテンツのエクスポートとインポート.
仮想のワークショップグループの場合、初期目標は控えめです。別の承認されたメンテナが運用ハンドブックを読み、代表的なセクションを図を含めて別のテストインスタンスにインポートできることです。
2。形式と欠落を記録します。
何を保持する必要があり、それをどのように証明するかを記述したマトリクスを作成します。宛先を確認するまでセルに「完了」と記入しないでください。
| 素材 | 候補出力 | 解決すべき質問 |
|---|---|---|
| Wikiページ | 可読なHTMLとサポートされているインポートパッケージ | 見出し、リンク、図は保持されていますか? |
| 添付ファイル | 元のファイルとマニフェスト | 重要な各参照がそのファイルを見つけられますか? |
| カレンダー | サポートされているカレンダー交換ファイル | 繰り返しとタイムゾーンは期待どおりに動作しますか? |
| メンバーシップと権限 | 制御されたロールマッピングの注記 | どのアクセスルールを手動で再作成する必要がありますか? |
| アプリケーションのリカバリ | バージョン固有のバックアップセット | どの設定とデータベースがまだ必要ですか? |
BookStackは、コンテンツデータ、添付ファイル、画像を含み、BookStackに再インポートできるポータブルZIP形式を文書化しています。これは他のWikiとの互換性や、すべてのサービスレベルの設定の保持を保証するものではありません。 BookStackのエクスポート形式.
3。パッケージに人間向けの出発点を用意します。
ソースアプリケーションとバージョン、エクスポート日時とタイムゾーン、選択範囲、エクスポート担当者の役割、ファイル一覧、宛先を記した短いREADMEを追加します。説明的なフォルダ名を使用します。例: readable-content, attachments と import-package。認証情報は別の場所に保管し、承認されたメンテナ向けの承認済み取得手順のみを記載します。
仮想のハンドブックには、開始チェックリスト、マシンケアページ、図、1つのリンクされたスプレッドシートが含まれています。マニフェストにはこれら4項目、それらの相対パス、ページとその添付ファイルの関係が記録されています。また、制限されたページを意図的に除外したものとして記録し、後でその不在が偶発的な損失と誤解されないようにします。
チェックサムは転送中に変更されていないファイルを識別するのに役立ちます。エクスポートが完全であったこと、権限が正しかったこと、可読であることを証明するものではありません。
4。代表的なサンプルを検査します。
元のアプリケーションでのアクティブなセッションに依存せずに、可読コピーを開きます。リンクをたどり、埋め込み画像を検査し、リンクされた添付ファイルを開きます。ソースサービスにまだ戻る参照を探します。どのリンクが意図的に外部で、どのリンクが移動後に壊れるかを記録します。
カレンダーの場合、繰り返しイベント、例外、関連するタイムゾーンを持つイベントを含むサンプルを選択します。NextcloudはカレンダーのエクスポートとiCalendar互換の .ics インポートを文書化しています。これはサポートされた交換経路を確立しますが、ターゲットが選択したすべての機能を保持する証明ではありません。 Nextcloud Calendarのインポートとエクスポート.
インターフェースのラベルに従う前に、インストールされているリリースのドキュメントを確認してください。リンクされたローリングマニュアルは異なるバージョンを説明している可能性があります。
5。分離された制御済みの送信先にインポートします。
空のテスト宛先または明示的に承認されたテストコレクションを使用します。稼働中のサービスとその元のデータは触らないでください。インポートしたアプリケーションを起動する前に、送信通知を無効にし、外部接続を封じ込めます。目的はデータを評価することであり、過去のイベントをメンバーに再送することではありません。
2人目のメンテナに、エクスポート担当者の未文書化の指示に頼らずにREADMEに従ってもらいます。期待される項目とインポート結果を比較します。図、スプレッドシートのリンク、ページ構造、意図されたメンバー権限を検証します。手動対応が必要なロールマッピングを記録します。形式に必要な機能が欠けている場合は、再構築するか、別のエクスポート方法を選ぶか、新しいサービスと並行して可読アーカイブを保持するかを決定します。
6。失敗を有益にします。
ファイルが欠落している場合は、より大きなアーカイブを繰り返し生成する前に、エクスポート範囲とエクスポート担当者の権限を比較します。リンクが壊れている場合は、古いサービスを参照しているのか、パッケージに存在しないファイルを参照しているのかを判断します。インポートで予期しない重複が作成される場合は、同じパッケージを再度インポートする前に停止し、その一致ルールを検査します。
ワークショップの例では、受け入れとは、2人目のメンテナが選択したページを読み編集でき、含まれる各ファイルを取得でき、通常のメンバーが除外された資料にアクセスできないことを示せることです。各結果とそのレビュー担当者を記録します。「インポートが完了した」は1つの観察にすぎません。未解決の相違点はパッケージとともにリストに残し、グループがそれらについて意図的な決定を下せるようにします。
7。エクスポートとリカバリを別々のレーンに保ちます。
受け入れられたパッケージを、ソースサービスから独立した管理された場所に保存し、いつ更新するかを合意します。重要な形式、権限、またはアプリケーションバージョンの変更後に再度レビューします。エクスポートファイルは、宛先が一時的なものであってもプライベートな内容を含む可能性があるため、それらにもアクセス権と保持の決定を割り当てます。
アプリケーションのリカバリセットは別に保管します。たとえばBookStackのリカバリドキュメントでは、可読なドキュメントのエクスポートを超えたデータベースとファイルの素材が必要です。 BookStackのバックアップと復元の要件.
次に進みます: リストアドリル サービスリカバリについては、 ストレージワークシート エクスポート作業スペースについては、 サービスインベントリ 依存関係については、。ポータビリティは、ファイル拡張子から仮定するものではなく、パッケージで実証するものです。
この注記の背後にあるドキュメント
実際に実行しているバージョンのドキュメントを使用してください。これらの例は計画資料であり、Hoszen VPS でのテストの記録ではありません。