ステージ環境から公開環境へのデータのコピー・転送

※ この機能はプロフェッショナル版以上のライセンスをご購入の場合のみご利用可能です

管理画面(以下 CMS)で生成された静的ファイルをステージ環境、公開環境へコピーする機能です。また、公開環境へのコピーの際に FTP/FTPS/SFTP 転送によりリモートサーバに転送することが可能です。このプラグインを利用することにより、承認フロー→ステージ環境でのテスト公開→公開環境への反映、といったワークフローを実現することができます。

• 静的生成されたファイルの転送・同期を行うため、コミュニケーション機能 (コメント/トラックバック/フォーム機能) や検索機能がそのままでは利用できないことに注意してください。
• ファイルのコピーや削除、リモートサーバへのアクセスを伴うため、プラグインのインストール後には必ず設定を行ってください。また、運用の前に十分なテストを行ってください。
• ステージ環境、公開環境でのリンク切れを防ぐため、Abs2Rel プラグイン (リンクを相対パスに変換) をあわせて有効にしてください。
• コンテンツのファイルは ZIP アーカイブして FTP サーバに転送され、展開ツールによって解凍、配置が行われるため、転送先サーバで以下が可能である必要があります。
  • Perl モジュール Archive::Zip がインストールされていること
  • Perl モジュール Archive::Zip を使ってアーカイブを展開する Perl スクリプトを設置し、実行できること
  • アーカイブの展開を行い、ファイルの配置を行うスクリプトを cron またはタスクスケジューラによって定期的に実行することができること

よりセキュアな転送を行うために

よりセキュアな FTPS 転送、ユーザー名とパスワードでの認証による SFTP 転送に対応しています。これらをご利用いただくには、上記に加え、下記の条件を満たす必要があります。

Windows サーバからの SFTP 転送には対応していません。

• FTPS 転送を行う場合、Net::FTPSSL がインストールされている必要があります
• SFTP 転送を行う場合、以下のいずれかを満たす必要があります
  • Perl モジュール Net::SFTP がインストールされ、Net::SFTP::Foreign::Constants 、Net::SFTP::Foreign::Buffer が利用可能であること
  • Perl モジュール Net::SFTP::Foreign および IO::Pty がインストールされていること
• SFTP 転送を行う場合、転送先サーバに /sbin/.ssh が生成できる必要があります

同期する対象ファイルの判別について

同期するファイルについては CMS 環境の公開パス以下のファイル、ステージ環境以下のファイル、公開環境以下のファイルそれぞれのファイルのタイムスタンプ (更新日時) を比較し、同期先のファイルより同期元のファイルの方が新しい場合に同期対象となります。また、同期先に存在し、同期元に存在しないファイルは同期先から削除されることに注意してください。

何らかのエラーにより同期処理が途中で終了してしまった場合などは、同期先のファイルを一度クリアするか手動で同期を行ってから再度処理を実行してください。

環境変数

同期に関する設定

設定は各ウェブサイト/ブログの [設定] 内 [プラグイン] 内 [Copy2Public] の設定で行います。

/var/www/cms/mt/
/var/www/cms/templates_c/
/var/www/cms/mt/cache/

/var/www/htdocs/cgi/
/var/www/htdocs/cms/

転送の実行について

転送はウェブサイト/ブログごとに行います。「同期」メニューから「ステージ環境に同期」または「公開環境に同期」を選択して実行します。同期の実行にはそれぞれに対応する権限が必要です。

今すぐ同期を実行する場合は「今すぐ実行する」を、日時を指定して同期予約をする場合には「日時を指定」を選択して実行日時を指定します。日時を指定した場合、同期は指定した日時を経過後の最初のスケジュールタスクで処理されます。

日時を指定する場合、同期予約を管理するためのラベルと、実行時にメール通知するための通知先メールアドレスを設定することができます。

「次へ」を押すとウェブサイト/ブログ公開パス以下のアイテムのリストが表示されますので、同期する対象をチェックします。リンク切れ等を防ぐために通常は全てにチェックを入れてください (すべてにチェックを入れた場合にも同期は常に差分ファイルのみが対象になります)。

※ 同期実行の前にはユーザー名とパスワードの入力を求められますが、環境変数 AllowCopy2PublicDirectSync 1 を指定している場合は認証なく実行することができます。

リモートサーバでのファイルの同期について

リモートサーバにアップロードした ZIP アーカイブを、リモートサーバーに設置した Perl スクリプトの実行によって公開パスに展開・配置することができます (options/tools/do-synchronize、以下 do-synchronize スクリプト)。do-synchronize スクリプトはアップロードされたログファイルを確認して公開パスへの反映を行います。公開サーバーで cron やタスクスケジューラに設定してください。

do-synchronize スクリプトでは、リモートサーバに転送されたログを見て配置するファイル・削除するファイルを判断します。ログが転送されるのは ZIP アーカイブがアップロードされた後ですので、リモートサーバへの転送が途中でエラーとなった場合などに意図しない状態でサイトが公開されることを防ぐことができます。

crontab への登録の例 (20分おきのタスク実行)

0,20,40 * * * * /usr/bin/perl /var/www/cgi-bin/do-synchronize

do-synchronize スクリプト設置の際には、テキストエディタ等で以下の項目を設定してください。

my $backup_dir = '';

my $sync_log = '';

予約された同期タスクの確認

「ツール」メニューから「同期タスクの管理」を選択することで、予約された同期タスクの一覧を表示することができます。タスクを取り消すには対象のタスクを選択して「削除」ボタンをクリックしてください。

FTP でのファイル転送について

テストスクリプトでの実行チェック

$MT_DIR/tools/ftp-test.pl を実行すると、指定したファイルをアップロードするテストを行うことができます。実行前にテキストエディタ等で以下の項目を設定してください。

※ 値は引用符で囲み、行の最後に ; を入力してください

FTPS でのファイル転送について

環境変数の設定

FTPS での転送を行う場合、以下の環境変数を設定してください。

SFTP でのファイル転送について

ユーザー名とパスワードでの認証による SFTP 転送に対応しています。ご利用にあたっては、冒頭の「よりセキュアな転送を行うために」に記載の内容が満たされているかご確認ください。

テストスクリプトでの実行チェック

$MT_DIR/tools/sftp-test.pl を実行すると、指定したファイルをアップロードするテストを行うことができます。実行前にテキストエディタ等で以下の項目を設定してください。

環境変数の設定

SFTP 転送を行う場合、以下の環境変数を設定してください。