#deployment 22 articles

• "No such host" for <app>.azurewebsites.net — new function apps get a unique default hostnamegotchas / azure-functionsNew apps get a unique default hostname (-.-01); the bare name never resolves, and the deploy log's .scm. URL reveals the real host even when the app name is a masked secret
• "Your data stays in the region you chose" — for Azure OpenAI the deployment TYPE decides where prompts are processed, not the regiongotchas / azure-functionsA GlobalStandard deployment in an EU region may process prompts in any Azure region; only Data Zone (EU Data Boundary) or regional Standard keep processing in the zone or geography — write data-location claims from the…
• .funcignore pattern src/ also empties node_modules/*/src — the deployment succeeds, the functions don't loadgotchas / azure-functionsAzure/functions-action applies .funcignore with gitignore semantics to every path in the package, so src/ or test/ without a leading slash also empties those folders inside node_modules. A dependency whose entry file…
• A brand-new Azure subscription blocks your first Function App deploymentgotchas / azure-functionsNew subscriptions start with Y1 quota 0 and unregistered resource providers; the quota is per subscription and per region, so try a neighbouring region first — az appservice list-locations --sku Y1 lists regions you…
• A CDN-hosted SPFx bundle still needs a new .sppkggotchas / spfxincludeClientSideAssets: false moves assets, not versioning; the manifest pins a content-hashed filename, so old packages never request the new bundle
• A command set's commands are fixed in its manifestgotchas / spfxtitle, iconImageUrl, visible and disabled change at runtime, new commands need a new .sppkg; ship one entry that opens your own menu, or reserve hidden slots (and keep their titles honest)
• A GitHub Pages CDN without .nojekyll freezes on its last good buildgotchas / toolingBranch builds run Jekyll unless .nojekyll exists; a growing bundle host ended in a bare "Page build failed." while the site kept serving the old build — read /pages/builds before pushing again
• A Graph scope your SPFx solution never asked for may already work — grants are tenant-widegotchas / spfxwebApiPermissionRequests is a request, not a grant; an approval lands on one tenant-wide principal, so a scope another solution had approved already works in yours (and may be missing at the customer)
• A library component loaded from your own manifest fetches its lazy chunks from that manifest's foldergotchas / spfxSPComponentLoader.loadComponent + a relocated manifest: without the chunk.* files next to the bundle every import() 404s on first use, which an open-the-app smoke test never exercises
• A retention window computed from git history deletes the file you overwrite in placegotchas / toolingA stable loader keeps its add date and drifts out of "the last N releases"; protect by shape (no content hash), and remember the hard 1 GB Pages limit counts the published tree
• A server-side origin check rejects your own smoke test — and the runbook that says "this bypasses CORS"gotchas / azure-functionsOnce the allowlist is enforced in the handler it applies to every caller, so the deploy script's own verification and the runbook command both need the Origin header; "this test bypasses CORS" stops being true and…
• An overwritten script with a stable name keeps serving the old codegotchas / spfxmax-age=600 on GitHub Pages, a memory cache shared by same-site tabs and SharePoint's service worker; keep stable files thin, test with cache: 'reload' and every tab closed, and don't read transferSize of a…
• An SPFx chunk's file name is not its content — realContentHash is offgotchas / spfxSPFx builds with realContentHash: false, so a byte-identical chunk can get a new name (measured) and nothing rules out the reverse; deduplicate by bytes or git blob and never overwrite a published file
• Azure OpenAI — a pinned model+version in your deploy script is a time bombgotchas / azure-functions"Deprecating" blocks NEW deployments well before retirement; resolve the newest GA version at deploy time, and match the deployment name to the model family
• CDN pruning deleted the extension bundle the deployed .sppkg still referencedgotchas / spfxWith includeClientSideAssets: false the catalog pins hashed names for customizers and command sets too; a "keep N newest" prune evicts the referenced hash and the extension 404s for days — protect extension bundles by…
• GitHub Actions OIDC login to Azure fails with AADSTS700213 in repositories created after 15 July 2026gotchas / azure-functionsNew GitHub repositories send the OIDC subject as repo:owner@ownerId/repo@repoId:…, so an Azure federated credential written in the classic repo:owner/repo:… form never matches and azure/login fails with AADSTS700213.…
• Moving a static CDN off GitHub Pages without breaking the apps that load from itgotchas / toolingUpload git blobs, not a Windows working tree (CRLF breaks SRI); allow the new CA in CAA; missing files must stay 404, not 403; Azure static website has no CORS and Front Door ignores the query string by default…
• Parentheses in an Azure CLI --query argument break az.cmd on Windows ("-o was unexpected at this time.")gotchas / powershellOn Windows az is a batch file; a JMESPath query with ( ) and no spaces reaches cmd unquoted and breaks its IF block – return plain names and count in PowerShell
• Polling the manifest proves nothing — a static host serves the small file firstgotchas / spfxA static host publishes the small manifest before the large entry bundle, so the component loads nothing and logs nothing; and an A/B against the previously deployed version compares deploy age, not code (+ a 503 on…
• SPFx in Teams — a personal app needs global deployment, not a root-site installgotchas / spfxskipFeatureDeployment: true + "all sites"; the teams/ icon-folder convention
• Three .sppkg packaging pitfalls — diacritics, icon size, the Publisher columngotchas / app-catalogASCII-only solution name, icon exactly 96×96, Publisher column is AppSource-only
• Windows Functions — zip deploy onto a running app corrupts it (whole app 503)gotchas / azure-functionsLive wwwroot file locks → whole app 503; re-run the deploy, prevent with WEBSITE_RUN_FROM_PACKAGE=1