Table of Contents

IT:AD:Kudu

Summary

Kudu is the engine behind Git Deployments in Azure App Service.

It is a Site Extension which is provided with ever App Service.

It provides: * Git integration to a Web Site * an API endpoint for programmatic access to

  • app settings,
  • deployment information,
  • files,
  • active processes,
  • runtime versions,
  • source control information,
  • web hooks
  • web jobs.

The scm service host name is not affected by the presence of custom host names in your site. It always has the pattern above. * The scm site uses single sign on, using your IT:AD:Azure:Account, so if you're already logged on to the Azure portal, you will be able to directly access the site. * If you prefer Basic Auth (why?!?), use http://mysite.scm.azurewebsites.net/basicauth (https://myservice.scm.azure-mobile.net/basicauth for mobile services), where you will be prompted for credentials.

  • Use either the user publishing credentials (same as you use for git), or the site level credentials.

It can also run outside of Azure.

Notes

Access

In Azure you can access it by using the Source Control Management entry point: * https://yoursite.scm.azurewebsites.net/

API

From the home page you can see listed various REST/JSON based API endpoints, which you can use for several things, such as retrieving the AppSettings, Environment Variables, as well as download and view files (eg: LogFiles).

Note that most of of the information available via the APIs is again listed on the KUDU webpages.

Debugging

An important tool provided by IT:AD:Kudu is its debug tools.

Kudu provides both a tranditional CMD console, as well as a IT:AD:Powershell console:

You may be wondering what's the point? Why not RDP in? The reason is that when you use an App Service you could be deploying to a VM that you share. In which case when all you needed was a console of some kind, it would be rather unwise to have RDP access to the server…

Resources

* http://blog.davidebbo.com/2012/06/introducing-open-source-engine-behind.html * https://github.com/projectkudu/kudu * https://github.com/projectkudu/kudu/wiki * https://channel9.msdn.com/Shows/Azure-Friday/What-is-Kudu-Azure-Web-Sites-Deployment-with-David-Ebbo * https://azure.microsoft.com/en-us/blog/windows-azure-websites-online-tools-you-should-know-about/ * http://www.jamessturtevant.com/posts/How-to-add-edit-and-remove-files-in-your-azure-webapp-using-the-kudu-service-dashboard/ * https://blogs.msdn.microsoft.com/benjaminperkins/2014/03/24/using-kudu-with-windows-azure-web-sites/