Azure Files

Aperçu

Azure Files est un service dans le cloud qui offre un service de sauvegarde de stockage pour les instances de WorkflowGen hébergées dans le cloud Azure ou sur place via un partage de fichiers utilisant le procotole SMB standard. Ce service fournit plusieurs bonnes options pour L'accès au données, le partage, la synchronisation et la redondance pour usage dans des scénarios d'une ou de plusieurs instances de WorkflowGen.

Pour plus d'informations sur les avantages ou des cas d'usage d'Azure Files, voir le guide de Microsoft Présentation d'Azure Files.

La section suivante contient des instructions et des recommandations sur la configuration d'un partage Azure Files pour utiliser dans WorkflowGen.

Recommandations

Avant de choisir Azure Files comme le service de sauvegarde de stockage principal pour votre WorkflowGen, il faut examiner quelques scénarios de configuration de performance pour votre stockage des données :

  • Dans une configuration avec une seule instance de WorkflowGen

    • Hébergée sur une machine virtuelle Azure :

      • Pour la meilleure performance, utilisez un disque SSD local.

      • Pour une bonne performance, utilisez un partage d'Azure Files dans votre région géographique.

    • Hébergée sur place :

      • Pour la meilleure performance, utilisez un disque SSD local.

      • Pour une performance de base, utilisez un partage Azure Files dans la région géographique la plus proche de votre serveur pour la plus basse latence.

  • Dans une configuration « web farm » (batterie de serveurs Web)

    • Hébergée sur une machine virtuelle Azure :

      • Pour la meilleure performance, utilisez un partage de fichiers sur un serveur de fichiers assuré par le stockage SSD.

        Note : Un des serveurs Web WorkflowGen ou une machine virtuelle dédiée peut agir en tant que serveur de fichiers.

      • Pour une bonne performance, utilisez un partage Azure Files dans votre région géographique.

    • Hébergée sur place :

      • Pour la meilleure performance, utilisez un partage sur un serveur de fichiers assuré par le stockage SSD. Note : Un des serveurs WorkflowGen ou un serveur dédié peut agir en tant que serveur de fichiers.

      • Pour une performance de base, utilisez un partage Azure Files dans la région géographique la plus proche de votre serveur pour la plus basse latence.

Configuration d'Azure Files pour WorkflowGen

Prérequis

  • Assurez-vous d'avoir une instance de WorkflowGen en fonctionnement avec accès Internet.

  • Assurez-vous de connaître l'adresse de l'instance.

  • Le port TCP 445 doit être ouvert pour la sortie de l'instance.

  • La version 5.1 ou supérieure de Windows PowerShell est requise sur l'instance pour effectuer une des étapes de la configuration.

  • Une inscription Azure active.

  • Vous devez avoir les permissions requises pour modifier le Windows de l'instance de WorkflowGen, p.ex. le privilège administrateur.

  • Vous devez avoir les permissions requises pour modifier les comptes du service de stockage dans le portal Azure.

Étape 1 : Créez un compte de stockage dans Azure

Via le portail Azure

  1. Dans le portail Azure, sélectionnez le service Storage accounts.

  2. Ajoutez un nouveau compte de stockage.

  3. Saisissez un nom.

    Note : Le nom de compte de stockage wfgendatastorage sera utilisé comme exemple dans cette section.

  4. Account kind : Choisissez Storage (general purpose v1) ou StorageV2 (general purpose v2).

  5. Location : Choisissez un emplacement dans la même region de votre machine virtuelle Azure, ou celui le plus proche de votre emplacement.

  6. Performance : Choisissez Standard.

  7. Choisissez votre abonnement.

  8. Créez un nouveau groupe de ressources.

    Note : Le nom de groupe de ressources wfgenresourcegroup sera utilisé dans cette section.

  9. Vous pouvez laisser le reste des configurations réglées sur leurs valeurs par défaut ou vous pouvez les personnaliser selon vos besoins.

  10. Cliquez sur Create.

Pour plus d'informations sur les comptes de stockage, voir l'article À propos des comptes de stockage Azure.

Via Azure CLI

Pour créer un compte de stockage via Azure CLI (interface de ligne de commande Azure), connectez-vous d'abord à votre compte Azure avec Azure CLI.

Le script suivant crée un compte de stockage dans Azure. La variable de nom de groupe de ressources ($resourceGroup) et la variable de compte de stockage ($storageAccount) doivent être mises à jour.

# Configuration variables
$location="East US"
$resourceGroup="wfgenresourcegroup"
$storageAccount="wfgendatastorage"
# Create a Storage account
az storage account create `
--name $storageAccount `
--resource-group $resourceGroup `
--location $location

Étape 2 : Créez un partage de fichiers dans Azure

Via le portail Azure

  1. Dans le service Storage accounts, choisissez wfgendatastorage.

  2. Dans la section Overview ou la section FILE SERVICE, choisissez Files.

  3. Ajoutez un nouveau File share.

  4. Saisissez un nom.

    Note :  Le nom de stockage wfgenshare sera utilisé comme exemple dans cette section.

  5. Saisissez un quota selon vos besoins.

  6. Cliquez sur OK.

Pour plus d'informations sur le partage des fichiers, voir l''article Créer un partage de fichiers.

Via Azure CLI

Pour créer un partage de fichiers via Azure CLI, connectez-vous d'abord à votre compte Azure avec Azure CLI.

Le script suivant crée un partage de fichiers dans Azure. La variable de compte de stockage ($storageAccount) et la variable de partage de fichier ($share) doivent être mises à jour.

# Configuration variables
$storageAccount="wfgendatastorage"
$share="wfgenshare"
# Create the file shares
az storage share create `
--name $share `
--account-name $storageAccount `

Étape 3 : Montez le partage de fichiers dans le serveur Web de WorkflowGen

  1. Connectez-vous à votre instance de WorkflowGen depuis votre compte d'administration.

  2. Lancez une instance de Windows PowerShell 5.1 en tant qu'administrateur.

  3. Testez le port TCP 445 pour la sortie en exécutant la commande suivantes dans PowerShell :

    Test-NetConnection -ComputerName "wfgendatastorage.file.core.windows.net" -Port 445

    Note : Assurez-vous de remplacer wfgendatastorage dans les instructions ci-dessus par votre nom de compte de stockage.

    Si le test réussit, continuez à la prochaine étape. Sinon, contactez votre administrateur de réseau pour ouvrir le port TCP 445 pour la sortie.

  4. Installez ou mettez à jour le module d'Azure PowerShell dans PowerShell :

    Install-Module -Name Az -AllowClobber
    Import-Module -Name Az

    Pour plus d'informations, voir l'article Installer Azure PowerShell sur Windows avec PowerShellGet.

  5. Dans la console de gestion de l'ordinateur de Windows, créez un utilisateur local en tant que compte de service qui sera utilisé pour le pool d'applications IIS de WorkflowGen :

    1. Saisissez un nouveau nom d'utilisateur et un nouveau mot de passe.

      Note : Le nom d'utilisateur wfgen_service sera utilisé comme exemple dans cette section.

    2. Cochez User cannot change password.

    3. Cochez Password never expires.

    4. Cliquez sur Create.

    5. Affectez l'utilisateur wfgen_service au groupe IIS_IUSRS.

    6. Affectez l'utilisateur au groupe Remote Desktop Users si l'instance est hébergée sur un serveur distant.

  6. Connectez-vous à votre instance de WorkflowGen depuis le compte wfgen_service.

  7. Ouvrez une instance de Windows PowerShell 5.1 en tant qu'administrateur.

  8. Connectez-vous à votre compte Microsoft Azure dans PowerShell :

    Connect-AzAccount

    Si vous rencontrez des problèmes de sécurité lors de la procédure de connexion à Microsoft Azure, vous devez ajouter manuellement https://login.microsoftonline.com/ et tous les URIs des sites Web associés à la zone des sites approuvés dans les options d'Internet Explorer.

  9. Dans la fenêtre Microsoft Azure, connectez-vous au compte Azure que vous avez utilisé pour créer votre compte de stockage.

    Si vous vous êtes connecté à votre compte Azure avec succès, PowerShell va afficher les informations suivantes :

    Account : <votre-nom-de-compte-microsoft-azure>
    SubscriptionName : <votre-nom-d'abonnement>
    TenantId : <votre-id-locataire>
    Environment : AzureCloud
  10. Persistez les informations d'identification (« credential ») dans Windows pour le compte wfgen_service dans PowerShell :

    $resourceGroupName = "wfgenresourcegroup"
    $storageAccountName = "wfgendatastorage"
    $storageAccount = Get-AzStorageAccount -ResourceGroupName $resourceGroupName -Name $storageAccountName
    $storageAccountKeys = Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName
    Invoke-Expression -Command "cmdkey /add:$([System.Uri]::new($storageAccount.Context.FileEndPoint).Host) /user:AZURE\$($storageAccount.StorageAccountName) /pass:$($storageAccountKeys[0].Value)"

    Note : Assurez-vous de remplacer wfgendatastorage et wfgenresourcegroup dans les instructions ci-dessus par votre nom de compte de stockage et votre nom de groupe de ressources.

    Les informations d'identification doivent être persistées pour le compte wfgen_service en cas de redémarrage du serveur Windows.

    Si les informations d'identification sont enregistrées avec succès, le message suivant devrait être affiché :

    CMDKEY: Credential added successfully.
  11. Vérifiez si les informations d'identité ont été enregistrées pour la compte de stockage dans PowerShell :

    cmdkey /list

    Si l'enregistrement est réussi, vous devriez ensuite voir :

    Target: Domain:target=wfgendatastorage.file.core.windows.net
    Type: Domain Password
    User: AZURE\wfgendatastorage
  12. Testez le partage Azure Files dans l'explorateur de fichiers de Windows.

    \\wfgendatastorage.file.core.windows.net\wfgenshare

    Note : Assurez-vous de remplacer wfgendatastorage et wfgenshare dans les instructions ci-dessus par votre nom de compte de stockage et votre nom de partage de fichiers.

Pour plus d'informations sur le partage de fichiers dans Windows, voir l'article Utiliser un partage de fichiers Azure avec Windows.

Étape 4 : Configurez WorkflowGen pour l'utilisation du partage de fichiers

  1. Connectez-vous à votre instance de WorkflowGen depuis votre compte d'administration.

  2. Ouvrez la console Gestionnaire IIS.

  3. Modifiez le pool d'applications de WorkflowGen pour utiliser le compte personnalisé wfgen_service avec les réglages suivants :

    • Identity : wfgen_service

    • Load User Profile : True

  4. Enregistrez les modifications, puis redémarrez IIS.

  5. Connectez-vous à votre instance de WorkflowGen depuis le compte wfgen_service.

  6. Copiez tous les fichiers de WorkflowGen au partage Azure Files dans PowerShell :

    Copy-Item -Path "C:\inetpub\wwwroot\wfgen\App_Data" -Recurse -Destination "\\wfgendatastorage.file.core.windows.net\wfgenshare" -Container

    Note : Assurez-vous de remplacer C:\inetpub\wwwroot\wfgen\App_Data, wfgendatastorage et wfgenshare dans les instructions ci-dessus par le nom du dossier App_Data, le nom de votre compte de stockage et le nom de votre partage de fichiers de votre instance de WorkflowGen.

  7. Mettez à jour le fichier de configuration Web de WorkflowGen :

    <add key="ApplicationDataPath" value="\\wfgendatastorage.file.core.windows.net\wfgenshare\App_Data" />

    Note : Assurez-vous de remplacer wfgendatastorage et wfgenshare dans les instructions ci-dessus par le nom de votre compte de stockage et le nom de votre partage de fichiers de votre instance de WorkflowGen.

  8. Ouvrez le module d'administration ou le portail utilisateur de WorkflowGen et lancer un nouveau test de demande.

Annexe : Affichage du contenu des partages Azure Files

Utilisez une des méthodes suivantes :

  • Dans votre compte de stockage dans le portail Azure :

    • Utilisez l'outil Storage Explorer (preview) (Explorateur du stockage)

      ou

    • Naviguez dans le partage de fichiers wfgenshare sous la section Files.

    OU

  • Montez le partage de fichiers wfgenshare dans Windows :

    1. Naviguez au partage de fichiers wfgenshare dans la section Files.

    2. Cliquez sur Connect pour afficher un onglet avec des instructions de connexion.

    Par exemple, pour monter le partage de fichiers sur le disque Z depuis le compte d'administration de l'instance de WorkflowGen, exécutez les instructions suivantes fournies sur l'onglet Connect dans PowerShell :

    $acctKey = ConvertTo-SecureString -String "aftEV8YUKljZeiwKP9Ts/kZysDASFVFsvSqAvWVjMb3E+QP4BWpVSNLVyqB2ScZjGtEIg/k0P7WBIg==" -AsPlainText -Force
    $credential = New-Object System.Management.Automation.PSCredential -ArgumentList "Azure\wfgendatastorage", $acctKey
    New-PSDrive -Name Z -PSProvider FileSystem -Root "\\wfgendatastorage.file.core.windows.net\wfgenshare" -Credential $credential -Persist

    Note : Assurez-vous de remplacer la chaîne key assignée à $acctKey, wfgendatastorage et wfgenshare dans les instructions ci-dessus par un de vos noms Access keys, un de vos noms storage account et un de vos noms file shares de votre compte de stockage.

Vous devriez maintenant pouvoir parcourir le contenu du disque Z dans l'explorateur de fichiers de Windows.

Si vous rencontrez des problèmes, voir l'article Résoudre les problèmes liés à Azure Files sous Windows.