Adobe Managed Services（AMS）の基本的なファイルレイアウト

AMS 標準設定ファイルセットと、Adobe Experience Managerのこの設定標準の背後にある考え方について説明します。

説明 description

環境

Adobe Experience Manager（AEM）

問題／症状

このドキュメントでは、AMS 標準設定ファイルセットと、この設定標準の背後にある考え方について説明します。

解決策 resolution

デフォルトの Enterprise Linux フォルダー構造

AMS では、基本インストールは、基本オペレーティングシステムとして Enterprise Linux を使用します。 Apache web サーバーをインストールすると、デフォルトのインストールファイルが設定されます。 yum リポジトリが提供する基本 RPM をインストールするとインストールされるデフォルトのファイルを次に示します。

/etc/httpd/
├── conf
│   ├── httpd.conf
│   └── magic
├── conf.d
│   ├── autoindex.conf
│   ├── README
│   ├── userdir.conf
│   └── welcome.conf
├── conf.modules.d
│   ├── 00-base.conf
│   ├── 00-dav.conf
│   ├── 00-lua.conf
│   ├── 00-mpm.conf
│   ├── 00-proxy.conf
│   ├── 00-systemd.conf
│   └── 01-cgi.conf
/var/log/httpd
/usr/lib64/httpd/modules
/run/httpd

インストールの設計/構造に従って作業を行うと、次の利点が得られます。

メモ：

Adobe Managed Services サーバーの画像には、通常、小さなオペレーティングシステムのルートドライブが付いています。 データは別のボリュームに配置され、通常は /mnt にマウントされます。

その後、次のデフォルトディレクトリのデフォルトの代わりにボリュームが使用されます。

ドキュメントルート

ログディレクトリ

古いディレクトリと新しいディレクトリは、混乱を避けるために元のマウントポイントに再びマッピングされることに注意してください。 別のボリュームを使用することは必須ではありませんが、注目すべき点です。

AMS アドオン

AMS は、Apache web サーバーのベースインストールに追加されます。

ドキュメントルート

AMS デフォルトのドキュメントルート：

ステージングおよび有効な VirtualHost ディレクトリ

次のディレクトリを使用すると、ステージング領域を使用して設定ファイルを構築し、ファイルで作業して、準備が整ったときにのみ有効にすることができます。

追加の conf.d ディレクトリ

Apache 設定で共通する追加部分があります。 これらのファイルをきれいに分離し、すべてのファイルを 1 つのディレクトリに格納しないようにするために、サブディレクトリを作成しました。

Dispatcher モジュール固有の構成ディレクトリ

Apache web サーバーは非常に拡張可能で、モジュールに多数の設定ファイルが含まれている場合は、デフォルトの設定ディレクトリを使用する代わりに、インストールの基本ディレクトリの下に独自の設定ディレクトリを作成することがベストプラクティスです。

ベストプラクティスが作成され、従われます。

モジュール設定ファイルディレクトリ

ステージングおよび有効なファームディレクトリ

次のディレクトリを使用すると、ステージング領域を使用して設定ファイルを構築し、ファイルで作業して、準備が整ったときにのみ有効にすることができます。

追加の conf.dispatcher.d ディレクトリ

Dispatcher ファームファイル設定のサブセクションである追加の要素があります。サブディレクトリが作成され、これらのファイルをきれいに分離でき、すべてのファイルを 1 つのディレクトリに格納できないようにします。

完全なフォルダー構造

AMS では、名前空間の問題、競合や混乱を避けるために、カスタムファイル拡張子を使用して各ファイルを構造化しています。

AMS のデフォルトデプロイメントの標準ファイルセットの例を次に示します。

/etc/httpd/``
├── conf``
│├── httpd.conf``
│└── magic
├── conf.d
│├── autoindex.conf
│├── available_vhosts
││ ├── 000_unhealthy_author.vhost
││├── 000_unhealthy_publish.vhost
││├── aem_author.vhost
││├── aem_flush.vhost
││├── aem_health.vhost
│   │   ├── aem_lc.vhost
│   │   └── aem_publish.vhost
│   ├── dispatcher_vhost.conf
│   ├── enabled_vhosts
.vhost
.vhost
.vhost
.vhost
│   ├── README│   ├── rewrites
│   │   ├── base_rewrite.rules
│   │   └── xforwarded_forcessl_rewrite.rules│   ├── userdir.conf
│   ├── variables│   │   └── ams_default.vars
│   ├── welcome.conf
│   └── whitelists│       └── 000_base_whitelist.rules
├── conf.dispatcher.d
│   ├── available_farms│   │   ├── 000_ams_author_farm.any
│   │   ├── 001_ams_lc_farm.any│   │   └── 999_ams_publish_farm.any
│   ├── cache
│   │   ├── ams_author_cache.any
│   │   ├── ams_author_invalidate_allowed.any
│   │   ├── ams_publish_cache.any
│   │   └── ams_publish_invalidate_allowed.any
│   ├── clientheaders
│   │   ├── ams_author_clientheaders.any
│   │   ├── ams_common_clientheaders.any
│   │   ├── ams_lc_clientheaders.any
│   │   └── ams_publish_clientheaders.any
│   ├── dispatcher.any
.any
.any
│   ├── filters
│   │   ├── ams_author_filters.any
│   │   ├── ams_lc_filters.any
│   │   └── ams_publish_filters.any
│   ├── renders
│   │   ├── ams_author_renders.any
│   │   ├── ams_lc_renders.any
│   │   └── ams_publish_renders.any
│   └── vhosts
│       ├── ams_author_vhosts.any
│       ├── ams_lc_vhosts.any
│       └── ams_publish_vhosts.any
├── conf.modules.d
│   ├── 00-base.conf
│   ├── 00-dav.conf
│   ├── 00-lua.conf
│   ├── 00-mpm.conf
│   ├── 00-proxy.conf
│   ├── 00-systemd.conf
│   ├── 01-cgi.conf
│   └── 02-dispatcher.conf
/var/log/httpd
/usr/lib64/httpd/modules
/run/httpd

理想的な状態の維持

Enterprise Linux には、Apache Webserver Package （httpd）のパッチ適用サイクルがあります。

インストール済みのデフォルトファイルの数が少ないほど、修正する方がよくなります。この理由は、パッチが適用されたセキュリティ修正または設定改善が RPM または Yum コマンドを介して適用された場合、変更されたファイルの上に修正が適用されないからです。

代わりに、.rpmnew ファイルがオリジナルの横に作成されます。  つまり、必要な変更が一部失われ、設定フォルダーにガベージが作成されている可能性があるということです。

Enterprise linux は、このユースケースをより適切に処理するために適切にセットアップされていました。  設定されたデフォルトを拡張または上書きできる領域が提供されます。  httpd のベースインストール内には、ファイル /etc/httpd/conf/httpd.conf があり、次のような構文が含まれています。

Include conf.modules.d/*.conf


IncludeOptional conf.d/*.conf

考え方としては、/etc/httpd/conf.d/file 拡張子を持つ新しいファイルを /etc/httpd/conf.modules.d/ および .conf  ディレクトリに追加する際にはモジュールと設定を拡張することを Apache が求めているということです。

Dispatcher モジュールを Apache に追加する際の最適な例として、モジュール .so ファイルを /etc/httpd/modules/ に作成したあと、ファイルを /etc/httpd/conf.modules.d/02-dispatcher.conf に追加して含め、その内容をモジュール .so ファイルに読み込みます。

LoadModule dispatcher_module modules/mod_dispatcher.so

Apache が提供した既存のファイルは変更されません。 あなたは、彼らが入るはずだったディレクトリにあなたのを追加しました。

これで、ファイル /etc/httpd/conf.d/dispatcher_vhost.conf でモジュールを使用するようになりました。これにより、モジュールが初期化され、初期モジュール固有の設定ファイルが読み込まれます。

<IfModule disp_apache2.c>

DispatcherConfig conf.dispatcher.d/dispatcher.any

...SNIP...</IfModule>

ここでも、ファイルとモジュールが追加されましたが、元のファイルは変更されていません。  これにより、必要な機能が提供され、必要なパッチ修正の欠落から保護されるだけでなく、パッケージのアップグレードごとに最高レベルの互換性が維持されます。