Skip to content

Commit c8a0f5a

Browse files
committed
Update FAQ for 'Where are my files?'
1 parent 0ea32fb commit c8a0f5a

File tree

1 file changed

+19
-12
lines changed

1 file changed

+19
-12
lines changed

articles/cloud-shell/faq-troubleshooting.md

Lines changed: 19 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: This article answers common questions and explains how to troubleshoot Cloud Shell issues.
33
ms.contributor: jahelmic
4-
ms.date: 11/08/2023
4+
ms.date: 08/14/2024
55
ms.topic: troubleshooting
66
tags: azure-resource-manager
77
ms.custom: has-azure-ad-ps-ref
@@ -60,23 +60,30 @@ your anticipated usage date.
6060
### I created some files in Cloud Shell, but they're gone. What happened?
6161

6262
The machine that provides your Cloud Shell session is temporary and is recycled after your session
63-
is inactive for 20 minutes. Cloud Shell uses an Azure fileshare mounted to the `clouddrive` folder
64-
in your session. The fileshare contains the image file that contains your `$HOME` directory. Only
65-
files that you upload or create in the `clouddrive` folder are persisted across sessions. Any files
66-
created outside your `clouddrive` directory aren't persisted.
63+
is inactive for 20 minutes.
6764

68-
Files stored in the `clouddrive` directory are visible in the Azure portal using Storage browser.
69-
However, any files created in the `$HOME` directory are stored in the image file and aren't visible
70-
in the portal.
65+
When you started Cloud Shell the first time, you were prompted to choose a storage option.
66+
67+
- If you chose the **Mount storage account** option, Cloud Shell mounts an Azure fileshare to the
68+
`clouddrive` folder in your session. Files stored in the `clouddrive` folder are visible in the
69+
Azure portal using Storage browser. Files stored in the `clouddrive` folder persist across
70+
sessions.
71+
72+
- If you chose the **No storage account required** option, you can only write files to your `$HOME`
73+
folder.
74+
75+
In both scenarios, you can write files to the `$HOME` folder. However, the `$HOME` folder only
76+
exists in the Cloud Shell container image that you're currently using. Files in the `$HOME` folder
77+
aren't visible in the Storage browser and are deleted when your session ends.
7178

7279
### I create a file in the Azure: drive, but I don't see it. What happened?
7380

74-
PowerShell users can use the `Azure:` drive to access Azure resources. The `Azure:` drive is created
75-
by a PowerShell provider that structures data as a file system drive. The `Azure:` drive is a
76-
virtual drive that doesn't allow you to create files.
81+
Cloud Shell loads a PowerShell provider for Azure that presents Azure resource data as a file system
82+
drive. PowerShell users can use the `Azure:` drive to access Azure resources. The `Azure:` drive is
83+
a virtual drive that doesn't allow you to create files.
7784

7885
Files that you create a new file using other tools, such as `vim` or `nano` while your current
79-
location is the `Azure:` drive, are saved to your `$HOME` directory.
86+
location is the `Azure:` drive, are saved to your `$HOME` folder.
8087

8188
### I want to install a tool in Cloud Shell that requires `sudo`. Is that possible?
8289

0 commit comments

Comments
 (0)