ドキュメント

高度な設定

約1分で読めます · このページを GitHub で編集

← ShimoDocs Suite デプロイメント文書

機能概要

詳細設定は、システムのカスタムを管理するために使用されます pd-config 直接 YAMLを通じて。これは、標準設定ページで提供されていない高度なパラメータを処理する場合や、一括構成に適しています。

システムはカスタム構成を工場出荷時設定と統合します。同じパスのカスタム値はデフォルト値を上書きし、入力されていない構成は引き続き工場出荷時設定を使用します。

ページにアクセス

管理バックエンドにログイン後、左側ナビゲーションで 高度な設定 左側のナビゲーションでページにアクセスします。

高度な設定は管理者のみが利用できます。このページはシステム全体に影響を与える可能性があるため、設定構造に精通した担当者が操作する必要があります。 MDP

ページの説明

ページは2つの部分に分かれています:

  • 工場出荷時設定 pd-config:インストールパッケージによって提供されるデフォルトの構成で、読み取り専用です。
  • カスタム pd-config:現在保存されている顧客用カスタム構成で、編集可能です。

カスタム構成はデフォルトの内容をすべてコピーする必要はなく、通常は上書きまたは追加が必要な構成項目のみが保持されます。

設定の変更と公開

以下の手順に従うことを推奨します:

  1. クリック 更新 最新のカスタム設定が読み込まれていることを確認するため。
  2. 左側の工場出荷時設定と比較し、右側の内容を変更します。 YAML
  3. クリック 公開.
  4. 差分確認ウィンドウで追加、削除、変更された内容を確認します。
  5. 前/次の差分ボタンを使用して、変更点を項目ごとに確認します。
  6. エラーがないことを確認した後、クリックして 公開を確認する.

公開に成功すると、システムは構成アプリケーションタスクを作成し、新しいウィンドウでタスクログを開きます。変更内容やシステム設定によっては、関連サービスが自動的に再起動する場合があります。

構成履歴

クリック 履歴 以前に公開されたカスタム構成(レコードID、作成時間などを含む)を表示するには MD5.

  • クリック 表示 完全な YAML 履歴バージョンを確認するには
  • 2つのレコードを選択すると、差分比較を実行できます。

現在のページにはワンクリックで復元するボタンはありません。履歴構成を復元するには、該当バージョンを確認し、内容を認証した上で、手動で編集エリアにコピーし、再公開してください。

注意事項

  • YAML 構文は正しく保つ必要があります。インデント、コロン、データ型に注意してください。
  • 内容が理解できない構成項目を勝手に削除しないでください。
  • 公開前に差分を十分に確認し、他の管理者が最近提出した変更を上書きしないようにしてください。
  • 重要な変更は、業務の閑散時間に実行することが推奨され、元の構成は事前に記録しておく必要があります。
  • 公開後、タスクリストを確認して、構成の適用およびサービスの状態確認が完了していることを確認してください。

一般的な状況

  • 公開失敗: 次を確認してください YAML 形式、フィールド名、および構成値の種類。
  • 公開後のサービス再起動: 構成変更により関連サービスの再起動が必要な場合がありますが、これは正常です。
  • 公開後、一時的にページにアクセスできない場合: MDP または関連するサービスが再起動中の可能性があります。少し待ってから更新してください。
  • 構成が期待する効果を得られない場合: 構成パスが正しいか確認し、最終マージ結果とタスクリストを確認してください。
  • 誤った構成変更: 履歴から正しいバージョンを見つけ、内容をコピーして再公開してください。

高度な設定はシステムレベルの構成およびサービス運用に影響を与えるため、検証されていない構成を直接本番環境に公開しないでください。

操作インターフェースの例

下の図は、工場出荷時設定とカスタム設定の間の比較編集インターフェースを示しています。