Migrar do cache do AppFabric para o Cache na Função do Azure

Importante

A Microsoft recomenda que todos os novos desenvolvimentos usem o Cache Redis do Azure. Para obter documentação e diretrizes atuais sobre como escolher uma oferta de Cache do Azure, confira qual oferta do Cache do Azure é ideal para mim?

Este tópico descreve como migrar do Microsoft AppFabric 1.1 para Windows Server para Microsoft Azure Cache. Esse tipo de migração de cache pode ocorrer quando você move um aplicativo local para o Azure.

O AppFabric oferece suporte a clusters de cache no local que usam os seus próprios servidores e infraestrutura de rede. A mudança para o Azure é facilitada pelo fato de que a maioria dos recursos e o modelo de programação do AppFabric são compartilhados com Microsoft Azure Cache.

Planeje a migração

Antes de migrar seu aplicativo habilitado para cache para a nuvem, primeiro examine as diferenças entre AppFabric e Microsoft Azure Cache. Se você precisar de um recurso, como o write-through, que não esteja disponível no Cache Microsoft Azure, deverá reprojetar essa parte da sua solução para migrar com êxito para o Azure.

Analise o cluster de cache do AppFabric.

Todos os caches e suas configurações relevantes devem ser recriados em uma função do Azure habilitada para cache. O primeiro passo é analisar o cluster de cache do AppFabric para compreender a configuração atual no local.

  1. No cluster de cache do AppFabric, abra um prompt de comando Windows PowerShell de Administração de Cache.

  2. Execute o comando Get-Cache sem parâmetros. Isso listará os caches nomeados.

  3. Para cada cache listado, execute o comando Get-CacheConfig . Passe o nome do cache como um argumento para esse comando. Registre os parâmetros de configuração de cada cache. É mostrado a seguir um exemplo dessa saída.

    PS C:\Windows\system32> Get-CacheConfig TestCache
    
    CacheName                : TestCache
    TimeToLive               : 20 mins
    CacheType                : Partitioned
    Secondaries              : 0
    MinSecondaries           : 0
    IsExpirable              : True
    EvictionType             : None
    NotificationsEnabled     : True
    WriteBehindEnabled       : False
    WriteBehindInterval      : 300
    WriteBehindRetryInterval : 60
    WriteBehindRetryCount    : -1
    ReadThroughEnabled       : False
    ProviderType             :
    ProviderSettings         : {}
    
  4. Execute o comando Get-CacheHost para ver uma lista de hosts de cache no cluster de cache.

  5. Para cada host de cache, execute o comando Get-CacheHostConfig . Passe os argumentos necessários: o nome do host de cache e a porta de cache (geralmente 22233). Registre o parâmetro Size de cada host de cache.

  6. Some os valores Size de todos os hosts de cache para determinar o tamanho total do cluster de cache.

Recriar o cluster de cache em um projeto de serviços de nuvem

Aviso

Não há suporte para instalar o AppFabric e o SDK do Azure no mesmo computador de desenvolvimento. Essas etapas pressupõem que você esteja usando computadores separados ou que desinstale completamente o AppFabric antes de instalar o SDK do Azure.

Em Visual Studio criar um serviço de nuvem ou abrir um serviço de nuvem existente. Adicione uma Função de Trabalho de Cache ao serviço de nuvem. Para obter mais informações, consulte Hospedagem do Cache de In-Role do Azure em Funções Dedicadas. Essa função fornecerá recursos de cache para todo o serviço de nuvem. As etapas a seguir descrevem como recriar os caches nomeados.

  1. Em Visual Studio, vá para a janela Gerenciador de Soluções.

  2. Na pasta Funções , clique duas vezes na função que hospeda o cache.

  3. Na caixa de diálogo de propriedades da função, selecione a guia Cache.

  4. Em Configurações do Cache Nomeado, primeiramente modifique o cache padrão para corresponder às configurações de cache padrão no cluster de cache do AppFabric. Em seguida, use o link Adicionar Cache Nomeado para adicionar outros caches que possam ser exigidos pela sua solução. A tela a seguir mostra vários caches nomeados configurados.

    Caching Properties for Named Caches

  5. Use o para criar ou reutilização de uma conta de armazenamento. Essa conta deve ser usada no campo de conta de armazenamento da guia Cache para implantações na nuvem.

A tabela a seguir correlaciona a saída de Get-CacheConfig às configurações na janela de cache.

Configuração Get-CacheConfig Configuração da janela de cache

CacheName

Nome

timeToLive

Vida útil (min)

Secundários (0, 1)

Alta Disponibilidade (0 = não selecionado, 1 = selecionado)

É Expirável (Verdadeiro, Falso)

Tipo de Expiração (Verdadeiro = Absoluta, Falso = Nenhuma)

Tipo de Remoção (Nenhum, LRU)

Política de Remoção (Nenhum, LRU)

Notificações Ativas (Verdadeiro, Falso)

Notificações (Verdadeiro = marcado, Falso = desmarcado)

Observação

Não há suporte para as configurações de cache appFabric que não estão listadas aqui no Cache Microsoft Azure.

Para configurar o tamanho do cluster de cache, é necessário entender a relação entre o tamanho da máquina virtual e o número de instâncias dessa função em execução. Para obter mais informações, consulte Considerações de planejamento de capacidade para o Cache de In-Role do Azure.

Migrar o código do aplicativo

A etapa final é mover qualquer código do aplicativo para os projetos de serviço de nuvem. Observe que o namespace e muitas APIs permanecem idênticos. As etapas a seguir fornecem diretrizes de migração para cada projeto que requer cache.

  1. No projeto Visual Studio, primeiro remova todas as referências aos assemblies AppFabric.

  2. Em seguida, faça backup das seções dataCacheClient do arquivo web.config ou app.config.

  3. Remova o dataCacheClient e outras seções de cache do arquivo web.config ou app.config.

  4. Em seguida, prepare o projeto para usar Microsoft Azure Cache. Para obter mais informações, consulte Como preparar Visual Studio para usar o Cache de In-Role do Azure.

  5. Em seguida, adicione manualmente as seções dataCacheClient removidas de volta ao arquivo web.config ou app.config. As seguintes alterações deverão ser feitas nessas seções:

    • Adicione um elemento autoDiscover a cada seção. O atributo do identificador deve referenciar o nome da função que hospeda o cache.

      <autoDiscover isEnabled="true" identifier="[cache cluster role name]" />
      
    • Remova todos os hosts, host e elementos securityProperties . Eles são desnecessários e sem suporte no Cache Microsoft Azure.

Consulte Também

Conceitos

Migrar do cache compartilhado do Azure para cache na função