此文档将指导大家使用 PowerShell 脚本在 Azure 中创建 K8s环境资源,因此首先我们需要创建能赋予PS脚本访问操作Azure服务权限的资源。
PS脚本将使用Azure Service Principal 授权的方式来访问 Azure 服务,有关 Service Principal 的具体详情可参考:
Application and service principal objects in Azure Active Directory
- 打开 Azure China,并使用给予大家的订阅账号登陆:
登陆成功进入Portal界面:
- 点击 AAD -> App registrations -> New registrations 来创建 Service Principal
- 输入名称如‘k8s-sp’,其余项维持默认即可,点击 Register
- 创建成功后,进入到详情页面,记录下Application ID的值,后续步骤会用到
- 点击 Certificates & secrets,选择创建一个客户端密钥,并输入密钥描述,点击创建
密钥创建完毕,保存密钥的value值,后面会用得到
至此创建 Service Principal 完毕,我们已经拿到此 SP 的 Application ID 和密钥,接下来给此SP赋予权限以便在之后的步骤中能够根据 Application ID 和密钥调用对应权限的 Azure 服务.
- 点击左侧菜单栏 'All Services',选择 ‘Subscriptions’进入订阅列表界面
在主页中点击当前订阅,进入订阅详情页面
- 在订阅详情页面点击‘Access control(IAM)’,并添加一个新的role assignment
- 新建选项中选择'Owner'角色(最大权限),在赋予对象处填写之前创建的SP名称'k8s-sp',搜索出结果后点击它,将其添加到已选择对象中,最后保存
- 保存完成后,点击Role Assignments列表,查看已经添加完毕
至此给 Service Principal 赋权已经完成,Azure 资源配置结束,接下来我们将使用以上创建的 Azure 资源作为环境变量来运行 Power Shell 脚本,创建出我们的 K8s 服务。
我们将使用Power Shell脚本链接 Azure Service 部署 K8s 服务,需要提前下载脚本代码
- 打开idcf boat-house-devops 项目,clone repo到本地
- 下载完毕,源代码下'env-cn文'件夹中的'env-generator.ps1'即为部署脚本,使用编辑器打开'env-generator.ps1'文件后,我们可以看到脚本运行需要 5 个参数:
参数释义如下:
- 在此具体介绍以下 Power Shell 脚本中代码的原理:
- k8s文件夹下的 'acs-engin' 文件夹包含 Azure Container Service Engine 工具,此工具可以基于特定格式的 Json 脚本文件生成部署Azure资源所使用的ARM 模版:
关于ACS-Engine和ARM模版的具体细节,大家可以参考: ACS-Engine ARM
- k8s文件夹下的 'template-tool-config.json' 是生成 K8s arm 模版的配置文件,即上面所说的‘ACS-Engine’使用的配置文件。
此文件描述了所需要生成的K8s环境的详细信息:
- Power Shell 脚本运行时首先替换掉 'template-tool-config.json' 文件中的以下四个环境变量
其中 ssh 的密钥是通过 git 安装目录下的 ssh-keygen.exe 生成的一对公钥和私钥,大家要注意保存好生成的私钥也就是 ’k8s/temp/ssh/id_rsa‘ 文件,k8s环境创建完毕后,需要使用此私钥链接结点。
- 然后使用 'ACS-Engine' 生成 K8s的 ARM模版. (Temp文件夹中的内容将会在运行PS脚本文件时生成)
- 最后使用 'AZ CLI' 工具登陆 Azure China,并创建指定名称的Resource Group,在此 Resource Group 中基于 ARM 模版部署 K8s的集群环境。
- k8s文件夹下的 'acs-engin' 文件夹包含 Azure Container Service Engine 工具,此工具可以基于特定格式的 Json 脚本文件生成部署Azure资源所使用的ARM 模版:
通过上一章节的介绍,我们知道运行部署脚本之前需要先安装脚本所需的依赖,依赖包括:
- ssh-keygen.exe:用以生成ssh公钥私钥
- 安装方式:安装 git 即可在路径'C:\Program Files\Git\usr\bin\ssh-keygen.exe'下找到此工具。
- AZ CLI:用以连接 Azure China 并创建 Resource Group ,基于ARM模版部署 K8s 集群环境。
- 安装方式:安装 Azure CLI
- 使用power shell 进入脚本所在文件夹:
- 运行以下命令来启动 ps1 脚本程序:
.\env-generator.ps1 -AzureUserName <azure用户名> -AzureUserPwd <azure用户密码> -SubscriptionName <azure订阅名称> -AzureSPApplicationId <上面创建的Application Id> -AzureSPApplicationKey <上面创建的Application密钥>
- 执行完毕后,进入Azure China Portal 查看新创建的 Resource Group 以及部署在此 Resource Group 中的 K8s环境