Exporter (0) Imprimer
Développer tout

Outil en ligne de commande CSPack

Mis à jour: novembre 2013

L'outil en ligne de commande CSPack (CSPack.exe) prépare une application au déploiement. Votre utilisation de CSPack dépend de l'emplacement où vous avez l'intention de déployer l'application.

  • Pour préparer l'application au déploiement vers l'Émulateur de calcul Windows Azure, utilisez CSPack afin de copier les fichiers binaires vers une structure organisée en répertoires.

  • Pour préparer l'application au déploiement vers Windows Azure, utilisez CSPack afin de générer un fichier de package qui est téléchargé vers Windows Azure.

  • Pour plus d'informations sur la conversion d'un package existant vers le nouveau format de package, consultez Format de package Windows Azure.

Emplacement de l'outil

Si vous avez installé le Kit de développement logiciel (SDK) Windows Azure version 1.7 (ou version ultérieure) à l'emplacement par défaut, CSPack se trouve dans le répertoire C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version_SDK>\bin. Dans les versions 1.6 et antérieures du Kit de développement logiciel (SDK) Windows Azure, CSPack est installé dans le répertoire C:\Program Files\Windows Azure SDK\<version_SDK>\bin\.

Syntaxe de la ligne de commande

CSPack <DefinitionFile> [options]

Options

Le tableau suivant répertorie les options de CSPack. Pour consulter la liste d'options la plus récente, tapez CSPack /? à une invite de commandes à partir de l'emplacement d'installation.

 

Option Description

/out:<fichier> | répertoire>

Cette option indique le format de sortie et l'emplacement des fichiers binaires du rôle.

Lorsque l'option /copyOnly est spécifiée avec cette option, CSPack crée le répertoire de sortie nommé et copie les fichiers binaires du rôle dans ce répertoire.

Si /copyOnly n'est pas spécifié, cette option spécifie le nom de fichier du package d'application. Si aucun nom de fichier n'est spécifié, le package d'application est créé en tant que <nom_fichier_définition_service>.cspkg.

/copyOnly

Lorsque cette option est spécifiée, CSPack crée une structure organisée en répertoires pour les fichiers binaires du rôle, ce qui permet à émulateur de calcul d'exécuter l'application localement.

Si aucun emplacement de sortie n'est spécifié avec l'option /out, CSPack crée un répertoire nommé <nom_fichier_définition_service.csx>.

/role:<nom_rôle>;[<répertoire_binaires_rôle>];[<DLL_point_entrée_rôle>]

Lorsque cette option est spécifiée, CSPack crée une structure organisée en répertoires pour les fichiers binaires du rôle, ce qui permet à émulateur de calcul d'exécuter l'application localement.

Si aucun emplacement de sortie n'est spécifié avec l'option /out, CSPack crée un répertoire nommé <nom_fichier_définition_service.csx>.

/roleFiles:<nom_rôle>;<liste_fichiers_rôle>

Cette option spécifie un fichier qui comprend un ensemble de chemins d'accès vers les fichiers qui composent le rôle. La ligne de commande peut inclure une option /roleFiles pour chaque rôle noté dans le fichier de définition.

Pour spécifier la DLL qui définit le point d'entrée du rôle, utilisez l'option /rolePropertiesFile avec l'option /roleFiles.

Le paramètre <liste_fichiers_rôle> spécifie un simple fichier texte local où chaque ligne se présente sous la forme suivante :

<chemin_entrée>;<chemin_cible>

<chemin_entrée> peut être le chemin d'accès absolu ou le chemin d'accès relatif d'un fichier qui compose le rôle. Si <chemin_entrée> est relatif, il est relatif à l'emplacement du fichier spécifié par <liste_fichiers_rôle>.

<chemin_cible> est un chemin d'accès relatif qui spécifie l'emplacement du fichier indiqué par <chemin_entrée> dans le package de services.

Si vous spécifiez l'option /roleFiles, ne spécifiez pas l'option /role.

/rolePropertiesFile:<nom_rôle>;<fichier_propriétés_rôle>

Cette option spécifie un fichier qui contient une liste de propriétés pour un rôle. L'option /rolePropertiesFile doit être spécifiée avec l'option /roleFiles. Dans le fichier de propriétés du rôle, spécifiez la DLL qui contient le point d'entrée vers le rôle et la version du .NET Framework cible en fonction duquel ce rôle doit être exécuté.

Le paramètre <fichier_propriétés_rôle> spécifie un simple fichier texte local où chaque ligne se présente sous la forme suivante :

<nom_propriété>=<valeur_propriété>

Pour plus d'informations sur les noms et les valeurs de propriétés valides, consultez la section Remarques.

/sitePhysicalDirectories:<nom_rôle>;<chemin_virtuel1>;
<chemin_physique1>;<chemin_virtuel2>;<chemin_physique2>;…

Cette option permet de définir les répertoires physiques de chaque chemin d'accès virtuel défini dans la section Sites. Chaque élément relatif au site, au répertoire virtuel et à l'application virtuelle crée un chemin d'accès virtuel (également appelé chemin d'accès d'emplacement dans l'élément location de web.config).

Pour plus d'informations sur l'utilisation de l'élément Site, consultez Configurer l'entrée Site dans le fichier de définition de service.

/sites:<nom_rôle>;<nom_site>;<chemin_virtuel1>;
<chemin_physique1>;…

Cette option permet de mapper le contenu situé dans les répertoires physiques aux répertoires virtuels du site Web. Chaque élément relatif au site, au répertoire virtuel et à l'application virtuelle est ajouté dans l'ordre où il est défini afin de créer des chemins d'accès virtuels (également appelés chemins d'accès d'emplacement dans l'élément location de web.config).

chemin_virtuel1 est mappé au nom de site tel qu'il est défini par l'attribut name de l'élément <Site> dans le fichier de définition de service.

chemin_physique1 correspond à l'emplacement du contenu de Site.

/generateConfigurationFile:<fichier_configuration>

Cette option permet de générer un fichier de configuration de base pour une application. Modifiez le fichier généré pour spécifier les valeurs des paramètres et le nombre d'instances de rôle de l'application avant de la déployer.

/allowLegacyWebRoles

Cet indicateur supprime les avertissements qui se produisent lorsqu'un package contient des rôles Web hérités qui s'exécutent dans Hosted Web Core. Vous pouvez exécuter les instances de rôle dans Hosted Web Core à l'aide de cette option, ou vous pouvez ajouter l'élément Sites à votre définition de service.

/useCtpPackageFormat

Cette option spécifie que le format du package correspond au nouveau format de package. Pour plus d'informations sur l'utilisation du nouveau format, consultez Utiliser CSPack pour créer un package au nouveau format.

/convertToCTPPackage

Cette option spécifie qu'un package existant doit être converti vers le nouveau format de package. Pour plus d'informations, consultez Convertir un package existant au nouveau format.

Notes

Vous pouvez spécifier les propriétés suivantes dans le fichier de propriétés de rôle :

noteRemarque
Vous avez des difficultés pour afficher cette rubrique dans la bibliothèque Windows Azure ? Essayez de l'afficher dans la bibliothèque MSDN.

 

Nom de la propriété Valeur de propriété Exemples

TargetFrameWorkVersion

Numéro indiquant la version du .NET Framework en fonction de laquelle ce rôle doit être exécuté. Le format de ce paramètre de propriété est TargetFrameWorkVersion=vMajor.Minor, où Major fait référence au numéro de la version principale et où Minor fait référence au numéro de la version mineure.

TargetFrameWorkVersion=v4.0

TargetFrameWorkVersion=v3.5

EntryPoint

Nom de la DLL qui sert de point d'entrée dans le rôle. Le format de ce paramètre de propriété est EntryPoint=DLLFileName, où DLLFileName est une chaîne qui spécifie le nom de fichier de la DLL.

EntryPoint=myroleentrypoint.dll

ImportantImportant
Si un appel à CSPack qui fonctionnait avec le Kit de développement logiciel (SDK) Windows Azure 1.1 échoue après une mise à niveau vers le Kit de développement logiciel (SDK) Windows Azure 1.2 (ou une version ultérieure), il se peut que vous n'ayez pas spécifié correctement la version du .NET Framework cible pour CSPack. CSPack suppose que votre code de service a été compilé sous .NET 3.5 par défaut. Si votre code a été compilé sous .NET 4, vous devez le spécifier en créant un fichier de propriétés de rôle et en incluant l'option /rolePropertiesFile sur la ligne de commande.

WarningAvertissement
Dans le Kit de développement Windows SDK version 1.5 ou ultérieure, les packages créés par CSPack ne sont plus chiffrés. Il est conseillé de ne pas stocker de données sensibles dans les contenus de package.

Exemples

Les exemples suivants montrent comment empaqueter manuellement plusieurs exemples du Kit de développement logiciel (SDK) Windows Azure à partir de la ligne de commande à l'aide de CSPack.

L'exemple suivant montre comment empaqueter l'exemple HelloWorld pour un déploiement dans l'environnement de développement :


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

L'exemple suivant montre comment empaqueter l'exemple HelloWorld pour un déploiement vers 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

Les exemples suivants montrent comment empaqueter des exemples qui incluent un rôle de travail :


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

L'exemple suivant montre comment empaqueter un exemple qui comprend à la fois un rôle de travail, OrderProcessingRole, et un rôle 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

Voir aussi

Afficher:
© 2015 Microsoft