Update docs: dependencies don't build on Windows

[jcgiuffrida]

See issue #219 for more. Hopefully this saves others from spending a few days on this problem. The recommended command pip install azure-storage does not work on Azure Web Apps, a primary environment this package is intended for, so this seems important to point out.

[msftclas]

This seems like a small (but important) contribution, so no Contribution License Agreement is required at this point. We will now review your pull request.
Thanks,
Microsoft Pull Request Bot

[zezha-msft]

Hi @lucaluca, sorry to hear that you had to deal with this problem on Azure Web Apps. 😢

According to what I understood from reading that issue, this problem is really caused by the older version of pip which is pre-installed on Azure Web Apps and cannot install Cryptography properly. However, there is this workaround to upgrade the pip. As far as I know this is not a problem present on other Windows platforms that have newer versions of pip. The Cryptography wheel package on Windows is a statically linked build, so newer pips should install it just fine, and users do not need to build anything natively.

Please let me know whether I understood this correctly. If yes, could you please modify the documentation to point out that:

1. there might be a problem on Azure Web Apps to install Cryptography
2. the workaround is to upgrade pip and install from wheel

Best regards, and thank you for taking time to do this PR. 👍

[jcgiuffrida]

Hi - that's good to know and I'd be happy to update the PR. Just to clarify, because I haven't tried this, is the solution to upgrade pip AND install from wheel? Or does upgrading pip mean you can just build without a wheel?

…

On Thu, Aug 17, 2017 at 5:19 PM, Ze Qian Zhang ***@***.***> wrote: Hi @lucaluca <https://github.com/lucaluca>, sorry to hear that you had to deal with this problem on Azure Web Apps. 😢 According to what I understood from reading that issue, this problem is really caused by the older version of pip which is pre-installed on Azure Web Apps and cannot install Cryptography properly. However, there is this workaround <#219 (comment)> to upgrade the pip. As far as I know this is not a problem present on other Windows platforms that have newer versions of pip. The Cryptography wheel package on Windows is a statically linked build, so newer pips should install it just fine, and users do not need to build anything natively. Please let me know whether I understood this correctly. If yes, could you please modify the documentation to point out that: 1. there might be a problem on Azure Web Apps to install Cryptography 2. the workaround is to upgrade pip and install from wheel Best regards, and thank you for taking time to do this PR. 👍 — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#336 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/ABxYRoleJN7ljW0JfJbfrVReS-u0DbWkks5sZLyBgaJpZM4O4Wx5> .

[lmazuel]

Current recommendation is to update Python using the Extension mechanism (fix your problem automatically)
https://docs.microsoft.com/en-us/visualstudio/python/managing-python-on-azure-app-service

[zezha-msft]

Thanks @lmazuel! 👍

@lucaluca Would you like to update this PR?

[zezha-msft]

@lucaluca I added the suggestion on readme. Thank you!