Windows Azure 网站开发Stacks支持

编辑人员注释: 本文章由 Windows Azure 网站团队的项目经理 Daria Grigoriu 和 Windows Azure 网站开发人员体验合作伙伴共同撰写。

Windows Azure 网站 (WAWS) 团队积极投资开发了一款用于开发Stacks的支持模型,可使您的 Web 应用程序快速开始运行,并为您的 Web 应用程序提供增长空间。本博客文章重点介绍了我们用于开发Stacks版本控制和可扩展性的几个基本原则,以及这些原则如何应用到您的 Web 应用程序。

目前我们支持 .NETPHPNode.jsPython Stacks。Windows Azure 开发中心(网址为:https://www.windowsazure.com/en-us/develop)为以上每种Stacks均提供了良好的知识库。您创建网站后即可上传您的内容,只需最少的信息输入,我们就能使其投入运行。

WAWS 开发Stacks版本控制

我们支持的某些开发Stacks(如 PHP)被设计为支持并行版本。对于这些开发Stacks,我们提供了一系列经过验证适用于我们的平台的当前版本。我们还建立了一个默认版本,因此除非您出于兼容性原因更喜欢特定版本,否则无需输入。

其他开发Stacks(如 .NET)被设计为提供某些版本(如 .NET 4.5)的就地升级。在这种情况下,我们努力维护开发Stacks的当前状态,并为您提供最新版本的功能和优势。

对于支持的每个开发Stacks,随 WAWS 提供的版本及相应的版本默认设置摘要可从此链接获取:https://github.com/projectkudu/kudu/wiki/Azure-Web-Sites-Development-Stacks

开发Stacks可扩展性

如果您需要自定义,我们可为每个开发Stacks所提供的扩展点提供支持。

.NET

.NET Framework 已与 WAWS 平台深入集成。

配置

可以使用 web.config 文件指定配置。某些开发人员习惯使用的 apphost.config 文件无法使用 WAWS 直接编辑,但可以使用 XML 文档转换 (XDT) 声明进行修改。apphost.config 中的某些设置(如默认文档),可通过 Azure 门户在网站的 CONFIGURE 选项卡中进行编辑。

可扩展性

可以将可进行 Bin 部署的组件(如 MVC 或网页)添加到您的 Web 应用程序文件夹中。

Node.js

配置

以下是与在 WAWS 上部署的 Node.js 应用程序相关的主要配置文件:

  • package.json

这是一个与跨平台相关的特定于 Node.js 的配置文件。示例用法包括指定 Node.js 模块依赖项(如 Express.js)以及运行时版本号。

  • iisnode.yml

这是由特定的 iisnode 自定义 IIS 模块使用的配置文件。示例用法包括指定用于启动 node.exe 的命令、iisnode 将创建的 node.exe 进程数以及日志记录配置。

  • web.config

这是由 WAWS 平台使用的 IIS 配置文件。此文件会捕获所需的处理程序注册,并允许使用 URL 重写以进行静态文件使用性能优化。

可扩展性

与 WAWS 集成的 Node.js 开发Stacks包括 https://nodejs.org/api 中所述的核心功能。https://npmjs.org 中所述的 NPM 模块生态系统可用于扩展核心开发Stacks功能。package.json 配置文件可用于指定要包括在 Web 应用程序中的模块。如果使用与 WAWS 平台集成的基于 GIT 的源代码版本控制,npm install 会在 GIT push 操作期间运行以提取和安装依赖项。如果使用其他开发机制(如 FTP),则可以在本地开发期间下载和配置模块,并将整个 Web 应用程序上传到 WAWS。请记住,NPM 模块包括跨平台兼容的 Javascript 模块和设计用于特定平台的本机模块 – 对您的应用程序进行测试始终是个好主意。

运行时版本

可以选择 WAWS 平台中包括的任一 Node.js 版本,或者上传和配置自定义 Node.js 运行时版本。可通过 Windows Azure 开发人员中心获取相关说明,网址为:https://www.windowsazure.com/en-us/develop/nodejs/common-tasks/specifying-a-node-version

PHP

配置

在 WAWS 上部署的与 PHP 应用程序相关的主配置文件是标准的 PHP .user.ini 文件。此文件可用于设置可更改的 PHP 指令,如用于诊断的 display_errors。

可扩展性

默认情况下,WAWS 支持一系列核心 PECL 扩展。我们也欢迎您进行自定义扩展。要启用自定义扩展,请在 FTP 根目录下引入 DLL,并在 CONFIGURE 选项卡下添加 PHP_EXTENSIONS 应用程序设置, 其值应设置为 PHP 扩展的位置 (到应用程序根目录的相对位置)。

运行时版本和自定义

通过 Azure 门户访问网站的 CONFIGURE 选项卡时可以进行版本选择。

WAWS 还支持基于 FastCGI 的自定义 PHP 开发Stacks。将开发Stacks上传到网站的根目录下。访问网站的 CONFIGURE 选项卡,并将新的脚本处理器(通常为 php-cgi.exe)与 *.php 扩展名相关联。脚本处理器需要使用绝对路径:例如 D:\home\site\wwwroot\php5.5\php-cgi.exe,其中 D:\home\site\wwwroot 表示站点的根目录。

Python

配置

与在 WAWS 上部署的 Python 应用程序相关的主要配置文件为 web.config。此文件会捕获所需的处理程序注册,并允许使用 URL 重写以进行静态文件使用性能优化。是否使用 web.config 文件是可选的,还可以通过 Azure 门户中的 CONFIGURE 选项卡指定处理程序映射。Windows Azure 开发人员中心提供了更多信息,网址为:https://www.windowsazure.com/en-us/develop/python/tutorials/web-sites-configuration

可以通过 Azure 门户中 CONFIGURE 选项卡下方的“应用程序设置”更新某些配置选项:

  • WSGI_LOG:用于捕获应用程序和配置错误的日志文件的绝对路径
  • WSGI_HANDLER:可调用的应用程序对象WSGI协议接受环境时, 还有start_response 函数都会用到它.

此处指定的值必须为模块/程序包名称,后跟要使用的模块中的属性 - 例如 mypackage.mymodule.handler(添加括号以指示应调用该属性)。

  • WSGI_RESTART_FILE_REGEX:用于指定文件名的正则表达式

默认情况下,这指的是所有 *.py 和 *.config 文件:.*((\\.py)|(\\.config))$

可扩展性

您可以将程序包放在应用程序根目录下方,并通过 web.config 或应用程序设置配置 PYTHONPATH,以将程序包添加到部署中。WAWS 当前不支持 Virtualenv。

要支持部署任意程序包,请首先创建目录将程序包存储在网站的根目录下方。这类似于在您的 Python lib 文件夹中创建 site-packages 目录,但它位于您的 Web 应用程序中,并部署到 Windows Azure 网站。将程序包复制到此新目录,并将此目录的绝对路径添加到 web.config(例如 D:\home\site\wwwroot\my-packages)的 PYTHONPATH 中。现在,这些程序包可以在 Web 应用程序中导入了。

例如,可以将 Django 包括在应用程序中。首先下载 Django 或将其安装到现有的 Python 安装中。接下来,将 Django 程序包(通常是名为 django 的文件夹,其中包括 __init__.py 文件)复制到应用程序中的某个目录。默认情况下,应用程序根目录会包括在搜索程序包的目录的列表中。如果希望在子目录(例如 mypackages\django)中包括它,可以将父目录添加到 web.config 中的 PYTHONPATH – 在这种情况下,位置应该为 D:\home\site\wwwroot\mypackages。

Windows Azure 开发人员中心提供了更多信息,网址为:https://www.windowsazure.com/en-us/develop/python/tutorials/web-sites-with-django

运行时版本和自定义

欢迎使用基于 FastCGI 的自定义 Python 开发Stacks。可以将自定义的开发Stacks上传到网站的根目录下,并将网站处理程序映射配置为包括基于 FastCGI 的脚本处理器的绝对路径。

我们一如既往地期待您的反馈,请通过论坛反馈告诉我们如何更好地满足您的开发Stacks需求。

本文翻译自:

https://blogs.msdn.com/b/windowsazure/archive/2014/01/10/windows-azure-websites-development-stacks-support.aspx