Procedimiento: Configuración del proveedor de caché de resultados AppFabric para ASP.NET (Almacenamiento en caché de AppFabric 1.1)

Artículo
03/05/2012

Este tema describe cómo configurar una aplicación web de ASP.NET para que utilice una caché AppFabric proporcionada para el almacenamiento en caché de resultados. La configuración se realiza modificando el archivo web.config file para la aplicación web de destino.

Utilizar Microsoft AppFabric 1.1 para el almacenamiento en caché de Windows Server para el almacenamiento en caché de resultados

Para que la aplicación web ASP.NET utilice el proveedor de almacenamiento en caché de resultados AppFabric, debe agregar los siguientes elementos al archivo web.config de la aplicación:

configSections: este debe ser el primer elemento del archivo de configuración, debajo de la etiqueta de apertura configuration. Es necesario para que los ensamblados Almacenamiento en caché de AppFabric funcionen.
dataCacheClients: este es un elemento secundario del elemento de configuración. Se utiliza para mantener los elementos dataCacheClient que configuran los clientes de caché y especifican los hosts de caché.
caching: este es un elemento secundario del elemento system.web. Contiene un elemento outputCache que especifica a la aplicación web que debería utilizar Microsoft AppFabric 1.1 para Windows Server para administrar los datos de almacenamiento en caché de resultados. El atributo cacheName especifica la memoria caché con nombre que se usará. El atributo dataCacheClientName especifica qué sección dataCacheClient se utilizará en la configuración de la caché.

Advertencia
Se recomienda proteger al archivo web.config que se usa para especificar los nombres de los hosts de caché.

Utilizar Microsoft AppFabric 1.1 para Windows Server para el almacenamiento en caché de resultados

En primer lugar, prepare el proyecto Visual Studio 2010 que se va a utilizar Microsoft AppFabric 1.1 para el almacenamiento en caché de Windows Server. Para obtener más información, consulte Preparación del entorno de desarrollo de clientes de caché (Almacenamiento en caché de AppFabric 1.1).
Además de los ensamblados de almacenamiento en caché normales, consulte también el ensamblado Microsoft.Web.DistributedCache.dll en la ruta de instalación Microsoft AppFabric 1.1 para el almacenamiento en caché de Windows Server.
Copie en el archivo web.config el elemento configSections del ejemplo que encontrará después de estos pasos. Asegúrese de que este elemento es el primero dentro de las etiquetas configuration.
Copie en el archivo web.config el elemento dataCacheClients del ejemplo que encontrará después de estos pasos. Se debe agregar después del elemento configSections, dentro del elemento configuration.
1. Configure los atributos name y cachePort de los elementos de host para que coincidan con los servidores de caché del entorno. Agregue o quite elementos de host según sea apropiado.
Copie en el archivo web.config el elemento caching del ejemplo que encontrará después de estos pasos. Debe estar situado dentro del elemento system.web. Especifique los atributos cacheName y dataCacheClientName así como cualquier otra opción de configuración requerida.

Determine la identidad de la aplicación web. Esto se puede realizar en el Administrador de IIS en los servidores web. Consulte la identidad del grupo de aplicaciones asociado a la aplicación web. Conceda a este usuario el acceso al clúster de caché mediante el comando Grant-CacheAllowedClientAccount de Windows Powershell.

Sugerencia
Si el grupo de aplicaciones se ejecuta como una cuenta integrada del equipo, por ejemplo "NT Authority\Servicio de red", debe conceder acceso al clúster de caché para ese equipo. Para ello, puede especificar DOMAINNAME\MACHINENAME$ como la cuenta. Tenga en cuenta que el signo "$" se agrega al nombre del equipo para indicar que es la cuenta del equipo.

Ejemplo

Este ejemplo muestra cómo configurar una aplicación web ASP.NET Web para el almacenamiento en caché de resultados en una caché distribuida denominada default. El cliente de caché de este ejemplo únicamente está configurado para comunicarse con un host de caché denominado CacheServer1.

En primer lugar, agregue el elemento configSections al archivo web.config como primer elemento del elemento 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>

En segundo lugar, agregue el elemento dataCacheClients único que contiene uno o más elementos dataCacheClient. Agréguelo al archivo web.config, tras el elemento configSections. Ahora es cuando se configura el cliente de caché para que satisfaga las necesidades de la aplicación. Para obtener más información, consulte Opción de configuración de la aplicación (Almacenamiento en caché de AppFabric 1.1).
```
  <dataCacheClients>
    <dataCacheClient name="default">
      <hosts>
        <host name="CacheServer1" cachePort="22233" />
      </hosts>
    </dataCacheClient>
  </dataCacheClients>
```
Después de agregar los elementos configSections y dataCacheClients, agregue el elemento caching al archivo web.config, dentro del elemento system.web. Ahora es cuando se especifica qué memoria caché usará la aplicación web para almacenar los datos de almacenamiento en caché de resultados. Personalice los atributos cacheName y dataCacheClientName, así como cualquier otra opción de configuración requerida.
```
    <caching>
      <outputCache defaultProvider="DistributedCache">
        <providers>
          <add name="DistributedCache"
               type="Microsoft.Web.DistributedCache.DistributedCacheOutputCacheProvider, Microsoft.Web.DistributedCache"
               cacheName="default"
               dataCacheClientName="default" />
        </providers>
      </outputCache>
    </caching>
```

Cuando finalice, el archivo web.config final de la aplicación web se parecerá al ejemplo siguiente.

<?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>

Vea también

Conceptos

Proveedor de caché de resultados (Almacenamiento en caché de AppFabric 1.1)

2012-03-05

Compartir vía