Инструкция по настройке поставщика кэша вывода AppFabric для ASP.NET (кэширование в AppFabric 1.1)

Статья
03/05/2012

В этом разделе описывается настройка веб-приложения ASP.NET, использующего подготовленный кэш AppFabric для кэширования вывода. Настройка производится путем изменения файла web.config веб-приложения.

Использование Кэш Microsoft AppFabric 1.1 для Windows Server для кэширования вывода

Чтобы веб-приложение ASP.NET могло использовать поставщик кэша вывода AppFabric, следует добавить в файл web.config приложения следующие элементы:

configSections: этот элемент должен стоять первым в файле конфигурации сразу после открывающего тега configuration. Он необходим для работы сборок Кэш AppFabric.
dataCacheClients: данный элемент является дочерним по отношению к элементу "configuration". Он используется для хранения элементов dataCacheClient, служащих для настройки клиента кэша и указания узлов кэша.
caching: данный элемент является дочерним по отношению к элементу system.web. Он содержит элемент outputCache, указывающий, что веб-приложение должно использовать Microsoft AppFabric 1.1 для Windows Server для управления данными в кэше вывода. Атрибут cacheName задает используемый для этого именованный кэш. Атрибут dataCacheClientName указывает, какой раздел dataCacheClient используется для настройки кэша.

Предупреждение

Настоятельно рекомендуется обеспечить безопасность файла web.config, используемого для задания имен узлов кэша.

Использование Microsoft AppFabric 1.1 для Windows Server для кэширования вывода

Сначала подготовьте проект Visual Studio 2010 к использованию Кэш Microsoft AppFabric 1.1 для Windows Server. Дополнительные сведения см. в разделе Подготовка среды разработки клиента кэша (кэширование в AppFabric 1.1).
Помимо обычных сборок кэша, также добавьте ссылку на сборку Microsoft.Web.DistributedCache.dll по пути установки Кэш Microsoft AppFabric 1.1 для Windows Server.
Скопируйте элемент configSections из приведенного в конце статьи примера в свой файл web.config. Этот элемент должен быть первым среди всех элементов в тегах configuration.
Скопируйте элемент dataCacheClients из приведенного в конце статьи примера в свой файл web.config. Он должен стоять после элемента configSections внутри элемента configuration.
1. Настройте атрибуты name и cachePort в элементах узлов в соответствии с конфигурацией серверов кэша в конкретной среде. При необходимости можно добавлять и удалять элементы узлов.
Скопируйте элемент caching из приведенного в конце статьи примера в свой файл web.config. Его следует поместить внутрь элемента system.web. Укажите атрибуты cacheName и dataCacheClientName, а также прочие необходимые параметры.
Определите удостоверение веб-приложения. Это можно сделать в диспетчере IIS на веб-серверах. Посмотрите на удостоверение пула приложений, связанного с веб-приложением. Предоставьте этот пользовательский доступ кластеру кэша с помощью команды Grant-CacheAllowedClientAccount Windows Powershell.

Совет

Если пул приложений запускается под встроенной учетной записью компьютера, например "NT Authority\Network Service", то следует предоставить доступ к кластеру кэша для этого компьютера. Это можно сделать, указав в качестве учетной записи DOMAINNAME\MACHINENAME$. Следует отметить, что "$" добавляется к имени компьютера, чтобы указать, что это учетная запись компьютера.

Пример

В этом примере демонстрируется настройка веб-приложения ASP.NET с использованием клиента кэша для сохранения данных кэша вывода в распределенном кэше default. Клиент кэша в этом примере настроен так, чтобы взаимодействовать только с одним узлом кэша — CacheServer1.

Сначала добавьте элемент configSections в файл web.config, сделав его первым элементом в элементе configuration:

  <!--configSections must be the FIRST element -->
  <configSections>
    <section name="dataCacheClients"
             type="Microsoft.ApplicationServer.Caching.DataCacheClientsSection, Microsoft.ApplicationServer.Caching.Core"
             allowLocation="true" allowDefinition="Everywhere"/>
  </configSections>

Во-вторых, добавьте один элемент dataCacheClients с элементами dataCacheClient. Добавьте его в файл web.config после элемента configSections. Именно здесь клиент кэша можно настроить в соответствии с потребностями конкретного приложения. Дополнительные сведения см. в разделе Параметры конфигурации приложения (кэширование в AppFabric 1.1).
```
  <dataCacheClients>
    <dataCacheClient name="default">
      <hosts>
        <host name="CacheServer1" cachePort="22233" />
      </hosts>
    </dataCacheClient>
  </dataCacheClients>
```
После добавления элементов configSections и dataCacheClients добавьте элемент caching в файл web.config, расположив его внутри элемента system.web. Здесь можно указать кэш, который веб-приложение будет использовать для хранения данных кэша вывода. Настройте атрибуты cacheName и dataCacheClientName, а также прочие необходимые параметры.
```
    <caching>
      <outputCache defaultProvider="DistributedCache">
        <providers>
          <add name="DistributedCache"
               type="Microsoft.Web.DistributedCache.DistributedCacheOutputCacheProvider, Microsoft.Web.DistributedCache"
               cacheName="default"
               dataCacheClientName="default" />
        </providers>
      </outputCache>
    </caching>
```

После выполнения всех действий итоговый файл web.config веб-приложения будет похож на следующий пример.

<?xml version="1.0"?>

<configuration>
  <configSections>
    <section name="dataCacheClients"
             type="Microsoft.ApplicationServer.Caching.DataCacheClientsSection, Microsoft.ApplicationServer.Caching.Core"
             allowLocation="true" allowDefinition="Everywhere"/>
  </configSections>

  <dataCacheClients>
    <dataCacheClient name="default" channelOpenTimeout="10000">
      <hosts>
        <host name="CacheServer1" cachePort="22233" />
      </hosts>
    </dataCacheClient>
  </dataCacheClients>
  
  <system.web>
    <caching>
      <outputCache defaultProvider="DistributedCache">
        <providers>
          <add name="DistributedCache"
               type="Microsoft.Web.DistributedCache.DistributedCacheOutputCacheProvider, Microsoft.Web.DistributedCache"
               cacheName="default"
               dataCacheClientName="default" />
        </providers>
      </outputCache>
    </caching>
  </system.web>
</configuration>

См. также

Основные понятия

Поставщик кэша вывода (кэширование в AppFabric 1.1)

2012-03-05

Поделиться через