You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/app-service/overview-local-cache.md
+9-6Lines changed: 9 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -37,12 +37,7 @@ The Azure App Service Local Cache feature provides a web role view of your conte
37
37
38
38
## How the local cache changes the behavior of App Service
39
39
*_D:\home_ points to the local cache, which is created on the VM instance when the app starts up. _D:\local_ continues to point to the temporary VM-specific storage.
40
-
* The local cache contains a one-time copy of the _/site_ and _/siteextensions_ folders of the shared content store, at _D:\home\site_ and _D:\home\siteextensions_, respectively. The files are copied to the local cache when the app starts. The size of the two folders for each app is limited to 1 GB by default, but can be increased to 2 GB. Note that as the cache size increases, it will take longer to load the cache. If you've increased local cache limit to 2 GB and the copied files exceed the maximum size of 2 GB, App Service silently ignores local cache and reads from the remote file share. For deployment and swapping operations, if no limit is defined or if the copied files exceed the defined limit, the operation may fail with an error. See the table below for more information.<br/>
41
-
|**Local Cache size**|**Coped files**|**Result**|
42
-
| --- | --- | --- |
43
-
|≤ 2 GB|≤ Local Cache size|Reads from local cache.|
44
-
|≤ 2 GB|> Local Cache size|Reads from remote share.<br/> **Note:** When copied files exceed the Local Cache size limit, deployment and swap operations may fail with an error.|
45
-
40
+
* The local cache contains a one-time copy of the _/site_ and _/siteextensions_ folders of the shared content store, at _D:\home\site_ and _D:\home\siteextensions_, respectively. The files are copied to the local cache when the app starts. The size of the two folders for each app is limited to 1 GB by default, but can be increased to 2 GB. Note that as the cache size increases, it will take longer to load the cache. If you've increased local cache limit to 2 GB and the copied files exceed the maximum size of 2 GB, App Service silently ignores local cache and reads from the remote file share. Note that deployment and swapping operations may fail with an error when no limit is defined or if the copied files exceed the defined limit. See the FAQ for more information.
46
41
* The local cache is read-write. However, any modification is discarded when the app moves virtual machines or gets restarted. Do not use the local cache for apps that store mission-critical data in the content store.
47
42
*_D:\home\LogFiles_ and _D:\home\Data_ contain log files and app data. The two subfolders are stored locally on the VM instance, and are copied to the shared content store periodically. Apps can persist log files and data by writing them to these folders. However, the copy to the shared content store is best-effort, so it is possible for log files and data to be lost due to a sudden crash of a VM instance.
48
43
*[Log streaming](troubleshoot-diagnostic-logs.md#stream-logs) is affected by the best-effort copy. You could observe up to a one-minute delay in the streamed logs.
@@ -106,6 +101,14 @@ We recommend that you use Local Cache in conjunction with the [Staging Environme
106
101
107
102
## Frequently asked questions (FAQ)
108
103
104
+
### What if the Local Cache size exceeds the size limit?
105
+
When the copied files exceed the Local Cache size limit, deployment and swap operations may fail with an error. See the table below for size limits and results.
106
+
107
+
|**Local Cache size**|**Coped files**|**Result**|
108
+
| --- | --- | --- |
109
+
|≤ 2 GB|≤ Local Cache size|Reads from local cache.|
110
+
|≤ 2 GB|> Local Cache size|Reads from remote share.<br/> **Note:** Deployment and swap operations may fail with an error.|
111
+
109
112
### How can I tell if Local Cache applies to my app?
110
113
If your app needs a high-performance, reliable content store, does not use the content store to write critical data at runtime, and is less than 2 GB in total size, then the answer is "yes"! To get the total size of your /site and /siteextensions folders, you can use the site extension "Azure Web Apps Disk Usage."
0 commit comments