你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
此包包含 Azure KubernetesRuntime 客户端的异态 SDK(在 Node.js 和浏览器中运行)。
开始
当前支持的环境
- LTS 版本的 Node.js
- 最新版本的 Safari、Chrome、Edge 和 Firefox。
有关详细信息,请参阅我们的 支持策略。
先决条件
安装 @azure/arm-containerorchestratorruntime 包
使用 npm安装适用于 JavaScript 的 Azure KubernetesRuntime 客户端库:
npm install @azure/arm-containerorchestratorruntime
创建和验证 KubernetesRuntimeClient
若要创建用于访问 Azure KubernetesRuntime API 的客户端对象,需要 Azure KubernetesRuntime 资源和 endpointcredential。 Azure KubernetesRuntime 客户端可以使用 Azure Active Directory 凭据进行身份验证。
可以在 Azure 门户中找到 Azure KubernetesRuntime 资源的终结点。
可以使用来自
若要使用如下所示的 DefaultAzureCredential 提供程序,或 Azure SDK 提供的其他凭据提供程序,请安装 @azure/identity 包:
npm install @azure/identity
还需要 注册新的 AAD 应用程序,并通过向服务主体分配合适的角色来授予对 Azure KubernetesRuntime 的访问权限(注意:"Owner" 等角色不会授予必要的权限)。
将 AAD 应用程序的客户端 ID、租户 ID 和客户端机密的值设置为环境变量:AZURE_CLIENT_ID、AZURE_TENANT_ID、AZURE_CLIENT_SECRET。
有关如何创建 Azure AD 应用程序的详细信息,请参阅本指南 。
const { KubernetesRuntimeClient } = require("@azure/arm-containerorchestratorruntime");
const { DefaultAzureCredential } = require("@azure/identity");
// For client-side applications running in the browser, use InteractiveBrowserCredential instead of DefaultAzureCredential. See https://aka.ms/azsdk/js/identity/examples for more details.
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new KubernetesRuntimeClient(new DefaultAzureCredential(), subscriptionId);
// For client-side applications running in the browser, use this code instead:
// const credential = new InteractiveBrowserCredential({
// tenantId: "<YOUR_TENANT_ID>",
// clientId: "<YOUR_CLIENT_ID>"
// });
// const client = new KubernetesRuntimeClient(credential, subscriptionId);
JavaScript 捆绑包
若要在浏览器中使用此客户端库,首先需要使用捆绑程序。 有关如何执行此操作的详细信息,请参阅我们的 捆绑文档。
关键概念
KubernetesRuntimeClient
KubernetesRuntimeClient 是开发人员使用 Azure KubernetesRuntime 客户端库的主要接口。 探索此客户端对象上的方法,了解可以访问的 Azure KubernetesRuntime 服务的不同功能。
故障 排除
伐木
启用日志记录可能有助于发现有关故障的有用信息。 若要查看 HTTP 请求和响应的日志,请将 AZURE_LOG_LEVEL 环境变量设置为 info。 或者,可以通过在 setLogLevel中调用 @azure/logger 在运行时启用日志记录:
const { setLogLevel } = require("@azure/logger");
setLogLevel("info");
有关如何启用日志的更详细说明,可以查看 @azure/记录器包文档。
贡献
若要参与此库,请阅读 贡献指南 了解有关如何生成和测试代码的详细信息。