认识Windows Azure之二——用NodeJS访问Azure用户角色信息

我们在微软的Windows Azure云计算平台上进行软件开发时，很有可能会遇到这个需求，那就是获取用户的角色环境信息。比如要获取当前的实例名称、部署ID（DeploymentID）、甚至是要知道哪些角色在运行？哪些角色没有运行？如果我们要使用NodeJS来实现这些任务，那就需要一些技巧。因为角色环境类(RoleEnvironment)是托管的.NET代码。

 

在本文中，我们会讨论怎样设置正在运行的Azure角色信息，以便让这些信息能够很容易地被NodeJS服务器所访问。诀窍是使用环境变量和使用启动任务，用运行的PowerShell作为两者间的桥梁。

 

下面我创建了一个例子来说明这一点，大家可以自行测试。基本上，它获得了启动任务，它把Azure角色环境信息转存到环境变量，并用server.js脚本文件输出这些变量。无论如何，大家可以从下面的代码看它到底是怎么工作的。

 

我们需要完成下列任务：

 

1、创建一个启动任务，该任务运行一个cmd脚本，脚本可访问Azure角色环境信息；

 

2、设置环境变量的信息，以便于可以从NodeJS访问这些信息；

 

3、通过process.env对象，用server.js获取值。

 

下面进行详细说明。cmd脚本是这样的：

 

脚本一：setupenvironmentvariables.cmd

@ECHO off

%~d0

CD "%~dp0"

 

IF EXIST %WINDIR%\SysWow64 (

set powerShellDir=%WINDIR%\SysWow64\windowspowershell\v1.0

) ELSE (

set powerShellDir=%WINDIR%\system32\windowspowershell\v1.0

)

 

ECHO Setting the Environment variables..

CALL %powerShellDir%\powershell.exe -Command Set-ExecutionPolicy unrestricted

CALL %powerShellDir%\powershell.exe -Command "& .\set_azure_role_information.ps1"

ECHO Done!

 

ECHO Restarting IIS..

CALL iisreset

ECHO Done!

 

ECHO Starting the W3SVC service..

CALL NET START W3SVC

ECHO Done!

 

上面的代码解释如下：

 

1、要在Azure云上执行未签名的PowerShell脚本，你必须把执行策略（Execution Policy）设置为无限制（Unrestricted）。我使用了Set-ExecutionPolicy命令，但要注意它的值不会改变，除非你手动修改值。在PowerShell 2.0环境下，还可以使用-ExecutionPolicy命令来设置在当前范围下无限制。但是由于默认的WebRole模板使用了osFamily="1"设置，它在Windows Server 2008 SP2有效，所以我们不会使用此命令。

 

2、重点：在环境变量设置后，我们需要重启IIS服务器，重启W3SVC，让服务生效。Azure云平台的W3SVC设置为手工模式，因此这就是为什么它不会在IIS服务器复位后自动启动。

 

我们来看下一个PowerShell脚本：

 

脚本二：setazurerole_information.ps1

[Reflection.Assembly]::LoadWithPartialName("Microsoft.WindowsAzure.ServiceRuntime")

[Environment]::SetEnvironmentVariable("RoleName", [Microsoft.WindowsAzure.ServiceRuntime.RoleEnvironment]::CurrentRoleInstance.Role.Name,"Machine")

[Environment]::SetEnvironmentVariable("RoleInstanceID", [Microsoft.WindowsAzure.ServiceRuntime.RoleEnvironment]::CurrentRoleInstance.Id,"Machine")

[Environment]::SetEnvironmentVariable("RoleDeploymentID", [Microsoft.WindowsAzure.ServiceRuntime.RoleEnvironment]::DeploymentId,"Machine")

[Environment]::SetEnvironmentVariable("IsAvailable", [Microsoft.WindowsAzure.ServiceRuntime.RoleEnvironment]::IsAvailable,"Machine")

[Environment]::SetEnvironmentVariable("CustomVariable", "Some value","Machine")

 

代码说明：我们通过RoleEnvironment属性值设置一些环境变量。要注意，还可以设置自定义的环境变量。

 

脚本三：ServiceDefinition.csdef

    executionContext="elevated" taskType="simple" />

 

最后，我们用NodeJS编写server.js代码，它可以输出响应的结果。

 

脚本四：server.js

var http = require('http');

var port = process.env.port || 1337;

 

http.createServer(function (req, res) {

res.writeHead(200, { 'Content-Type': 'text/plain' });

 

res.write("Role Name: " + process.env.RoleName + "\n");

res.write("Role InstanceID: " + process.env.RoleInstanceID + "\n");

res.write("Role DeploymentID: " + process.env.RoleDeploymentID + "\n");

res.write("Is running?: " + process.env.IsAvailable + "\n");

res.write("Custom variable: " + process.env.CustomVariable + "\n");

 

res.end();

}).listen(port);

 

在模拟器上运行上面的例子，显示的结果如下：