[SVLS-9100] docs(aas): Function App slot install guidance and MoveDirectory troubleshooting#36956
Merged
Merged
Conversation
Contributor
Lewis-E
force-pushed
the
fix/455-function-app-install-docs
branch
2 times, most recently
from
May 22, 2026 17:25
f4c4659 to
dedc8a0
Compare
7 tasks
Lewis-E
force-pushed
the
fix/455-function-app-install-docs
branch
from
May 22, 2026 17:53
dedc8a0 to
3d4a826
Compare
Lewis-E
changed the title
Lewis-E
force-pushed
the
fix/455-function-app-install-docs
branch
2 times, most recently
from
May 22, 2026 18:35
d47d984 to
1257b9d
Compare
Lewis-E
force-pushed
the
fix/455-function-app-install-docs
branch
from
May 22, 2026 18:37
1257b9d to
87c3754
Compare
Lewis-E
marked this pull request as ready for review
May 22, 2026 18:44
Contributor
|
Created DOCS-14491 for a review. |
ava-silver
requested changes
May 27, 2026
ava-silver
left a comment
ava-silver
left a comment
Contributor
There was a problem hiding this comment.
Refactor (shortcode extraction) and new Function App page look good. A few content issues to address before merge — flagged inline. Wording/style I'll leave for the editorial pass.
Verified separately against the companion repo: the script's -SlotName + Function App auto-applies WEBSITE_PRIVATE_EXTENSIONS=0 as a sticky slot setting (script v2.0.0, lines 84–88), and all referenced install-template/script paths exist in master.
…roubleshooting - Add 'Install on Azure Function Apps' section with Bicep/ARM/PowerShell tabs covering WEBSITE_PRIVATE_EXTENSIONS=0 sticky slot workaround for issue #455 - Add MoveDirectory error troubleshooting entry - Update ARM template link from ARM/ to install-templates/ (companion rename in aas-extension repo) - Document -SlotName parameter in PowerShell section Co-Authored-By: Claude Sonnet 4.6 (1M context) <[email protected]>
…ot templates Brings Bicep and ARM snippets in dotnet_extension.md in line with the install-function-app-slot templates in datadog-aas-extension#457. The original snippets used a hardcoded single-element array for slotConfigNames, which would silently de-sticky any pre-existing slot settings. The templates now use union()/createArray() with an explicit existingStickyAppSettingNames parameter, matching the repo templates exactly. Co-Authored-By: Claude Sonnet 4.6 (1M context) <[email protected]>
Lewis-E
force-pushed
the
fix/455-function-app-install-docs
branch
from
June 1, 2026 14:01
4732018 to
952d4c9
Compare
…ure functions sidebar page
…ATE_EXTENSIONS=0 Add slot swap steps to all installation methods (Bicep, ARM, Manual, PowerShell). WEBSITE_PRIVATE_EXTENSIONS=0 is required on the deploy slot to prevent MoveDirectory file-lock failures, but it also prevents the runtime from loading private extensions. The extension only becomes active after swapping to production, where this setting is absent. Co-Authored-By: Claude Sonnet 4.6 <[email protected]>
ava-silver
approved these changes
Jun 1, 2026
This comment has been minimized.
This comment has been minimized.
…nd add a .NET-isolated-worker example to the Function App page, since the shared shortcode showed ASP.NET Core code on the Functions page. - Remove the now-unused aas-logging-dotnet-code-example shortcode.
Lewis-E
force-pushed
the
fix/455-function-app-install-docs
branch
from
June 3, 2026 01:37
0b8f840 to
c82b71c
Compare
cswatt
approved these changes
Jun 3, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
We support a subset of Azure Function Apps with the Serverless Windows Extension, and this is hidden in corners of unrelated documentation. Separate out the function app support and give it function-app specific install, setup, and troubleshooting examples.
azure_functions/dotnet_extension.md— new dedicated page for the .NET APM Extension on Azure Function Apps, with PowerShell, Bicep, and ARM install tabs and theWEBSITE_PRIVATE_EXTENSIONS=0sticky slot setting workaround for datadog-aas-extension#455azure_functions/_index.md—[9]link updated from/serverless/azure_app_service/windows_code/?tab=net→/serverless/azure_functions/dotnet_extension/so Function App users land on the right pageazure_app_service/windows_code.md:ARM/→install-templates/(coordinated with companion rename PR in datadog-aas-extension)-SlotNameparameter added to PowerShell install command with cross-reference to new Function App pagedotnet_extension.md// Version: 1.0.0/"metadata": { "version": "1.0.0" }) added to all Bicep and ARM inline snippets for comparison against repo template filesazure_functions/_index.mdline 21 ("For .NET Windows Azure Functions running on Dedicated/App Service or Premium plans")._index.mdis unchanged and won't appear in this diff — the old wording inwindows_code.mdwas describing App Service plan SKU tiers rather than the plan types, which was inconsistent and potentially misleading.Companion PR
This PR must be merged alongside the rename PR in
datadog-aas-extension. This PR is already merged, so the links will work.Companion: DataDog/datadog-aas-extension#457
Test plan
dotnet_extension.mdrenders correctly (tabs, collapsibles, code blocks)windows_code.mdlinks to correct anchor🤖 Generated with Claude Code