Maintenant que notre compte Windows Azure est configuré correctement, il ne nous reste plus qu'à
déployer Orchard, c'est à dire l'installer sur notre espace d'hébergement, puis le configurer.
Orchard ressemble à n'importe quel projet Azure habituel. C'est à dire que vous devez envoyer le projet sur votre compte Windows Azure, comme nous l'avons fait dans le chapitre précédent, avant de pouvoir l'utiliser.
Nous allons donc récupérer le
package contenant les fichiers nécessaires, et déployer Orchard sur notre compte Azure.
Téléchargement et configuration
Vous pouvez récupérer les fichiers nécessaires à partir du site officiel d'Orchard, en vous rendant sur
la page Codeplex du projet Orchard.
Codeplex est un site qui fait office de portail pour les projets Open Source créés avec les technologies Microsoft, notamment l'environnement .NET. Vous pourrez donc y trouver Orchard et le télécharger.
Une fois sur la page, sélectionnez le fichier
Orchard.Azure.1.x.xx.zip.
Une fois l'archive extraite, vous obtenez deux fichiers :
- Orchard.Azure.Web.cspkg
- ServiceConfiguraction.cscfg
Comme d'habitude, ce sont ces fichiers qui vont vous permettre de déployer Orchard sur votre compte Windows Azure.
Avant cela, il va falloir modifier le fichier
ServiceConfiguration.cscfg. Celui-ci contient différents paramètres que vous allez pouvoir personnaliser. Pour cela, vous pouvez l'ouvrir avec Visual Web Developer.
Code du fichier
ServiceConfiguration.cscfg :
Code : XML | <?xml version="1.0"?>
<ServiceConfiguration serviceName="OrchardCloudService" osFamily="1" osVersion="*" xmlns="http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration">
<Role name="Orchard.Azure.Web">
<Instances count="1" />
<ConfigurationSettings>
<Setting name="DataConnectionString" value="UseDevelopmentStorage=true" />
</ConfigurationSettings>
</Role>
</ServiceConfiguration>
|
Nous avons plusieurs choses à modifier dans ce fichier.
Tout d'abord ligne 4, vous pouvez modifier le nombre d'instances déployées. Comme nous l'avons expliqué, cela n'est pas obligatoire mais c'est ce qui permet d'améliorer les performances de votre hébergement, et de profiter réellement des avantages du cloud Windows Azure !
Code : XML
Puis ligne 6, nous allons devoir modifier le contenu de l'attribut
value pour renseigner les informations de connexion au compte de stockage que nous avons créé précédemment. Vous devez remplacer la valeur actuelle UseDevelopmentStorage=true par la suivante :
DefaultEndpointsProtocol=https;AccountName=nom-de-votre-compte-de-stockage;AccountKey=code-acces-au-compte.
Veillez à bien remplacer les caractères en rouge par le nom de votre compte et le code permettant d'y accéder !
Le nom du compte de stockage est celui que vous avez choisi à la création du compte.
Le code d'accès peut être trouvé dans la section
Comptes de Stockage de votre plateforme Azure. Sélectionnez votre compte de stockage et cliquez à droite sur le bouton
Afficher, dans le champ
Clé d'accès primaire.
Au final cette ligne 6 donne quelque chose comme ça :
Code : XML | <Setting name="DataConnectionString" value="DefaultEndpointsProtocol=https;AccountName=orchardsdz;AccountKey=*********************************" />
|
Et voilà !
Votre fichier est configuré, nous allons maintenant pouvoir passer au déploiement de Windows Azure Companion.
Déploiement
Ici rien de bien nouveau puisque nous allons utiliser la même méthode que durant le chapitre précédent.
Connectez-vous à votre plateforme Windows Azure si ce n'est déjà fait, et rendez-vous dans la section
Services hébergés, comptes de stockage et CDN puis cliquez sur le bouton
Nouveau service hébergé à gauche de la barre de menus en haut.
La fenêtre de configuration habituelle s'ouvre et vous pouvez renseigner les informations nécessaires :
- Choisir un abonnement
- Donner un nom au service (projet)
- Choisir une adresse pour accéder à votre projet
- Choisir une région (West Europe reste le mieux pour un site destiné à un public français)
- Déployer en production (accès publique) ou stage (accès privé - pour des tests uniquement)
- Donner un nom à votre déploiement
- Sélectionner les fichiers Orchard.Azure.cspkg et ServiceConfiguration.cscfg
Cliquez sur
Ok pour valider.
À cet instant, il se peut qu'un message d'avertissement apparaisse. C'est le cas si vous avez laissé le nombre d'instances déployées à 1 dans le fichier
ServiceConfiguration.cscfg. Cela n'empêchera pas votre projet de fonctionner, Azure vous prévient simplement qu'il vaut mieux déployer au minimum deux instances pour chaque service.
Patientez quelques minutes le temps que Windows Azure déploie votre projet... Et voilà ! Vous pouvez maintenant accéder à Orchard !
Configuration
Utilisez l'adresse que vous avez choisie au moment du déploiement de votre projet pour accéder à votre nouveau site Orchard. La première chose que vous voyez est une page de configuration, avec quelques informations à renseigner pour qu'Orchard puisse fonctionner correctement.
Il vous faut renseigner les informations suivantes :
- What is the name of your site ? Le nom de votre site.
- Choose a user name : Votre nom d'utilisateur sur le site.
- Choose a password : Votre mot de passe. N'oubliez pas de le confirmer en dessous !
- How would you like to store your data ? Les informations de connexion à votre base de données.
Nous allons utiliser la base de données que nous avons créée plus tôt. Vous pouvez donc sélectionner l'option
Use an existing SQL Server (or SQL Express) database.
Il vous faut ensuite remplir le champ
connection string qui apparaît en dessous. Vous pouvez reprendre la valeur d'exemple écrite en italique sous le champ à compléter, en veillant à bien remplacer les éléments nécessaires (en gras ci-dessous) :
Data Source=sqlServerName;Initial Catalog=dbName;Persist Security Info=True;User ID=userName;Password=password
Le premier paramètre (
sqlServerName) est l'adresse du serveur de base de données que vous avez créé. Cette adresse est un peu complexe, vous pouvez la trouver dans la partie
Base de données de votre plateforme Azure. Sélectionnez votre base de données dans la liste.
À droite, vous pouvez cliquer sur le bouton
Afficher... dans la partie
« Chaînes de connexion ». Cela aura pour effet d'ouvrir une fenêtre avec les différentes informations de connexion nécessaire.
Dans cette fenêtre vous pouvez récupérer l'adresse du serveur. Sur la première ligne, il s'agit de tout ce qui est compris entre
« Server= » et le point-virgule suivant, comme l'illustre l'image ci-dessous.
Le deuxième paramètre (
dbName) est le nom de votre base de données. Si vous avez correctement suivi les étapes dans ce chapitre, ce nom est certainement
orchard.
Le troisième paramètre (
userName) est le nom d'administrateur que vous avez défini au moment de la création de votre serveur de base de données. Ce nom doit être complété par une arobase et le nom du serveur qui héberge votre base de données. Exemple :
zozor@6z3b7ujkyo.
Enfin, le quatrième paramètre (
password) est le mot de passe que vous avez choisi pour l'administrateur, au moment de la création de votre serveur de base de données.</puce>
Il vous reste ensuite l'option
Database Table Prefix. Cela vous permet de choisir un préfixe pour les différentes tables qui seront créées par Orchard. Dans une base de données, une table est une sorte de catégorie qui permet de trier les différentes données que vous stockez. Par exemple, Orchard utilisera des tables différentes pour ranger les informations concernant les utilisateurs, les articles, les commentaires, les catégories d'articles, etc. Afin de pouvoir distinguer facilement les tables qui seront créées par Orchard, je vous recommande d'utiliser
orc_.
Vous pouvez à présent valider votre formulaire. Si les informations que vous avez renseignées sont correctes, vous devriez voir apparaitre votre tout nouveau site.
Celui-ci n'est pour l'instant pas très rempli, mais vous allez pouvoir le personnaliser en ajoutant un thème, des pages, des menus... et en rédigeant des articles !
Pour cela, il vous faut passer par l'interface d'administration d'Orchard qui est accessible en cliquant tout en bas sur le lien
Dashboard.
À vous de jouer pour personnaliser votre site !