SiteSync

プラグインの特徴

SiteSync は、転送元（ステージング側）と 転送先（公開側）の間でファイルを同期するプラグインです。
Movable Typeが出力したファイルだけでなく、同じ公開領域にあるその他のファイルも同期対象に設定できます。
rsync/SSH、FTP/FTPS、AWS S3 同期方式が選択可能です。
同期の際は除外設定や文字列置換をする機能を備えています。

SiteSync は 2つの製品に分かれています。本文中の表記はそれぞれの製品を指します。

• MTP8: Movable Type Premium 8 のみに対応している機能
  
• MTP7: Movable Type Premium 7 のみに対応している機能

同期方式 は 3つに分かれています。本文中の表記はそれぞれのプロトコル設定を指します。

• rsync/SSH: rsync/SSH の利用で設定が必要な機能
  
• FTP/FTPS: FTP/FTPS の利用で設定が必要な機能
  
• AWS S3: AWS S3 の利用で設定が必要な機能

製品別の差異については機能比較を参照してください。

更新履歴

• [8.04]
  • Movable Type クラウドで AWS S3 配信が出来るようになりました。AWS S3
• [8.01]
  • Movable Type クラウドで SSH 配信（rsync/SSH）が出来るようになりました。MTP8
  • 同期を定期実行できるようになりました。MTP8
  • S3 に同期する際に IAM ロールで同期できるようになりました。MTP8
  • 同期時のメール通知のメールテンプレートをカスタマイズできるようになりました。MTP8
  • 同期時のメール通知を複数設定できるようになりました。MTP8
  • プロトコルが FTP の場合、ポート番号を指定できるようになりました。MTP8
  • プラグイン設定を他のサイト/子サイトへ読み込みができるようになりました。MTP8

プラグイン利用開始前の初期設定

SiteSyncのご利用前の初期設定は以下の通りです。

クイックスタート

SiteSync で同期するには、転送先（公開側）と転送元（ステージング側）の両方を準備します。システム管理者権限で操作を行なってください。

• rsync/SSH で始める高速／選択ファイル同期 [おすすめ]
• RFTP/FTPS で始めるレガシー・制約下で
• AWS S3 で始める 静的ホスティング／CDN 併用

rsync/SSH で始めるrsync/SSH

1. 転送先の設定
2. 転送元の設定
3. プラグインの設定
4. 同期の実施

FTP/FTPS で始めるFTP/FTPS

1. 転送先の設定
2. 転送元の設定
3. プラグインの設定
4. 同期の実施

AWS S3 で始めるAWS S3

1. 転送先の設定
2. 転送元の設定
3. プラグインの設定
4. 同期の実施

転送先サーバーの設定

転送先（公開側）は、サイト／子サイトの設定で選んだ プロトコルで 転送元から接続を受けられる状態にしておきます。

rsync and SSHで接続する場合rsync/SSH

1. プロトコルデーモンの設定
   SSHで接続できるよう、sshdが動作するようにしてください。
2. ユーザーの追加
   同期処理を行うためのSSH接続可能な同期処理用のユーザアカウントを作成してください。通常アカウントを使う事も可能ですが、セキュリティ上の問題から、専用のユーザアカウントを作る事をお勧めします。
3. 鍵認証の登録
   転送元サーバーで利用する秘密鍵とペアになるよう公開鍵を設定してください。
   ※ 秘密鍵はパスフレーズのないものをご利用ください。パスフレーズ付きの秘密鍵には対応しておりません。

FTP/FTPSで接続する場合FTP/FTPS

1. FTP/FTPSサーバーの設定
   FTP/FTPSで接続できるよう、FTP/FTPSサーバーを設定して下さい。
2. ユーザーの追加 / パスワード
   同期処理を行うためのFTP/FTPS接続可能な同期処理用のユーザアカウントを作成してください。通常アカウントを使う事も可能ですが、セキュリティ上の問題から、専用のユーザアカウントを作る事をお勧めします。

AWS S3で接続する場合AWS S3

配信先S3（バケット）の準備及びアクセスキー、シークレットアクセスキーをAWS管理画面より設定してください。

転送元サーバーの設定

転送元（ステージング側）は、転送先（公開側）に接続・送信できるように、必要な設定を行います。
ここでの設定が正しく整っていないと、後続の「プラグイン設定」「同期タスク」が失敗し、原因切り分けが困難になります。
先に「転送先サーバーの設定」を完了し、書き込み権限・パス・ネットワーク到達性を確認しておいてください。

rsync and SSHで接続する場合rsync/SSH

SSHを利用して接続を行う場合は、転送元サーバーで、ssh及びrsyncコマンドが利用できるよう設定されている必要があります。

Movable Type クラウドでrsync and SSHで接続する場合

転送元サーバーで秘密鍵が必要になります。FTPSで Movable Type クラウドにアクセスし、/secret に秘密鍵を設置すると、/data/secret ディレクトリ内に同期されます。転送先サーバーに登録されている公開鍵とペアになるよう秘密鍵を設定してください。

転送先サーバーの設定によっては、SSHオプションの設定項目に、対話プロンプトを回避する以下の設定が必要になる場合があります。

FTP/FTPSで接続する場合FTP/FTPS

FTP/FTPSを利用して接続を行う場合は、転送元サーバーで、FTP/FTPS接続及び転送が出来るように設定されている必要があります。

AWS S3 で接続する場合AWS S3

• Movable Type 動作環境内に、AWS CLI が導入されている事が必要になります。
• Movable Type 実行ユーザから、AWS CLI を実行するための適切なPATHや権限の設定が必要です。

[アクセスキー][シークレットアクセスキー] が入力されていない場合は、IAM Roleを利用するようになっています。

ユーザーのロールに同期を行う権限を設定する

同期設定及び同期を行う場合、そのユーザーに設定されている［ロール］の［権限］に、［同期処理］内の［コンテンツの同期］が設定されている必要が有ります。権限が付与されていない場合には、同期設定、コンテンツの同期は行う事が出来ません。また、コンテンツを同期へのリンクも表示されません。

ユーザーの権限及びロールについて詳しくはMovable Typeのマニュアルをご覧下さい。
Movable Type 7 Manual

システムからプラグインの設定をする

システムからのSiteSync設定では、作業領域とログの設定、メール通知設定を行う事が出来ます。

1. システムダッシュボードのナビゲーションから［設定］をクリックし、サブメニューから［プラグイン］をクリックします。
2. ［SiteSync］をクリックし、［設定］をクリックします。
3. ［SiteSync］の設定画面が表示されるので、必要項目を入力・設定し、［変更を保存］ボタンをクリックします。

   

システムのSiteSync設定項目

システムからのSiteSync設定では、以下の設定項目を設定することが出来ます。

サイト/子サイトからプラグインの設定をする

サイト/子サイトからのSiteSync設定では、サイト/子サイトでのそれぞれの同期設定を行う事が出来ます。

1. サイト/子サイトのナビゲーションから ［設定］をクリックし、サブメニューから ［プラグイン］をクリックします。
2. ［SiteSync］をクリックし、［設定］をクリックします。
3. ［SiteSync］の設定画面が表示されるので、必要項目を入力し、［変更を保存］ボタンをクリックします。

   

サイト/子サイトのSiteSync設定項目

サイト/子サイトからのプラグイン設定では、以下の設定項目を設定することが出来ます。

同期タスクを作成する

設定が完了する事で、コンテンツの同期を行う為の、同期タスクの作成が出来る様になります。同期タスクの作成画面には以下の手順で移動する事が出来ます。

1. サイトダッシュボード、子サイトダッシュボードのナビゲーションから ［同期］をクリックし、サブメニューから［同期タスクの作成］をクリックします。
2. ［同期タスクの作成］の画面が表示されますので、右側の［同期設定］の内容を確認し、左側から、［同期対象］、［実行方法］、［同期する日時］を設定し、［同期する］ボタンをクリックします。

   

3. 同期タスクの作成 - 同期対象の図解

   

   • 親サイトで「このサイトのみ」を選んで同期すると、同期されるのは親サイトが管理しているページやファイル（画像・PDFなど）だけになります。
   • 配下の子サイトの内容や、同じ階層にある別の親サイトが出力したファイルは同期対象になりません。
     例：親サイトAで実行した場合、Aのページ・画像・PDFだけが同期され、子サイトBや別の親サイトCの出力物は同期されない。

   

   

4. 2で設定した内容で同期タスクが登録されます。

同期タスクの作成画面と項目

右カラムは［同期設定］となります。ここには［サイト/子サイトからプラグインの設定をする］で行った設定内容の一部が表示されます。

左カラムは［同期タスクの設定］となります。コンテンツ同期を行うタスク設定として、［同期対象］、［実行方法］、［同期する日時］を設定し、同期タスクを登録します。右カラムで表示されている［同期設定］を、左カラムで行う［同期タスクの設定］の内容で、［同期タスク］を作成するという形になります。

同期タスクの管理をする

作成・登録した同期タスクは、同期タスクの管理画面で状態を確認する事が出来ます。同期タスクの管理画面には以下の手順で移動する事が出来ます。

1. サイトダッシュボード、子サイトダッシュボードのナビゲーションから［同期］をクリックし、サブメニューから［一覧］をクリックします。
2. 同期タスクの管理画面が表示されます。

   

同期タスクの一覧管理画面と項目

同期タスクの管理画面と項目についてご説明します。

同期タスクの管理画面では、登録されている同期タスクが一覧表示されます。
また、同期タスクの状態を確認したりする事が出来ます。

同期タスクの実行方法と同期処理について

ここでは、同期タスクの［実行方法］について、詳細と処理内容のご説明をします。

同期タスクの実行方法が［手動で同期する］の場合

［同期タスクの作成］の設定で［実行方法］が［手動で同期する］の場合には、Movable Typeの定期実行タスクを処理する run-periodic-tasks スクリプトが同期タスク設定後最初に起動/実行するタイミングで同期されます。自動で処理が行われるようにするには、予め、crontab に run-periodic-tasks スクリプトをスケジュール設定しておく必要が有ります。

同期タスクの実行方法が[日時を指定して同期する］の場合

［同期タスクの作成］の設定で［実行方法］が［日時を指定して同期する］の場合には、Movable Typeの定期実行タスクを処理する run-periodic-tasks スクリプトが公開および非公開時刻後 最初に起動/実行するタイミングで同期されます。自動で処理が行われるようにするには、予め、crontab に run-periodic-tasks スクリプトをスケジュール設定しておく必要が有ります。（詳しくはMovable Type製品別マニュアルの設定方法をご確認下さい）
また、以下の条件を満たす場合には同期タスク[日時を指定して同期する]が自動で作成されます。

• 記事もしくはウェブページを日時指定公開および指定日非公開で登録をする
• 登録された記事もしくはウェブページが紐づくサイトもしくは子サイトにSiteSyncの設定がされている

同期の定期実行MTP8

同期を定期的に自動実行することができます。自動実行する場合は crontab に run-periodic-tasks スクリプトをスケジュール設定しておく必要が有ります。

メール通知についてMTP8MTP7

メール通知機能が有効の場合、同期処理完了後には、同期処理が行われた事とその処理結果がメールで送信されます。
送信先は、プラグインの設定項目の ［メール通知］で指定したメールアドレスです。
宛先が指定されていない場合には、同期処理を行ったサイトの管理者に送信されます。処理がスキップされた場合は送信されません。

バージョンの差分として、MTP8は、メール通知機能はサイト/子サイト単位で設定でき、通知先のメールアドレスはカンマ区切りで複数設定できます。 MTP7は通知先の複数指定は対象外です。

メール通知テンプレートMTP8

メール通知のテンプレートは、システム > グローバルテンプレート内の [SiteSync からの通知] がメールテンプレートです。
メール通知のテンプレートサイト/子サイト毎に設定できます。

メール通知テンプレートはテンプレートモジュールで作成し、テンプレート名を [SiteSync Notification] としてください。子サイトにテンプレートがなければ親サイト、親サイトにテンプレートがない場合はシステムのテンプレートに沿ってメール通知をおこないます。

SiteSync - ウェブサイト/ブログの同期完了通知
【<$mt:BlogName$>】の<mt:if name="type_name" eq="MANUAL">手動同期<mt:elseif name="type_name" eq="SCHEDULE">スケジュール同期<mt:else>コマンドラインから同期</mt:if>が実行されました。

実行者: <$mt:var name="user_name"$>( <$mt:var name="user_id"$> )
指定日時: <$mt:var name="time_create"$>
開始時間: <$mt:var name="time_start_sync"$>
終了時間: <$mt:var name="time_end_sync"$>

内容：
<$mt:var name="message"$>

※詳細は同期ログまたはMovableTypeのログを参照してください。

テンプレートの一行目がメールの件名として通知されます。

機能比較

注1：AWS S3 はアクセスキー／シークレットキー運用で利用可。IAMロール同期は MTP8のみ対応。
注2：rsync/SSH 利用時のみ。FTP／FTPS、 AWS S3 では非対応。