Sitecore blobsをAzure Blob Storageモジュールを有効にしてください

Sitecore PaaSにAzure Blob Storageモジュールをインストールしてください

Sitecore PaaSにAzure Blob Storageモジュールをインストールする方法は2通りです:

1. Sitecore Azureツールキットの活用:
   • Sitecore Azure Toolkitで新しいSitecoreインストールを使おう
2. Azure MarketplaceでSitecoreを使ってください(新規Sitecoreインストールのみ)

オンプレミスのSitecoreインスタンスにAzure Blob Storageモジュールをインストールしてください

オンプレミスのSitecoreインストールにAzure Blob Storageモジュールをインストールするには:

1. SitecoreダウンロードページからAzure Blob StorageモジュールWDPをダウンロードしてください。

2. コマンドプロンプトでWDPをインストールするにはMsDeployを使い、(このコマンドを実行するために使っているサーバーでmsdeploy.exeが利用可能であることを確認してください):

   "\msdeploy.exe" -verb

   -source
   ="" -dest
   ="" -setParam:"IIS Web Application Name"="" -setParam:"AzureStorageConnectionString"="" -setParam:"AzureStorageContainerName"="" -setParam:"DefaultProvider"="azure" -enableRule
   -verbose

   このコマンドはAzure Blob Storageモジュールをインストールし設定し、Sitecore ConnectionString.configファイルのAzure Storage接続文字列を更新するための必要なXML Document Transform(XDT)ファイルを準備します。

3. Nugetにアクセスしてください。そしてMicrosoft.Web.XmlTransform.dllファイルをダウンロードしてください。

4. Sitecore ConnectionString.configファイル内で、Azureストレージ接続文字列を更新するために以下のPowerShellコマンドを実行してください。

   function XmlDocTransform($xml, $xdt) { if (!$xml -or !(Test-Path -path $xml -PathType Leaf)) { throw "File not found. $xml"; } if (!$xdt -or !(Test-Path -path $xdt -PathType Leaf)) { throw "File not found. $xdt"; }

   $scriptPath = (Get-Variable MyInvocation -Scope 1).Value.InvocationName | split-path -parent Add-Type -LiteralPath "$scriptPath\Microsoft.Web.XmlTransform.dll"

   $xmldoc = New-Object Microsoft.Web.XmlTransform.XmlTransformableDocument; $xmldoc.PreserveWhitespace = $true $xmldoc.Load($xml);

   $transf = New-Object Microsoft.Web.XmlTransform.XmlTransformation($xdt); if ($transf.Apply($xmldoc) -eq $false) { throw "Transformation failed." } $xmldoc.Save($xml); }

   XmlDocTransform -xml "\App_Config\ConnectionStrings.config" -xdt "\App_Data\Transforms\AzureBlobStorageProvider\Xdts\App_Config\ConnectionStrings.config.xdt"

!注メディアアイテムを使用するすべての役割やウェブアプリケーションに対して、これらの手順を繰り返してください。

Azure Blob StorageモジュールをPaaSまたはオンプレミスで手動インストールしてください

SitecoreのインストールにAzure Blob Storageモジュールを手動でインストールするには:

1. SitecoreダウンロードページからAzure Blob StorageモジュールWDPをダウンロードしてください。

2. WDPを抽出(解凍)してください。

3. WDPのbinフォルダの内容をSitecoreウェブアプリケーションbinフォルダにコピーします。

4. WDPのApp_Configフォルダの内容をSitecoreウェブアプリケーションApp_Configフォルダにコピーします。

5. WDPのApp_Dataフォルダの内容をSitecoreウェブアプリケーションApp_Dataフォルダにコピーします。

6. SitecoreウェブアプリケーションのApp_Config\ConnectionStrings.configファイルに追加する以下の接続文字列です。

7. \App_Config\Modules\Sitecore.AzureBlobStorage\Sitecore.AzureBlobStorage.configファイルでは、<param name="containerName>が正しいコンテナを指していることを確認しましょう。Azure Blob Storageモジュールは、Content Management (CM)とContent Delivery(CD)の両方で共有ストレージを使用します。

!注メディアアイテムを使用するすべてのロールで手順を繰り返す必要があります。デフォルトでは、ロールはContent Management (CM)とContent Delivery (CD)ですが、ソリューション内で複数のCDロールが存在する場合もあります。

すべての設置で展開を検証する

あなたのデプロイメントが正しいかどうかを確認するために:

1. Content AuthorとしてSitecoreにログインしてください。
2. メディアファイルをアップロードして、正しくダウンロードでき、メディアアイテムとして正しく作成されているかを確認しましょう。
3. 新しく作成したメディアアイテムをウェブサイトのページに追加し、ページが正しくレンダリングされるようにしましょう(つまり、メディアリンクが壊れていない状態)。

デフォルトのプロバイダーを設定する

Sitecoreは複数のBlob Storageアカウントを並行して動作させることができます。各Sitecoreデータベースに、Blob Storageアカウントに対応したブロブ提供者のリストを設定できます。SitecoreはBlob IDを使ってBlob Storage内のそれぞれのブロブを特定し、Blob Storageアカウントから取得または削除します。ただし、新しいアップロードにはデフォルトのブロブプロバイダーを設定する必要があります。

Azure Blob Storageモジュールをインストールすると、事前に設定されたデフォルトプロバイダーはAzure Storage Blob Providerです。ただし、必要に応じてデフォルトのプロバイダーをClassicSqlBlobProviderに戻すことができます。

デフォルトのプロバイダーを元の提供者に戻すにはClassicSqlBlobProvider:

• App_Config\Modules\Sitecore.AzureBlobStorage\Sitecore.AzureBlobStorage.configファイルを以下のように更新してください:

!重要上記の例はマスターデータベースの設定ファイルの変更のみを示しています。ただし、設定BlobStorageすべてのデータベースについては変更しなければなりません。

Configure the AzureStorageBlobProvider provider

AzureStorageBlobProviderプロバイダーはページリストプロバイダーパターンを使って、メディアアイテムSitecore使用するブロブIDを取得します。また、Timeout、サーキットブレーカーパターン、指数再試行パターンも用いて一時的なエラーを処理します。AzureStorageBlobProviderプロバイダーがこれらのデフォルト設定を持っていても、設定やパラメータを変更することでAzureStorageBlobProviderプロバイダーをカスタマイズできます。利用可能なパラメータについては以下の表を参照してください:

表1.AzureStorageBlobProviderのパラメータ

パラメータ

概要

connectionStringName

(必須) App_Config\ConnectionStrings.config ファイルの接続文字列の名前。

usedBlobIdsPagedListProvider

(必須)Sitecore Mediaのアイテムがページごとに使用するブロブIDを取得するメソッドを提供します。同じタイプのカスタムクラスを以下で実装できます。 Sitecore.Framework.Data.Blobs.Abstractions.IPagedListProvider

pageSize

(任意)ページごとにブロブIDを取得する際のページ上の最大ページアイテム数。ページあたりのアイテムのデフォルト値は以下の通りです: 5000

logger

(任意)エラーをログするプロバイダーメソッド。同じタイプのカスタムクラスを実装するには Sitecore.Framework.Data.Blobs.Abstractions.ILogger。デフォルト値は次の通りです: null

containerName

(任意)Azure Blob Storage内のブロブコンテナの名前。デフォルト値は: blobcontainer。

maxRetryAttempt

(任意)一時的なエラーが発生した場合に許される最大再試行回数。デフォルト値は次の通りです: 5

deltaBackOff

(任意)一時的なエラーが発生した場合、これはリトライ間の秒数(バックオフ時間の長さ)です。デフォルト値は次の通りです: 4

maxExecutionTime

(任意)リクエストを実行するための最大秒数(再トライを含む)です。デフォルト値は以下の通りです: 30

exceptionsAllowedBeforeBreaking

(任意)一時的な誤差が1 maxRetryAttemptを超えた場合に回路ブレーカーが切れるまでに許される例外回数。デフォルト値は以下の通りです: 1

durationOfBreakInMinutes

(任意)デフォルト値は以下の通りです: 1