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

New version 2.0.11651-alpha of the Functions runtime #94

Closed
davidebbo opened this Issue Mar 26, 2018 · 6 comments

Comments

Projects
None yet
4 participants
@davidebbo
Contributor

davidebbo commented Mar 26, 2018

A new version of the 2.0 Preview runtime is being deployed. Note that it has some breaking changes from the previous Preview build.

Please see https://github.com/Azure/azure-functions-host/releases/tag/v2.0.11651-alpha for details.

@davidebbo

This comment has been minimized.

Contributor

davidebbo commented Mar 26, 2018

@Azure Azure locked and limited conversation to collaborators Mar 26, 2018

@paulbatum

This comment has been minimized.

Member

paulbatum commented Mar 27, 2018

This preview release introduced some breaking changes!

You will need to update your binding extensions to resolve these breaking changes. Different workflows are required depending on how your functions are written:

  • in Visual Studio
  • through the portal
  • locally using the azure-functions-core-tools (this also includes VS Code users)

What Nuget packages do I need?

Whatever nuget references you already have will need to be updated. Use this table as a reference:

NuGet Package Version
Microsoft.NET.Sdk.Functions 1.0.11
Microsoft.Azure.WebJobs.Extensions.CosmosDB 3.0.0-beta7
Microsoft.Azure.WebJobs.Extensions.DurableTask 1.2.1-beta3
Microsoft.Azure.WebJobs.Extensions.MicrosoftGraph 1.0.0-beta3
Microsoft.Azure.WebJobs.Extensions.* (EVERYTHING ELSE) 3.0.0-beta5

To fix a function app written in VS

This is basically just a NuGet update. Because you'll need to update multiple packages in one go, the easiest way to do this is to edit the .csproj file for your function app and update the references accordingly. Doing a build will then be enough to trigger a package restore. You'll then need to deploy the change.

To fix a function app written locally using azure-functions-core-tools (including VS Code)

  1. Edit extensions.csproj
  2. Update with the appropriate versions (see above)
  3. Run func extensions sync
  4. Deploy to azure

To fix a function app written in the Portal

Follow these steps:

  1. Stop the function app.
  2. Access kudu console through Platform Features -> Advanced Tools -> Debug Console (cmd)
  3. Navigate to d:\home\site\wwwroot
  4. Delete the bin directory
  5. Edit extensions.csproj
  6. Update with the appropriate versions (see above)
  7. Run dotnet build extensions.csproj -o bin --no-incremental --packages D:\home\.nuget
  8. Start the function app

As a reminder, you can discuss issues/problems here:
Azure/app-service-announcements-discussions#41

@paulbatum paulbatum changed the title from New version 2.0.11651-alpha of the Preview runtime to New version 2.0.11651-alpha of the Functions runtime Mar 28, 2018

@cgillum

This comment has been minimized.

cgillum commented Mar 29, 2018

The Durable Functions extension (Microsoft.Azure.WebJobs.Extensions.DurableTask) has been updated to version v1.2.1-beta3, which is compatible with the new v2.0.11651-alpha functions runtime. I've updated the table above with this information. Release notes for this update can be found here.

@davidebbo

This comment has been minimized.

Contributor

davidebbo commented Mar 30, 2018

One more note: if you are stuck and need to get a v2 app back up and running asap, , you can set FUNCTIONS_EXTENSION_VERSION=2.0.11587-alpha in the App Settings to go back to previous build. But this is only a temporary measure, as the old build will later disappear and you should always be on the latest Preview. So while you do that, use a separate app to get ready for the new build, and then move all your apps back to FUNCTIONS_EXTENSION_VERSION=beta.

@mattchenderson

This comment has been minimized.

mattchenderson commented Apr 5, 2018

@davidebbo

This comment has been minimized.

Contributor

davidebbo commented Apr 6, 2018

It took a little longer than we would have wanted, but the updated Azure Functions and WebJobs Tools VS extension is now up. Please go ahead and upgrade. The new version is 15.0.40405.0.

Important: At this point, there is no reason for anyone to still be running the older build. We will keep this old build around for a while longer to make sure everyone transitions. But please make sure you do this to avoid suddenly being broken when the old build is removed!

@davidebbo davidebbo closed this Apr 6, 2018

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.