Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clear prior deployment troubleshooting guidance #24325

Closed
guardrex opened this issue Dec 15, 2021 · 1 comment · Fixed by #24333
Closed

Clear prior deployment troubleshooting guidance #24325

guardrex opened this issue Dec 15, 2021 · 1 comment · Fixed by #24333
Assignees
Projects

Comments

@guardrex
Copy link
Collaborator

I've seen this a few times over the years where prior-deployed files can corrupt a fresh deployment. Devs in these cases often resolve the problem by adding a deployment step to wipe the prior deployment completely (e.g., Failed to find a valid digest in the 'integrity' attribute for resource Blazor Wasm (dotnet/aspnetcore #38668)). Also, cross-link the new remark from the integrity PS script section.


Document Details

Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

@guardrex guardrex self-assigned this Dec 15, 2021
@dotnet-bot dotnet-bot added this to Triage in Blazor.Docs Dec 15, 2021
@dotnet-bot dotnet-bot added Blazor Source - Docs.ms Docs Customer feedback via GitHub Issue labels Dec 15, 2021
@guardrex guardrex added doc-enhancement Pri2 Priority 2 and removed Source - Docs.ms Docs Customer feedback via GitHub Issue labels Dec 15, 2021
@guardrex guardrex moved this from Triage to In progress in Blazor.Docs Dec 15, 2021
@guardrex guardrex moved this from In progress to P2 - Medium Priority in Blazor.Docs Dec 15, 2021
@guardrex
Copy link
Collaborator Author

guardrex commented Dec 15, 2021

@TanayParikh ... This is following @alex-oswald's most recent remark at ...

dotnet/aspnetcore#38668 (comment)

... but is something that still happens occasionally for many devs.

Let's discuss potential language here first before I put up a PR. I'd like to focus on a few concepts in a new section of the Host and deploy overview topic. We could add some folks if you think we need more 👀 on it. Chris, Justin, Sourabh, Pranav, Javier ... many have a lot of experience over the years helping devs with this sort of scenario where a corrupted deployment is breaking an app and clearing the prior deployment at least works around the problem. The thing right now tho is that many are out (or going out) on holiday. I'm not sure who's around to look at this! ✈️🏖️😄

  • First, this happens less frequently than ever before these days. Four+ years ago in the early days of ASP.NET Core 👴, this was a much more common situation going by what readers were reporting in doc issues. These days, it's much less of a problem AFAICT. Added text should call this out.
  • Generally, devs need to do this once for either (or both) the published app or the deployment (on the host). Then, they can usually go back to publishing without replacing the entire app (locally or on the host).
  • This shouldn't be a problem under ordinary circumstances: Where the text may say 'you might always need to do this (e.g., in a build pipeline)', we probably should angle this to say that it's a temporary workaround until additional investigation determines why the app is corrupted on the server every time they deploy it.

So ........ something like the following .....................

## Prior deployment corruption

Apps are usually published and deployed without deleting all of the prior files from the previous deployment. When existing files aren't replaced, the typical deployment occurs significantly faster.

In rare cases, lingering files from a prior deployment can corrupt a new deployment. Deleting the existing deployment (or locally-published app prior to deployment) may resolve the issue with a corrupted deployment. Often, deleting the existing deployment once is sufficient to resolve the problem, including when a DevOps pipeline build is in use.

If you determine that clearing a prior deployment is always required when a DevOps build pipeline is in use, you can temporarily add a step to the build pipeline to delete the prior deployment completely for each new deployment until you troubleshoot the exact cause of the corruption.

@guardrex guardrex changed the title Clear prior deployment for some DevOps pipelines Clear prior deployment troubleshooting guidance Dec 15, 2021
@guardrex guardrex moved this from P2 - Medium Priority to In progress in Blazor.Docs Dec 16, 2021
Blazor.Docs automation moved this from In progress to Done Dec 16, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Archived in project
Blazor.Docs
  
Done
Development

Successfully merging a pull request may close this issue.

2 participants