Usando manifestos personalizados

por Faith A

Este guia rápido ajudará você a criar um manifesto personalizado e sincronizá-lo. Sincronizaremos um site da Web e incluiremos o pool de aplicativos, um diretório externo e um assembly e um objeto COM que não são coletados automaticamente para um site da Web.

Pré-requisitos

Este guia requer os seguintes pré-requisitos:

• .NET Framework 2.0 SP1 ou superior
• Ferramenta de Implantação da Web 1.1

Observação: se você ainda não instalou a Ferramenta de Implantação da Web, consulte Installing Web Deploy.

Visão geral de um manifesto

Um manifesto é simplesmente um agrupamento de provedores em um arquivo de definição. É uma maneira de especificar vários caminhos que serão incluídos em uma sincronização, como um site, um grupo de aplicativos e um assembly. Ele pode ser usado para especificar vários sites, vários diretórios ou outros caminhos.

Observação: neste artigo, mostramos como mover um site e um pool de aplicativos do IIS 7 e superior, mas você também pode usar o manifesto no IIS 6.0 para especificar um site do IIS 6.0 e um pool de aplicativos.

Manifesto de exemplo

<myCustomSite>
    <appHostConfig path="TestWebSite" />
    <appPoolConfig path="TestAppPool" />
    <dirPath path="C:\MyExtraFiles" />
    <gacAssembly path="'System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a'" />
    <comObject path="Microsoft.ApplicationHost.AdminManager" />
</myCustomSite>

Para criar e usar um manifesto personalizado

1. Abra o Bloco de Notas e crie um arquivo XML. Vamos chamá-lo de Custom.xml.

2. Copie o manifesto de exemplo para Custom.xml.

3. Copie Custom.xml no diretório de instalação %programfiles%\IIS\Microsoft Web Deploy.

4. Crie um diretório chamado MyExtraFiles na unidade C:.

5. Execute o seguinte comando para sincronizar os objetos no manifesto com um arquivo de pacote (compactado):

   msdeploy.exe -verb:sync -source:manifest=Custom.xml -dest:package=c:\CustomPackage.zip > WebDeployPackage.log
   

   Ao especificar > WebDeployPackage.log, os resultados do pacote serão listados no arquivo de log e você poderá fazer referência a ele facilmente.

Abra o pacote. Você deve ver o próprio site e o diretório extra especificados.

Posteriormente, você pode usar o pacote como origem e sincronizá-lo com um destino especificado pelo arquivo de manifesto (o que significa que você sincronizará do pacote com os provedores especificados em seu manifesto).

Você também pode executar uma operação de sincronização com um manifesto ativo, sem usar um pacote. Para sincronizar com um manifesto, os argumentos de origem e de destino devem especificar um arquivo de manifesto.

Para sincronizar um site usando um manifesto personalizado

1. Execute o comando a seguir para sincronizar o manifesto com um destino remoto. O computador remoto é especificado pelo argumento computername .

   msdeploy.exe -verb:sync -source:manifest=custom.xml -dest:manifest=custom.xml,computername=Server1 > webdeploysync.log
   

Resumo

Agora você criou um manifesto personalizado e o usou para sincronização. Você pode estender ainda mais o manifesto adicionando quaisquer caminhos de provedor que sejam importantes para seu site ou servidor, como uma chave do Registro ou um assembly no GAC. Para obter mais informações sobre o provedor de manifesto, consulte Provedor de Manifesto do Web Deploy.