Exportar (0) Imprimir
Expandir Tudo

Ferramenta de linha de comando CSPack

Atualizado: novembro de 2013

A ferramenta de linha de comando CSPack (CSPack.exe) prepara um aplicativo para implantação. A forma de usar CSPack depende de onde o aplicativo será implantado.

  • Para preparar o aplicativo para implantação no Emulador de computação do Windows Azure, use CSPack para copiar os arquivos binários para um layout de diretório.

  • Para preparar o aplicativo para implantação no Windows Azure, use CSPack para gerar um arquivo de pacote que é carregado no Windows Azure.

  • Para obter mais informações sobre como converter um pacote existente para o novo formato de pacote, consulte Formato do pacote do Windows Azure

Local da ferramenta

Se você instalou o SDK no local padrão, para os SDKs do Windows Azure nas versões 1.7 e posteriores, o CSPack pode ser encontrado na pasta C:\Arquivos de Programas\Microsoft SDKs\Windows Azure\.NET SDK\<versão do sdk>\bin directory. Nas versões 1.6 e anteriores do SDK do Windows Azure, o CSPack é instalado no diretório C:\Arquivos de Programas\Windows Azure SDK\<versão do SDK>\bin\.

Sintaxe de linha de comando

CSPack <DefinitionFile> [options]

Opções

A tabela a seguir lista as opções de CSPack. Para exibir a lista de opções mais atual, digite CSPack /? em um prompt de comando do local instalado.

 

Opção Descrição

/out:<file> | directory>

Esta opção indica o formato de saída e o local para os binários de função.

Quando a opção /copyOnly é especificada com esta opção, CSPack cria o diretório de saída nomeado e copia os binários de função para esse diretório.

Se /copyOnly não for especificada, esta opção especificará o nome de arquivo para o pacote de aplicativo. Se nenhum nome de arquivo for especificado, o pacote de aplicativo será criado como <nome-de-arquivo-de-definição-de-serviço>.cspkg.

/copyOnly

Quando esta opção é especificada, CSPack cria um layout de diretório para os binários de função, que o emulador de computação usa para executar o aplicativo localmente.

Se nenhum local de saída for especificado com a opção /out, CSPack criará um diretório nomeado <nome-de-arquivo-de-definição-de-serviço>.csx.

/role:<RoleName>;[<RoleBinariesDirectory>];[<RoleEntryPointDLL>]

Quando esta opção é especificada, CSPack cria um layout de diretório para os binários de função, que o emulador de computação usa para executar o aplicativo localmente.

Se nenhum local de saída for especificado com a opção /out, CSPack criará um diretório nomeado <nome-de-arquivo-de-definição-de-serviço>.csx.

/roleFiles:<RoleName>;<RoleFileList>

Esta opção especifica um arquivo que inclui um conjunto de caminhos para os arquivos que compõem a função. A linha de comando pode incluir uma opção /roleFiles para cada função denotada no arquivo de definição.

Para especificar a DLL que define o ponto de entrada da função, use a opção /rolePropertiesFile junto com a opção /roleFiles.

O parâmetro <RoleFileList> especifica um arquivo de texto local simples em que cada linha está no seguinte formato:

<InputPath>;<TargetPath>

O <InputPath> pode ser um caminho absoluto ou um caminho relativo para um arquivo que compõe a função. Se <InputPath> for relativo, ele é relativo ao local do arquivo especificado por <RoleFileList>.

O <TargetPath> é um caminho relativo que especifica onde o arquivo referido por <InputPath> será colocado no pacote de serviço.

Se você especificar a opção /roleFiles, não deve especificar também a opção /role.

/rolePropertiesFile:<RoleName>;<RolePropertyFile>

Esta opção especifica um arquivo que contém uma lista de propriedades para uma função. A opção /rolePropertiesFile deve ser especificada junto com a opção /roleFiles. Dentro do arquivo de propriedade de função, você pode especificar a DLL que contém o ponto de entrada para a função e a versão do .NET Framework de destino nos quais esta função deve ser executada.

O parâmetro <RolePropertyFile> especifica um arquivo de texto local simples em que cada linha está no seguinte formato:

<PropertyName>=<PropertyValue>

Para obter detalhes sobre valores e nomes de propriedade válidos, consulte a seção Comentários.

/sitePhysicalDirectories:<RoleName>;<VirtualPath1>;
PhysicalPath1<;><VirtualPath2>;<PhysicalPath2>;…

Esta opção habilita a definição de diretórios físicos para cada caminho virtual definido na seção Sites. Cada elemento de Site, Diretório Virtual e Aplicativo Virtual cria um caminho virtual (também chamado de caminho de local no elemento de local web.config).

Para obter mais informações sobre o uso do elemento Site, consulte Configuração da entrada de site no arquivo de definição de serviço.

/sites:<RoleName>;<SiteName>;<VirtualPath1>;
<PhysicalPath1>;…

Esta opção permite o mapeamento do conteúdo localizado em diretórios físicos nos diretórios virtuais do site. Cada elemento de Site, Diretório Virtual e Aplicativo Virtual é acrescentado na ordem em que é definido para criar os caminhos virtuais (também chamados caminhos de local no elemento de local web.config).

VirtualPath1 mapeia no nome do site, como definido pelo atributo de nome do elemento <Site> no arquivo de definição de serviço.

PhysicalPath1 é o local do conteúdo do Site.

/generateConfigurationFile:<ConfigurationFile>

Esta opção é usada para gerar um arquivo de configuração esqueleto para um aplicativo. Edite o arquivo gerado para especificar os valores das configurações e número de instâncias de função no aplicativo antes de implantá-lo.

/allowLegacyWebRoles

Este sinalizador suprime os avisos que ocorrem para um pacote que contém funções Web herdadas que são executadas em Núcleo da Web Hospedável. Você pode executar as instâncias de função em um Núcleo da Web Hospedável usando esta opção ou pode adicionar o elemento Sites a sua definição de serviço.

/useCtpPackageFormat

Esta opção especifica que o pacote é formatado no novo formato de pacote. Para obter mais informações sobre o uso do novo formato, consulte Uso do CSPack para a criação de um pacote no novo formato.

/convertToCTPPackage

Esta opção especifica que um pacote existente deve ser convertido para o novo formato de pacote. Para obter mais informações, consulte Conversão de um pacote existente para o novo formato.

Comentários

Você pode especificar as propriedades a seguir no arquivo de propriedade de função:

noteObservação
Problemas ao visualizar este tópico na Biblioteca do Windows Azure? Tente visualiza-lo na Biblioteca MSDN.

 

Nome da propriedade Valor da Propriedade Exemplos

TargetFrameWorkVersion

Um número que indica a versão do .NET Framework no qual esta função será executada. O formato desta configuração de propriedade é TargetFrameWorkVersion=vMajor.Minor, em que Major se refere ao número da versão principal e Minor, ao número da versão secundária.

TargetFrameWorkVersion=v4.0

TargetFrameWorkVersion=v3.5

EntryPoint

O nome da DLL que serve como o ponto de entrada na função. O formato desta configuração de propriedade é EntryPoint=DLLFileName, em que DLLFileName é uma cadeia de caracteres que especifica o nome do arquivo da DLL.

EntryPoint=myroleentrypoint.dll

ImportantImportante
Se uma chamada para CSPack que funcionou no SDK do Windows Azure versão 1.1 não ocorrer depois de atualizar para o SDK do Windows Azure versão 1.2 ou posterior, o problema poderá se dever ao fato de você não ter especificado a versão do .NET Framework de destino corretamente para o CSPack. O CSPack presume que seu código de serviço tenha sido compilado no .NET 3.5 por padrão. Se seu código tiver sido compilado no .NET 4, especifique isso criando um arquivo de propriedades de função e incluindo a opção /rolePropertiesFile na linha de comando.

WarningAviso
Nas versões 1.5 e posteriores do SDK do Windows, os pacotes criados pelo CSPack não são mais criptografados. Não é recomendável armazenar dados confidencias no conteúdo dos pacotes.

Exemplos

Os exemplos a seguir mostram como empacotar manualmente vários exemplos do SDK do Windows Azure a partir da linha de comando usando CSPack.

O exemplo a seguir mostra como empacotar o exemplo HelloWorld para a implantação no ambiente de desenvolvimento:


c:\samples\HelloWorld>cspack HelloWorld\ServiceDefinition.csdef /out:HelloWorld.csx /role:HelloWorld_WebRole;HelloWorld_WebRole /sites:HelloWorld_WebRole;Web;d:\HelloWorld_WebRole\HelloWorld_WebRole /copyOnly

O exemplo a seguir mostra como empacotar o exemplo HelloWorld da implantação para o Windows Azure:


c:\samples\HelloWorld>cspack HelloWorld\ServiceDefinition.csdef /out:HelloWorld.cspkg /role:HelloWorld_WebRole;HelloWorld_WebRole /sites:HelloWorld_WebRole;Web;d:\HelloWorld_WebRole\HelloWorld_WebRole

Os exemplos a seguir mostram como empacotar exemplos que incluem uma função de trabalho:


c:\samples\HelloFabric>cspack HelloFabric\ServiceDefinition.csdef 
   /role:HelloFabric_WorkerRole;HelloFabric_WorkerRole\bin\Debug;HelloFabric_WorkerRole.dll 
   /out:HelloFabric.cspkg

c:\samples\Thumbnails>cspack ThumbnailsWorkerOnly\ServiceDefinition.csdef 
/role:Thumbnails_WorkerRole;Thumbnails_WorkerRole\bin\Debug;Thumbnails_WorkerRole.dll 
/out:ThumbnailsWorkerOnly.cspkg

O exemplo a seguir mostra como empacotar uma amostra que inclui uma função de trabalho, OrderProcessingRole, e uma função da Web, FrontendWebRole:


C:\samples\MultiTierApp>cspack MultiTierApp\ServiceDefinition.csdef /out:MultiTierApp.cspkg
/role:FrontendWebRole;FrontendWebRole /sites:FrontendWebRole;Web;c:\MyDirectory\MultiTierApp\FrontendWebRole 
/role:OrderProcessingRole;OrderProcessingRole\bin\Debug;OrderProcessingRole.dll

Consulte Também

Mostrar:
© 2014 Microsoft