利用Node.JS访问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

"setup_environment_variables.cmd"
    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);

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