Lição 2: implantando o fluxo de trabalho do HRApplicationServices

Artigo
12/05/2011

Objetivo: Aprenda como definir as configurações de um projeto de serviços de fluxo de trabalho no Visual Studio e criar o pacote de implantação (um arquivo *.zip). Depois, usar a ferramenta de gerenciamento do IIS (Internet Information Services) para implantar o pacote no IIS.

Finalidade: A implantar um aplicativo que inclua os serviços do WCF e/ou do WF.

Pré-requisitos

Observe os seguintes pré-requisitos Antes de começar esta lição:

Instale e configure o AppFabric. Para obter mais informações, consulte Lição 1: introdução.
Você deve instalar os arquivos do tutorial. Para obter mais informações, consulte Lição 1: introdução.

Criando um pacote de implantação

Para configurar os valores de implantação no Visual Studio

Abra o Visual Studio 2010 e execute-o como administrador. No menu Iniciar, clique em Todos os Programas, abra a pasta Visual Studio 2010, clique com o botão direito do mouse em Microsoft Visual Studio 2010 e clique em Executar como administrador.
Crie a solução. No menu Criar, clique em Criar Solução ou pressione F6.
Expanda o nó HRApplicationServices. Esse nó contém o serviço do fluxo de trabalho que você irá implantar.
Expanda o nó Web.config. Observe que há dois subnós: Web.Debug.config e Web.Release.config.

Abra o arquivo Web.Release.config e analise seu conteúdo. O arquivo padrão contém somente quatro elementos: <xml>, <configuração>, <system.web> e <compilação>. No entanto, o arquivo de configuração finalizado contém o seguinte código:

<configuration xmlns:xdt=
       "https://schemas.microsoft.com/XML-Document-Transform">
  <!--Modify the BaseURI key -->
  <appSettings>
    <add key="BaseURI"
         value="https://localhost/HRApplicationServices"
         xdt:Transform="SetAttributes(value)"
         xdt:Locator="Match(key)"/>    
  </appSettings>
  <system.serviceModel>
    <client>
      <!--Modify the endpoint addresses for production -->
      <endpoint
        address="https://localhost/HRApplicationServices/SubmitApplication.xamlx"
        binding="basicHttpBinding"
        bindingConfiguration="BasicHttpBinding_IApplicationService"
        contract="IApplicationService"
        name="BasicHttpBinding_IApplicationService"
        xdt:Transform="SetAttributes(address)" xdt:Locator="Match(name)"/>
    </client>
  </system.serviceModel>
  <system.web>
    <compilation xdt:Transform="RemoveAttributes(debug)" />
  </system.web>  
</configuration>

Observe o elemento <appSettings>.

<appSettings>
    <add key="BaseURI"
         value="https://localhost/HRApplicationServices"
         xdt:Transform="SetAttributes(value)"
         xdt:Locator="Match(key)"/>    
  </appSettings>

Quando implantado usando o MSDeploy, a transformação instruirá o processo MSBuild a localizar o nó BaseURI no elemento <appSettings> XML e a substituir o valor do atributo pelo outro definido aqui: https://localhost/HRApplicationServices

Quando o projeto e o arquivo de configurações estiverem criados, a seguinte linha aparecerá no web.config transformado:

<appSettings>
    <add key="BaseURI" value="https://localhost/HRApplicationServices" />
  </appSettings>

A configuração também contém o elemento <system.ServiceModel> que define os valores do WFC (Windows Communication Foundation) necessários para se conectar ao serviço. Em resumo, a seção fornece o endereço, a vinculação e as informações do contrato para o serviço. Para obter mais informações, consulte Configurando serviços usando os arquivos de configuração.
Na barra de ferramentas do Visual Studio, alterne a configuração de Depurar para Liberar.
No Gerenciador de Soluções, clique com o botão direito do mouse no projeto HRApplicationServices e clique em Empacotar/Publicar Configurações. Isso abrirá a seção Empacotar/Publicar na Web da página de propriedades do projeto.
Sob Itens a serem implantados (aplica-se a todos os métodos de implantação) verifique se Somente arquivos necessários para executar este aplicativo está selecionado.
Sob Configurações do Pacote de Implantação da Web verifique se Criar pacote de implantação como arquivo zip está marcado.
Copie o local onde o pacote será criado para a área de transferência. Por padrão é:

Obj\Release\Package\<nome da solução.zip>
Configure o nome do Aplicativo/Site IIS a ser usado no servidor de destino.
Salve todos os arquivos na solução.

Para criar um pacote de implantação

Clique com o botão direito do mouse em HRApplicationServices e clique em Criar Pacote de Implantação. Você deverá ver o status como Publicação bem-sucedida no canto inferior esquerdo assim que a ação estiver concluída.

Importando o aplicativo no IIS

Nesta seção você implantará o aplicativo e editará as configurações de Associações para habilitar o AppFabric a usar o protocolo net.pipe para comunicação.

Para importar o aplicativo HRApplicationServices

Abra o Gerenciador do IIS clicando em Iniciar > Executar, e digitando inetmgr.
Expanda o nó Servidor, expanda Sites e clique com o botão direito do mouse em Site Padrão. Em seguida, clique em Implantar/Importar e em Importar Aplicativo.
Cole o caminho do arquivo .zip do aplicativo na caixa de diálogo.
Na caixa de diálogo Instalar um Pacote de Aplicativo você verá o aplicativo e o banco de dados. Aceite os valores padrão.
Clique em Avançar três vezes nas páginas seguintes do Assistente de Importação do pacote de aplicativos. Quando solicitado para executar esse aplicativo no pool de aplicativos .NET 4 padrão, clique em Sim.
A página Resumo fornecerá uma visão geral de alto nível de alguns itens que foram instalados do pacote. A guia Detalhes fornecerá muitos detalhes do que exatamente foi adicionado.

Habilitando o protocolo net.pipe

O AppFabric instala um Serviço de Gerenciamento de Fluxo de Trabalho (WMS) que trabalha com o repositório de persistência do fluxo de trabalho de modo a fornecer confiabilidade e controle das instâncias. O WMS se comunica com o serviço de fluxo de trabalho usando o protocolo net.pipe. Por isso, esse protocolo deve estar habilitado no aplicativo.

Para habilitar a associação net.pipe

Em Gerenciador do IIS, clique com o botão direito do mouse em Site Padrão e clique em Editar Associações….
Na lista, procure net.pipe com um asterisco (*) para obter suas Informações de Associação. Se não estiver presente:
1. clique no botão Adicionar.
2. Na caixa de diálogo Adicionar Associação do Site, selecione net.pipe.
3. Na caixa Informações de Associação digite um asterisco (*).

O que terminei de fazer?

Nesta lição, você definiu as configurações de implantação no Visual Studio e criou um pacote de implantação. Você também implantou o aplicativo importando o pacote para o Gerenciador do IIS. Finalmente, você habilitou o AppFabric para que se comunique com o aplicativo usando o protocolo net.pipe.

Próximas etapas

Vá para Lição 3: Configurando o aplicativo HRApplicationServices para configurar o AppFabric para monitoramento e persistência.

Consulte também

Conceitos

Lição 1: introdução
Lição 3: Configurando o aplicativo HRApplicationServices
Lição 4: monitorando a integridade do aplicativo HRApplicationServices
Lição 5: continuar um fluxo de trabalho suspenso usando o AppFabric

Outros recursos

Lição 6: Monitorando exceções no Order Service

2011-12-05

Partilhar via