Téléchargement de blobs vers Optimizely DXP via PowerShell / Perficient

Nous avons eu un client qui est passé d’une instance On-Prem v11 Optimizely à DXP v12 et nous avons eu de nombreux blobs (plus de 40 Go) à télécharger vers DXP dans le cadre de la conversion.

C’était ma première expérience de mise à niveau à la fois d’une version et d’un environnement et je me suis fortement appuyé sur le support d’Optimizely pour m’aider à bien faire les choses. En cours de route, j’ai noté chaque étape afin de pouvoir y faire référence pour tout projet futur faisant de même. Peut-être que quelqu’un d’autre sera dans la même situation et pourra également bénéficier de ce didacticiel.

Les blobs et la base de données peuvent désormais être téléchargés vers DXP directement dans PowerShell.

Pour télécharger des blobs vers DXP via PowerShell

1. Obtenir l’emplacement des blobs
   1. Recherchez le dossier sur votre ordinateur où se trouvent les blobs et décompressez.
   2. Notez le chemin de ce dossier (c’est-à-dire « C:\source\MyProject\MyProject.Web\App_Data\blobs »).
   3. (Important) Assurez-vous que le chemin se termine par « \* » afin de copier uniquement le contenu du dossier blob et non le dossier lui-même (c’est-à-dire « C:\source\MyProject\MyProject.Web\App_Data\blobs\* »).
   4. Ce chemin complet sera appelé ultérieurement $BLOB_LOCATION.
2. Obtenez AzCopy de Microsoft
   1. Téléchargez AzCopy depuis Microsoft (https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azcopy-v10#download-azcopy).
   2. Extrayez l’exécutable dans un dossier sur votre ordinateur.
   3. Parcourez les fichiers extraits pour trouver l’exécutable « azcopy.exe ».
   4. Write down the location of the executable (ie “%USERPROFILE%\Downloads\azcopy_windows_amd64_10.23.0\azcopy_windows_amd64_10.23.0\” or “C:\Users\Me\Downloads\azcopy_windows_amd64_10.23.0\azcopy_windows_amd64_10.23.0\”).
3. Demandez à Opti (services gérés ?) de fournir une URL/authentification SAS temporaire. Ceci sera appelé plus tard $SAS_URL.
   1. Prenez note du nom du conteneur trouvé dans l’URL SAS (« https://*.blob.core.windows.net/MYCONTAINERNAME »).
4. Remplissez la commande azcopy en utilisant les valeurs des étapes 1.4 et 3.

   azcopy copy "$BLOB_LOCATION" "$SAS_URL" --recursive=true

   Exemple:

   azcopy copy "C:\source\MyProject\MyProject.Web\App_Data\blobs\*" "https://mysite.blob.core.windows.net/MYCONTAINERNAME?sp..." --recursive=true

5. Ouvrez une fenêtre PowerShell et accédez au dossier à partir de l’étape 2.4.
6. Collez la commande azcopy de l’étape 4 et exécutez-la.
7. Assurez-vous d’avoir les éléments suivants dans votre Startup.cs

public void ConfigureServices(IServiceCollection services)
{
    services.AddAzureBlobProvider(o =>
    {
        o.ContainerName = "MYCONTAINERNAME";
    });
    services.AddAzureEventProvider();
}