Conserver des fichiers dans Azure Cloud ShellPersist files in Azure Cloud Shell

  • 6 minutes de lecture

Cloud Shell utilise le stockage de fichiers Azure pour conserver les fichiers entre les sessions.Cloud Shell utilizes Azure File storage to persist files across sessions. Lors du premier démarrage, Cloud Shell vous invite à associer un partage de fichiers nouveau ou existant afin de conserver les fichiers entre les sessions.On initial start, Cloud Shell prompts you to associate a new or existing file share to persist files across sessions.

Notes

Bash et PowerShell utilisent le même partage de fichiers.Bash and PowerShell share the same file share. Un seul partage de fichiers peut être associé à un montage automatique dans Cloud Shell.Only one file share can be associated with automatic mounting in Cloud Shell.

Créer un stockageCreate new storage

Lorsque vous utilisez des paramètres de base et sélectionnez uniquement un abonnement, Cloud Shell crée trois ressources pour vous dans la région prise en charge la plus proche de vous :When you use basic settings and select only a subscription, Cloud Shell creates three resources on your behalf in the supported region that's nearest to you:

  • Groupe de ressources : cloud-shell-storage-<region>Resource group: cloud-shell-storage-<region>
  • Compte de stockage : cs<uniqueGuid>Storage account: cs<uniqueGuid>
  • Partage de fichiers : cs-<user>-<domain>-com-<uniqueGuid>File share: cs-<user>-<domain>-com-<uniqueGuid>

Paramètre d’abonnement

Le partage de fichiers est monté comme un clouddrive dans votre répertoire $Home.The file share mounts as clouddrive in your $Home directory. Cette opération n’a lieu qu’une seule fois, car le partage de fichiers est automatiquement monté dans les sessions suivantes.This is a one-time action, and the file share mounts automatically in subsequent sessions.

Notes

Pour la sécurité, chaque utilisateur doit approvisionner son propre compte de stockage.For security, each user should provision their own storage account. Pour le contrôle d’accès en fonction du rôle (RBAC), les utilisateurs doivent disposer d’un accès contributeur ou supérieur au niveau du compte de stockage.For role-based access control (RBAC), users must have contributor access or above at the storage account level.

Le partage de fichiers contient également une image de 5 Go. Automatiquement créée pour vous, celle-ci conserve les données dans votre répertoire $Home.The file share also contains a 5-GB image that is created for you which automatically persists data in your $Home directory. Cela vaut pour Bash et PowerShell.This applies for both Bash and PowerShell.

Utiliser les ressources existantesUse existing resources

L’option Avancé vous permet d’associer des ressources existantes.By using the advanced option, you can associate existing resources. Lorsque vous sélectionnez une région Cloud Shell, vous devez également choisir un compte de stockage de sauvegarde dans cette région.When selecting a Cloud Shell region you must select a backing storage account co-located in the same region. Par exemple, si votre région affectée est USA Ouest, vous devez alors associer un partage de fichiers qui se trouve également dans USA Ouest.For example, if your assigned region is West US than you must associate a file share that resides within West US as well.

Lorsque l’invite de configuration du stockage s’affiche, sélectionnez Afficher les paramètres avancés pour visualiser des options supplémentaires.When the storage setup prompt appears, select Show advanced settings to view additional options. Les options de stockage renseignées filtrent les comptes de stockage localement redondant (LRS), de stockage géoredondant (GRS) et de stockage redondant interzone (ZRS).The populated storage options filter for locally redundant storage (LRS), geo-redundant storage (GRS), and zone-redundant storage (ZRS) accounts.

Notes

Il est recommandé d’utiliser des comptes de stockage GRS ou ZRS afin d’offrir une résilience supplémentaire pour votre partage de fichiers de sauvegarde.Using GRS or ZRS storage accounts are recommended for additional resiliency for your backing file share. Le type de redondance dépend de vos objectifs et de votre budget.Which type of redundancy depends on your goals and price preference. En savoir plus sur les options de réplication pour les comptes de Stockage Azure.Learn more about replication options for Azure Storage accounts.

Paramètre Groupe de ressources

Régions de stockage prises en chargeSupported storage regions

Les comptes de stockage Azure associées doivent résider dans la même région que la machine Cloud Shell sur laquelle le montage est effectué.Associated Azure storage accounts must reside in the same region as the Cloud Shell machine that you're mounting them to. Pour déterminer votre région actuelle, vous pouvez exécuter env dans Bash et localiser la variable ACC_LOCATION.To find your current region you may run env in Bash and locate the variable ACC_LOCATION. Les partages de fichiers reçoivent une image de 5 Go créée pour conserver votre répertoire $Home.File shares receive a 5-GB image created for you to persist your $Home directory.

Les machines Cloud Shell existent dans les régions suivantes :Cloud Shell machines exist in the following regions:

DomaineArea RégionRegion
AmériqueAmericas USA Est, USA Centre Sud, USA OuestEast US, South Central US, West US
EuropeEurope Europe Nord, Europe OuestNorth Europe, West Europe
Asie-PacifiqueAsia Pacific Inde Centre, Asie Sud-EstIndia Central, Southeast Asia

Restreindre la création de ressources avec une stratégie de ressource AzureRestrict resource creation with an Azure resource policy

Les comptes de stockage que vous créez dans Cloud Shell sont identifiés à l’aide de la balise ms-resource-usage:azure-cloud-shell.Storage accounts that you create in Cloud Shell are tagged with ms-resource-usage:azure-cloud-shell. Si vous souhaitez interdire aux utilisateurs de créer des comptes de stockage par le biais de Cloud Shell, créez une stratégie de ressource Azure pour les balises déclenchée par cette balise spécifique.If you want to disallow users from creating storage accounts in Cloud Shell, create an Azure resource policy for tags that are triggered by this specific tag.

Fonctionnement du stockage Cloud ShellHow Cloud Shell storage works

Cloud Shell conserve les fichiers à l’aide des deux méthodes suivantes :Cloud Shell persists files through both of the following methods:

  • Création d’une image disque de votre répertoire $Home pour conserver la totalité du contenu figurant dans le répertoire.Creating a disk image of your $Home directory to persist all contents within the directory. Cette image disque est enregistrée dans votre partage de fichiers spécifié en tant que acc_<User>.img à l’emplacement fileshare.storage.windows.net/fileshare/.cloudconsole/acc_<User>.img et synchronise automatiquement les modifications.The disk image is saved in your specified file share as acc_<User>.img at fileshare.storage.windows.net/fileshare/.cloudconsole/acc_<User>.img, and it automatically syncs changes.
  • Montage du partage de fichiers spécifié en tant que clouddrive dans votre répertoire $Home pour l’interaction directe avec le partage de fichiers.Mounting your specified file share as clouddrive in your $Home directory for direct file-share interaction. /Home/<User>/clouddrive est mappé à fileshare.storage.windows.net/fileshare./Home/<User>/clouddrive is mapped to fileshare.storage.windows.net/fileshare.

Notes

Tous les fichiers figurant dans votre répertoire $Home, tels que les clés SSH, sont conservés dans l’image disque utilisateur qui est stockée dans votre partage de fichiers monté.All files in your $Home directory, such as SSH keys, are persisted in your user disk image, which is stored in your mounted file share. Appliquez les bonnes pratiques lors de la conservation d’informations dans votre répertoire $Home et votre partage de fichiers monté.Apply best practices when you persist information in your $Home directory and mounted file share.

Commandes CloudDriveclouddrive commands

Utiliser la commande clouddriveUse the clouddrive command

Dans Cloud Shell, vous pouvez exécuter une commande appelée clouddrive, qui vous permet de mettre à jour manuellement le partage de fichiers qui est monté dans Cloud Shell.In Cloud Shell, you can run a command called clouddrive, which enables you to manually update the file share that is mounted to Cloud Shell. Utilisation de la commande clouddriveRunning the "clouddrive" command

Liste clouddriveList clouddrive

Pour détecter le partage de fichiers monté comme clouddrive, exécutez la commande df.To discover which file share is mounted as clouddrive, run the df command.

Le chemin de fichier vers clouddrive affiche le nom de votre compte de stockage et le partage de fichiers dans l’URL.The file path to clouddrive shows your storage account name and file share in the URL. Par exemple, //storageaccountname.file.core.windows.net/filesharenameFor example, //storageaccountname.file.core.windows.net/filesharename

justin@Azure:~$ df
Filesystem                                          1K-blocks   Used  Available Use% Mounted on
overlay                                             29711408 5577940   24117084  19% /
tmpfs                                                 986716       0     986716   0% /dev
tmpfs                                                 986716       0     986716   0% /sys/fs/cgroup
/dev/sda1                                           29711408 5577940   24117084  19% /etc/hosts
shm                                                    65536       0      65536   0% /dev/shm
//mystoragename.file.core.windows.net/fileshareName 5368709120    64 5368709056   1% /home/justin/clouddrive
justin@Azure:~$

Monter un nouveau clouddriveMount a new clouddrive

Prérequis pour le montage manuelPrerequisites for manual mounting

Vous pouvez mettre à jour le partage de fichiers qui est associé à Cloud Shell à l’aide de la commande clouddrive mount.You can update the file share that's associated with Cloud Shell by using the clouddrive mount command.

Si vous montez un partage de fichiers existant, les comptes de stockage doivent se trouver dans la région Cloud Shell de votre choix.If you mount an existing file share, the storage accounts must be located in your select Cloud Shell region. Récupérez l’emplacement en exécutant la commande env et en vérifiant ACC_LOCATION.Retrieve the location by running env and checking the ACC_LOCATION.

La commande clouddrive mountThe clouddrive mount command

Notes

Si vous montez un nouveau partage de fichiers, une nouvelle image utilisateur est créée pour votre répertoire $Home.If you're mounting a new file share, a new user image is created for your $Home directory. L’image précédente $Home est conservée dans le partage de fichier précédent.Your previous $Home image is kept in your previous file share.

Exécutez la commande clouddrive mount avec les paramètres suivants :Run the clouddrive mount command with the following parameters:

clouddrive mount -s mySubscription -g myRG -n storageAccountName -f fileShareName

Pour afficher plus de détails, exécutez clouddrive mount -h, comme illustré ici :To view more details, run clouddrive mount -h, as shown here:

Exécution de la commande clouddrive mount

Démontage de clouddriveUnmount clouddrive

Vous pouvez démonter un partage de fichiers monté sur Cloud Shell à tout moment.You can unmount a file share that's mounted to Cloud Shell at any time. Dans la mesure où Cloud Shell requiert l’utilisation d’un partage de fichiers monté, vous serez invité à créer et monter un autre partage de fichiers lors de la prochaine session.Since Cloud Shell requires a mounted file share to be used, you will be prompted to create and mount another file share on the next session.

  1. Exécutez clouddrive unmount.Run clouddrive unmount.
  2. Acceptez et confirmez les invites.Acknowledge and confirm prompts.

Votre partage de fichiers continue d’exister, tant que vous ne le supprimez pas manuellement.Your file share will continue to exist unless you delete it manually. Cloud Shell ne fera plus de recherche pour ce partage de fichiers lors des sessions ultérieures.Cloud Shell will no longer search for this file share on subsequent sessions. Pour afficher plus de détails, exécutez clouddrive unmount -h, comme illustré ici :To view more details, run clouddrive unmount -h, as shown here:

Exécution de la commande clouddrive unmount

Avertissement

L’exécution de cette commande ne va pas supprimer de ressources. Toutefois, la suppression manuelle d’un groupe de ressources, d’un compte de stockage ou d’un partage de fichiers mappé à Cloud Shell efface votre image disque du répertoire $Home, ainsi que tous les autres fichiers présents dans votre partage de fichiers.Although running this command will not delete any resources, manually deleting a resource group, storage account, or file share that's mapped to Cloud Shell erases your $Home directory disk image and any files in your file share. Il est impossible d’annuler cette opération.This action cannot be undone.

Commandes PowerShell spécifiquesPowerShell-specific commands

Répertorier les partages de fichiers Azure clouddriveList clouddrive Azure file shares

La cmdlet Get-CloudDrive récupère les informations du partage de fichiers Azure actuellement monté par le clouddrive dans Cloud Shell.The Get-CloudDrive cmdlet retrieves the Azure file share information currently mounted by the clouddrive in the Cloud Shell.
Exécution de Get-CloudDriveRunning Get-CloudDrive

Démonter clouddriveUnmount clouddrive

Vous pouvez démonter un partage de fichiers Azure monté sur Cloud Shell à tout moment.You can unmount an Azure file share that's mounted to Cloud Shell at any time. En cas de suppression du partage de fichiers Azure, vous serez invité à créer et à monter un nouveau partage de fichiers Azure lors de la prochaine session.If the Azure file share has been removed, you will be prompted to create and mount a new Azure file share at the next session.

La cmdlet Dismount-CloudDrive démonte un partage de fichiers Azure à partir du compte de stockage actuel.The Dismount-CloudDrive cmdlet unmounts an Azure file share from the current storage account. Le démontage du clouddrive met fin à la session active.Dismounting the clouddrive terminates the current session. L’utilisateur sera invité à créer et monter un nouveau partage de fichiers Azure lors de la prochaine session.The user will be prompted to create and mount a new Azure file share during the next session. Exécution de Dismount-CloudDriveRunning Dismount-CloudDrive

Transférer des fichiers locaux vers Cloud ShellTransfer local files to Cloud Shell

Le répertoire clouddrive se synchronise dans le panneau Stockage du portail Azure.The clouddrive directory syncs with the Azure portal storage blade. Utilisez ce panneau pour échanger des fichiers avec votre partage de fichiers.Use this blade to transfer local files to or from your file share. La mise à jour des fichiers à partir de Cloud Shell se reflète dans l’interface graphique du stockage de fichiers quand vous actualisez le panneau.Updating files from within Cloud Shell is reflected in the file storage GUI when you refresh the blade.

Télécharger des fichiersDownload files

Liste de fichiers locaux

  1. Dans le portail Azure, accédez au partage de fichiers monté.In the Azure portal, go to the mounted file share.
  2. Sélectionnez le fichier cible.Select the target file.
  3. Cliquez sur le bouton Télécharger.Select the Download button.

Charger des fichiersUpload files

Fichiers locaux à charger

  1. Accédez au partage de fichiers monté.Go to your mounted file share.
  2. Cliquez sur le bouton Charger.Select the Upload button.
  3. Sélectionnez le ou les fichiers que vous souhaitez charger.Select the file or files that you want to upload.
  4. Confirmez le chargement.Confirm the upload.

Vous devriez à présent voir les fichiers accessibles dans votre répertoire clouddrive dans Cloud Shell.You should now see the files that are accessible in your clouddrive directory in Cloud Shell.

Remarque : Si vous devez définir une fonction dans un fichier et l'appeler à partir des cmdlets PowerShell, l’opérateur point doit être inclus.Note: If you need to define a function in a file and call it from the PowerShell cmdlets, then the dot operator must be included. Par exemple : .For example: . .\MyFunctions.ps1.\MyFunctions.ps1

Étapes suivantesNext steps

Démarrage rapide de Cloud ShellCloud Shell Quickstart
En savoir plus sur le stockage de fichiers Microsoft AzureLearn about Microsoft Azure Files storage
En savoir plus sur les balises de stockageLearn about storage tags