English Fran%u00e7ais
This article shows most of the steps decribed on the Interoperability Bridges web site. The main differences are that it shows more screen shots, it is tested against Windows Azure SDK 1.6 (Nov. 2011) with latest available package (Drupal 7.9), the package is slighty customized before uploading, and explanations are also in French . Cet article montre la plupart des %u00e9tapes qui sont d%u00e9crites sur le site Web Interoperability Bridges. Les diff%u00e9rences les plus importantes sont qu’il y a plus de copies d’%u00e9crans, il a %u00e9t%u00e9 test%u00e9 avec Windows Azure SDK 1.6 (Novembre 2011) avec le dernier package du moment (Drupal 7.9), le paquet est %u00e9galement modifi%u00e9 l%u00e9g%u00e8rement avant chargement sur Windows Azure. De plus, les explications sont aussi en fran%u00e7ais .
The starting point in this blog post are:
– a local Windows Server 2008 R2 development environment with Windows Azure SDK 1.6 installed.
– An active Windows Azure subscription. You may get one from http://windowsazure.fr for instance.
– An Azure SQL Server setup in a local region (North Europe in this example) with correct firewall rules (cf instructions here)
– Windows Azure SDK for PHP installed as described in this post.
Le point de d%u00e9part de ce billet est constitu%u00e9 des %u00e9l%u00e9ments suivants:
– un serveur local Windows Server 2008 R2
– un environnement de d%u00e9veloppement local avec le SDK 1.6 de Windows Azure install%u00e9
– un abonnement %u00e0 Windows Azure en cours de validit%u00e9. Il est possible de s’en procurer un  %u00e0 partir de http://windowsazure.fr par exemple.
– un serveur SQL Azure cr%u00e9%u00e9 dans une r%u00e9gion local (Europe du Nord dans cet exemple) avec les bonnes r%u00e8gles de pare-feu (voir instructions ici)
– Le SDK Windows Azure pour PHP install%u00e9 tel que d%u00e9crit dans ce billet.
The main steps are the following Les principales %u00e9tapes sont sch%u00e9matis%u00e9es ainsi
Then a few steps happen inside Drupal itself to configure it. D’autres %u00e9tapes sont %u00e9galement n%u00e9cessaires ensuite dans Drupal lui-m%u00eame pour le configurer.

 

Let’s get started. D%u00e9marrons.
Create a SQL Azure database Cr%u00e9er une base SQL Azure

In order to avoid using the sysadmin login to connect to this drupal database, create a drupal login which will be the owner of the database. This can be done from the SQL Server Management Studio (from the developmenet environment) or from the management portal De fa%u00e7on %u00e0 %u00e9viter d’utiliser un compte de connexion administrateur du serveur SQL Azure pour se connecter %u00e0 la base drupal, cr%u00e9ons un compte pour drupal qui sera propri%u00e9taire de la base. Cela peut %u00eatre fait depuis SQL Server Management Studio (depuis l’environnement de d%u00e9veloppement) ou depuis le portail de gestion

 

the code of the query is le code de la requ%u00eate est le suivant

CREATE LOGIN drupalLogin WITH PASSWORD = ‘BVvvgdjs65’

Connect to the drupal database now (instead of the master database) Se connecter maintenant sur la base drupal (%u00e0 la place de la base master)
(sames steps as before)
The script is the following:
(m%u00eames %u00e9tapes qu’avant)
Le script est le suivant:

CREATE USER drupalUser FOR LOGIN drupalLogin WITH DEFAULT_SCHEMA = dbo
GO
EXEC sp_addrolemember N’db_owner’, N’drupalUser’
GO

Let’s now create a strorage account from the Windows Azure Management portal Cr%u00e9ons maintenant un compte de stockage depuis le portail de gestion Windows Azure

NB: create the storage account in the same region as the SQL Azure Server (North Europe in this example). NB: cr%u00e9er le compte de stockage dans la m%u00eame r%u00e9gion que le serveur SQL Azure (Europe du Nord dans cet exemple)

At this stage, we have the following assets and credentials (NB: no need to try to use the passwords and keys, they have been changed since this post was written). A cette %u00e9tape, on dispose des cr%u00e9dentit%u00e9s suivantes (NB: n’essayez pas d’utiliser ces mots de passe et clefs, ils ont %u00e9t%u00e9 chang%u00e9s depuis l’%u00e9criture de ce billet)
  • SQL Azure:
    • server=j2f2uoqrmd.database.windows.net,
    • database=durpal
    • username=drupalLogin,
    • password=BVvvgdjs65
  • Windows Azure Storage:
    • drupal111205a
    • key= QQ9TTO5oCjnWZxcMW/pegWHJccKCOHW9WaeRZbNK5vGPAwbhle3AbQCynf6sVmWAuCqjWPL45d5iQWnyFvFUfg==
With a tool like Azure Storage Explorer, create a public container named drupalazurestorage Avec un outil tel que Azure Storage Explorer, cr%u00e9er un conteneur public appel%u00e9 drupalazurestorage

the following warning can be ignored le message d’avertissement suivant peut %u00eatre ignor%u00e9

Let’s now start the creation of the Windows Azure package that will contain Drupal engine.
Download the following file to the local hard drive.
D%u00e9marrons maintenant le cr%u00e9ation du package Windows Azure qui contiendra le moteur Drupal. T%u00e9l%u00e9charger le fichier suivant vers le disque local.

https://github.com/downloads/Interop-Bridges/Windows-Azure-PHP-Scaffolders/drupal.zip

Unblock the zip file before unzipping it (File Properties, Unblock) D%u00e9bloquer le fichier zip avant de le d%u00e9zipper (File Properties, Unblock)
Unzip its content (drupal.phar) file into C:\temp D%u00e9zipper le contenu (drupal.phar) de ce fichier dans C:\temp
NB: a .phar file is a PHP archive NB: un fichier .phar est une archive PHP
In the same folder (C:\temp), create a new text file (start, run, notepad, File, Save As) and name it Dans le m%u00eame r%u00e9pertoire (C:\temp), cr%u00e9er un nouveau fichier texte (start, run, notepad, File, Save As) et lui donner un nom

C:\Temp\scaffold-drupal.cmd

The content of the file should be the following (replace with your own names, keys and passwords): Le contenu du fichier doit %u00eatre le suivant (remplacer avec vos propres noms, clefs et mots de passes)

set here=%~dp0%

scaffolder run -s=”%here%Drupal.phar” -out=”C:\Temp\Drupal01″ -DiagnosticsConnectionString=”DefaultEndpointsProtocol=https;AccountName=drupal111205a;AccountKey=QQ9TTO5oCjnWZxcMW/pegWHJccKCOHW9WaeRZbNK5vGPAwbhle3AbQCynf6sVmWAuCqjWPL45d5iQWnyFvFUfg==” -sql_azure_database=drupal -sql_azure_username=drupalLogin@j2f2uoqrmd -sql_azure_password=BVvvgdjs65 -sql_azure_host=j2f2uoqrmd.database.windows.net -sync_account=drupal111205a -sync_key=QQ9TTO5oCjnWZxcMW/pegWHJccKCOHW9WaeRZbNK5vGPAwbhle3AbQCynf6sVmWAuCqjWPL45d5iQWnyFvFUfg==
pause

Then, double click on the cmd file in order to run it: Puis, double-cliquer sur le fichier cmd de fa%u00e7on %u00e0 le lancer
This created the following folder with the following content: Cela a cr%u00e9%u00e9 le r%u00e9pertoire suivant avec le contenu suivant
download the following file and save it in the c:\temp folder, and unblock it before unzipping it T%u00e9l%u00e9charger le fichier suivant et le sauvegarder dans le r%u00e9pertoire c:\temp, le d%u00e9bloquer avant de le d%u00e9zipper

https://github.com/downloads/Interop-Bridges/Windows-Azure-File-System-Durability-Plugin/FileSystemDurabilityPlugin-v1.1.zip

Extract content to the following folder Extraire le contenu dans le dossier suivant

C:\Program Files\Windows Azure SDK\v1.6\bin\plugins

Let’s now change the .cscfg and .csdef files. Modifions maintenant les fichiers .cscfg et .csdef.
NB: The .csdef file corresponds to what cannot be changed after packaging, while .cscfg file may be changed at runtime from the Windows Azure Portal or other means (API, ) NB: le fichier .csdef correspond %u00e0 ce qui ne peut pas %u00eatre chang%u00e9 apr%u00e8s avoir cr%u00e9er le paquet de d%u00e9ploiement, alors que le fichier .cscfg peut %u00eatre chang%u00e9 au moment de l’ex%u00e9cution depuis le portail de gestion Windows Azure ou d’autres moyens (API, )
In this example, this is done with notepad++, but this can also be done with any text editor, even notepad. The advantage of an editor that has XML syntax colorization is that it is less error prone, especially while dealing with XML comments. Dans cet exemple, cela est fait avec notepad++, mais cela peut aussi %u00eatre fait avec n’importe quel %u00e9diteur de texte, y compris notepad. L’avantage d’un %u00e9diteur qui dispose de coloration syntaxique XML est que cela peut %u00e9viter des erreurs, en particulier quand on est en train de supprimer des commentaires XML.
Optionally, if you want to enable remote desktop, i.e. being able to access to any server in the web farm once installed to Windows Azure, you may add the corresponding lines in the .csdef and .cscfg files. This is documented here. For instance: Optionnellement, si on veut autoriser l’accs%u00e8 au bureau %u00e0 distance, c’est-%u00e0-dire %u00eatre capcable de se connecter %u00e0 n’importe quel serveur de la ferme une fois install%u00e9e dans Windows Azure, il est possible d’ajouter les lignes correspondantes dans les fichiers .csdef et .cscfg. Cela est document%u00e9 ici. Par exemple:

Another important change is to choose the number of instances that the web farm will start with Un autre changement important est de choisir le nombre d’instances avec laquelle la ferme Web sera initialement d%u00e9ploy%u00e9e
You may also want to change the size of a Virtual Machine inside the web farm. This is a .csdef parameter (i.e. changing it requires re-packaging and re-deployment).
Possibles values for vmsize parameter are documented on MSDN web site.
On peut aussi vouloir changer la taille de chaque machine virtuelle dans la ferme Web. C’est un param%u00e8tre .csdef (et donc le modifier suppose de repackager et de red%u00e9ployer). Les valeurs possibles pour le param%u00e8tre vmsize sont document%u00e9es sur le site MSDN.
So here is what can end up with, as an example, for the 2 files Donc voici ce %u00e0 quoi on peut aboutir, par exemple, pour les 2 fichiers
<?xml version="1.0" encoding="utf-8"?>
<ServiceConfiguration serviceName="PhpOnAzure" xmlns="http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration" osFamily="2" osVersion="*">
  <Role name="WebRole">
    <Instances count="2" />
    <ConfigurationSettings>
      <Setting name="Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString" value="UseDevelopmentStorage=true" />

      <Setting name="sql_azure_database" value="drupal" />
      <Setting name="sql_azure_username" value="drupalLogin@j2f2uoqrmd" />
      <Setting name="sql_azure_password" value="BVvvgdjs65" />
      <Setting name="sql_azure_host" value="j2f2uoqrmd.database.windows.net" />
      <Setting name="db_prefix" value="" />
      <Setting name="update_free_access" value="FALSE" />
      <Setting name="drupal_hash_salt" value="Some unique value" />
      <Setting name="base_url" value="" />
      
      <!-- For RDP access. Commented by default -->
      <Setting name="Microsoft.WindowsAzure.Plugins.RemoteAccess.Enabled" value="true" />
      <Setting name="Microsoft.WindowsAzure.Plugins.RemoteAccess.AccountUsername" value="RDAdmin" />
      <Setting name="Microsoft.WindowsAzure.Plugins.RemoteAccess.AccountEncryptedPassword" value="MIIBnQYJKoZIhvcNAQcDoIIBjjCCAYoCAQAxggFOMIIBSgIBADAyMB4xHDAaBgNVBAMME1dpbmRvd3MgQXp1cmUgVG9vbHMCEDaxSocNGM2iRQtC8o1w9HwwDQYJKoZIhvcNAQEBBQAEggEAPQmdrnOVCRj6fgK8mHHep9AuuA7rCiFPPNPvai4YGX8FtML7SK0x5Op0SoqKhZhMgEFOFstpcHFxLkN/fnKwL2ojz8sFVDNjuLUddt2AzbuPwC5ELmF2uhKqu1kPxFZKb3m8sqvtMyM1buUd8g545bNhCeOLzlL1YTW/CiDmpwYwl+SzHovSPx+8ApX6TSmizgq6h4ScpiLFk5LWCcLP50jvaPNQPgf7Wbl+k8zs6t0popnEaZpefKjZc364B95Ko8PvQGZbrDTtYxYabSHIG/SOn+bUzYOmVd23y1cGkc4BJB2XM4+6q3jIfenbKgj1Hjcs2ocrRzAuW5Py6v5wfzAzBgkqhkiG9w0BBwEwFAYIKoZIhvcNAwcECPjMHCD1PGNRgBB6G4T5FNd86FGG/UCBqKKE" />
      <Setting name="Microsoft.WindowsAzure.Plugins.RemoteAccess.AccountExpiration" value="2012-12-07T23:59:59.0000000+01:00" />
      <Setting name="Microsoft.WindowsAzure.Plugins.RemoteForwarder.Enabled" value="true" />
      </ConfigurationSettings>
    <!-- Certificate for RDP access. Commented by default --> 
    <Certificates>
      <Certificate name="Microsoft.WindowsAzure.Plugins.RemoteAccess.PasswordEncryption" thumbprint="C9D6F3C6FFB37EE967244FC7BAC7E9C362DF70BE" thumbprintAlgorithm="sha1" />
    </Certificates>
  </Role>
</ServiceConfiguration>

<?xml version="1.0" encoding="utf-8"?>
<ServiceDefinition name="PhpOnAzure" xmlns="http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceDefinition">
  <WebRole name="WebRole" enableNativeCodeExecution="true" vmsize="ExtraSmall">
    <Sites>
      <Site name="WebRole" physicalDirectory="./WebRole">
        <Bindings>
          <Binding name="Endpoint1" endpointName="HttpEndpoint" />
        </Bindings>
      </Site>
    </Sites>
    <Startup>
      <Task commandLine="install-php.cmd >> .\startup-tasks-log.txt 2>>.\startup-tasks-error-log.txt" executionContext="elevated" taskType="simple" /> 
    </Startup>
    <Endpoints>
      <InputEndpoint name="HttpEndpoint" protocol="http" port="80" />
    </Endpoints>
    <Imports>
      <Import moduleName="Diagnostics"/>

      <!-- For RDP access. Commented by default -->
      <Import moduleName="RemoteAccess"/>
      <Import moduleName="RemoteForwarder"/>
    </Imports>
    <ConfigurationSettings>
      <Setting name="sql_azure_database" />
      <Setting name="sql_azure_username" />
      <Setting name="sql_azure_password" />
      <Setting name="sql_azure_host" />
      <Setting name="db_prefix" />
      <Setting name="update_free_access" />
      <Setting name="drupal_hash_salt" />
      <Setting name="base_url" />
    </ConfigurationSettings>
  </WebRole>
</ServiceDefinition>
This is now a good time to also download a translation. In this example, we’ll donwload the French translation. Go to C’est maintenant %u00e9galement le bon moment pour t%u00e9l%u00e9charger une traduction. Dans cet exemple, nous allons prendre le fran%u00e7ais. Aller %u00e0

http://localize.drupal.org/translate/languages/fr

(http://ftp.drupal.org/files/translations/7.x/drupal/drupal-7.10.fr.po)

We also need to change a file in the package source. In the following file On doit %u00e9galement changer un fichier dans les sources du paquet de d%u00e9ploiement. Dans le fichier suivant

C:\Temp\Drupal01\WebRole\includes\database\sqlsrv\database.inc

replace the following function remplacer la fonction suivante
  /**
   * Internal function: prepare a query by calling PDO directly.
   *
   * This function has to be public because it is called by other parts of the
   * database layer, but do not call it directly, as you risk locking down the
   * PHP process.
   */
  public function PDOPrepare($query, array $options = array()) {
    if (!$this->bypassQueryPreprocess) {
      $query = $this->preprocessQuery($query);
    }
    // THIS FIX IS TEMPORARY UNTIL MICROSOFT MOVE THE IMPLEMENTATION
    // OF THIS ATTRIBUTE IN THE PDO DRIVER OPTIONS.
    // Let's emulate the attributes preparation because it costs a little
    // bit more to have it disabled than enabled and because we are not
    // leveraging the benefits of it.
    $options[PDO::ATTR_EMULATE_PREPARES] = TRUE;
    return parent::prepare($query, $options);
  }

by this one (the fix does not work with SQL Azure) par celle-ci (la correction ne fonctionne pas pour SQL Azure)
  /**
   * Internal function: prepare a query by calling PDO directly.
   *
   * This function has to be public because it is called by other parts of the
   * database layer, but do not call it directly, as you risk locking down the
   * PHP process.
   */
  public function PDOPrepare($query, array $options = array()) {
      $query = $this->preprocessQuery($query);
    return parent::prepare($query, $options);
  }

You may also want to add an SMTP Server. Windows Azure does not provide one, but it is possible to connect to an external one.
Like for other parameters, this can be done by updating the following file:
On peut aussi vouloir ajouter un serveur SMTP. Windows Azure n’en fournit pas, mais il est possible de se connecter %u00e0 un serveur externe.
Comme pour d’autres param%u00e8tres, cela peut se faire en modifiant le fichier suivant:

C:\Temp\Drupal01\WebRole\php\php.ini

 

Let’s now create the package from the package sources.
Go to C:\Temp and create a text file named package-drupal.cmd containing the following code:
Cr%u00e9ons maintenant le paquet de d%u00e9ploiement %u00e0 partir des sources du paquet de d%u00e9ploiement.
Aller %u00e0 C:\Temp et cr%u00e9er un fichier texte appel%u00e9 package-drupal.cmd contenant le code suivant:

set here=%~dp0%

package create -in=”%here%Drupal01″ -out=”%here%.” -dev=false
pause

Execute the script Ex%u00e9cuter le script
this created the Windows Azure Package (.cspkg), that goes with the .cscfg file. They will both be uploaded to Windows Azure. Cela a cr%u00e9e le paquet de d%u00e9ploiement pour Windows Azure (.cspkg), qui va avec le fichier .cscfg. Les deux devront %u00eatre d%u00e9ploy%u00e9s vers Windows Azure.
In order to deploy, go to the Windows Azure portal, Pour d%u00e9ployer, aller dans le portail Windows Azure
If you haven’t done so yet, create a hosted service. Si ce n’est d%u00e9j%u00e0 fait, cr%u00e9er un service h%u00e9berg%u00e9
Note that the choosen hosted service must be in the same region as SQL Azure and Windows Azure storage (North Europe) and it must be the same as the one used when optionally setting remote desktop. A noter: le service h%u00e9berg%u00e9 choisi doit %u00eatre dans la m%u00eame r%u00e9gion que SQL Azure et le stockage (Europe du Nord) et %u00eatre le m%u00eame que celui utilis%u00e9 lors de l’%u00e9ventuel ajout de l’acc%u00e8s au bureau %u00e0 distance.
Select the hosted service and choose to deploy Choisir le service h%u00e9berg%u00e9 et d%u00e9ployer
The two files to deploy are the ones in C:\Temp. The deployment name is whatever you choose. Les deux fichiers %u00e0 d%u00e9ployer sont ceux dans C:\temp. Le nom de d%u00e9ploiement peut %u00eatre choisi librement

After a few minutes, the application is available and can be reached at the URL shown in the portal Apr%u00e8s quelques minutes, l’application est disponible et peut %u00eatre atteinte par l’URL montr%u00e9e dans le portail
If you click on the URL you will get this error Si on clique sur l’URL, on a l’erreur suivante

PDOException: SQLSTATE[IMSSP]: An invalid statement option was specified.: SELECT SCHEMA_NAME(); Array ( ) in lock_may_be_available() (line 167 of E:\approot\includes\lock.inc).

This is because you firt need to initialize the database by running install.php. Add install.php to the URL. In our example, as the hosted service is named appazure, the URL is C’est parce qu’il faut d’abord initialiser la base en ex%u00e9cutant install.php. Ajouter install.php %u00e0 l’URL. Dans notre exemple, comme le service h%u00e9berg%u00e9 s’appelle appazure, l’URL est

http://appazure.cloudapp.net/install.php

which starts the installation wizard ce qui d%u00e9marre l’assistant d’installation

In the next page enter the drupalLogin password (BVvvgdjs65) Dans la page suivante, entrer le mot de passe du compte drupalLogin (BVvvgdjs65)

In next screen, a Drupal Admin password is created (LNdevikw03 in this example, do no try it, it is not the real one!) Dans l’%u00e9cran suivant, un mot de passe d’administrateur Drupal est cr%u00e9%u00e9 (LNdevikw03 dans cet exemple, mais l%u00e0 encore ce mot de passe n’est pas le vrai, ne pas l’essayer!)

The warning would not have happened if we had set an SMTP server in php.ini which was not done in this example.
Windows Azure does not provide an SMTP server so you need to bring one from your network provider for instance.
In this example, we ignore the warning, and we’ll receive no e-mail.
Le message d’avertissement ne serait pas apparu si on avant renseign%u00e9 plus haut le serveur SMTP dans le fichier php.ini, ce qui n’a pas %u00e9t%u00e9 fait dans cet exemple.
Windows Azure ne fournit pas de serveur SMTP donc il faut utiliser celui qu’on fournit depuis sont fournisseur d’acc%u00e8s %u00e0 Internet par exemple.
Dans cet exemple, on ignore le message d’avertissement, et l’on ne recevra pas de message.

Here is now where we give the credentials of the Windows Azure storage (drupal111205a) we created above. Voici maintenant o%u00f9 l’on entre les cr%u00e9dentit%u00e9s du compte de stockage Windows Azure (drupal111205a) que l’on avait cr%u00e9%u00e9 plus haut.

 

After publishing an article with an image, you can see that the image is stored in Windows Azure blob storage Apr%u00e8s avoir publi%u00e9 un article avec une image, on peut voir que cette image a %u00e9t%u00e9 stock%u00e9e dans un blob Windows Azure

 

Benjamin

Blog Post by: Benjamin GUINEBERTIERE