这些发行说明介绍了基于 Azure Stack Hub 2302的 Azure 应用程序服务中的改进和修复,以及任何已知问题。 已知问题分为两类:一类是与部署和更新过程直接相关的问题,另一类是生成版本(安装后)的问题。
重要
在部署或更新Azure 应用服务资源提供程序之前,如有必要,请将Azure Stack Hub更新到受支持的版本。 请务必阅读资源提供程序的发行说明,了解可能影响部署的新功能、修补程序和任何已知问题。
| 支持的最低 Azure Stack Hub 版本 | 应用服务资源提供程序版本 |
|---|---|
| 2311 及更高版本 | 26R1 安装程序,26R1 脱机包 (发行说明) |
| 2311 及更高版本 | 25R1 安装程序,25R1 脱机包 (发行说明) |
构建参考
Azure Stack Hub 2302 内部版本号上的应用服务为 98.0.1.703。
新变化
Azure Stack Hub 上的 App Service 2302 版本取代了 2022 H1 版本,并包含对以下问题的修复:
无法通过 Azure Stack Hub 管理门户中的应用程序服务角色管理员用户体验打开虚拟机规模集用户体验。
自 Azure Stack Hub 上的 App Service 2022 H1 更新起,字母 K 现已成为保留的 SKU 字母。 如果有使用字母 K 定义的自定义 SKU,请在升级之前联系客户支持,让其协助你解决此问题。
先决条件
在开始部署之前,请参阅准备工作文档。
在Azure Stack Hub上开始将应用服务升级到 2302 之前:
确保 Azure Stack Hub 已更新到 1.2108.2.127 或 1.2206.2.52。
确保在 Azure Stack Hub 管理员门户的“应用服务管理”中,所有角色均已就绪。
在Azure Stack Hub管理门户中使用应用服务管理来备份应用服务机密。
备份应用程序服务和 SQL Server Master 数据库:
- AppService_Hosting;
- AppService_Metering;
- 主节点
备份租户应用内容文件共享。
重要
云操作员负责文件服务器和 SQL Server 的维护和操作。 资源提供程序不管理这些资源。 云操作员负责备份应用程序服务数据库和租户内容文件共享。
从 Marketplace 分发 自定义脚本扩展 的 1.9.3 版本。
更新前的步骤
注意
如果你之前已将 Azure Stack Hub 2022 H1 上的 App Service 部署到你的 Azure Stack Hub 实例中,此版本是针对 2022 H1 的一次小版本升级,修复了两个问题。
Azure Stack Hub 2302 上的应用服务是一项重大更新,需要数小时才能完成。 整个部署都会更新,所有角色都使用 Windows Server 2022 Datacenter OS 重新创建。 因此,在应用更新之前,请向最终用户通知计划更新。
- 自 Azure Stack Hub 上的 App Service 2022 H1 更新起,字母 K 现已成为保留的 SKU 字母。 如果有使用字母 K 定义的自定义 SKU,请在升级之前联系客户支持,让其协助你解决此问题。
查看更新的已知问题,并采取规定的操作。
部署后步骤
重要
如果向应用服务资源提供程序提供 SQL Always On 实例,则必须 将appservice_hosting和appservice_metering数据库添加到可用性组 ,并同步数据库,以防止在发生数据库故障转移时丢失服务。
已知问题(更新)
在将appservice_hosting和appservice_metering数据库转换为包含的数据库的情况下,如果不成功将登录名迁移到包含的用户,升级可能会失败。
如果在部署后将appservice_hosting和appservice_metering数据库转换为包含的数据库,并且未成功将数据库登录名迁移到包含的用户,则可能会遇到升级失败。
在将 Azure Stack Hub 上的 App Service 安装升级到 2020 年第 3 季度之前,必须针对承载 appservice_hosting 和 appservice_metering 的 SQL Server 运行以下脚本。 此脚本是非破坏性的,不会导致停机。
在以下条件下运行此脚本:
- 由具有系统管理员权限的用户执行,例如 SQL SA 帐户这样的用户。
- 如果您使用 SQL Always On,请确保从包含所有 App Service 登录名的 SQL 实例运行该脚本,格式如下:
- appservice_hosting_FileServer
- appservice_hosting_HostingAdmin
- appservice_hosting_LoadBalancer
- appservice_hosting_Operations
- 应用服务_托管_发布者
- appservice_hosting_SecurePublisher(安全发布者)
- appservice_hosting_WebWorkerManager
- appservice_metering_Common
- 应用服务_计量_操作
- 所有 WebWorker 登录名 - 采用 WebWorker_<instance ip address> 形式
USE appservice_hosting IF EXISTS(SELECT * FROM sys.databases WHERE Name=DB_NAME() AND containment = 1) BEGIN DECLARE @username sysname ; DECLARE user_cursor CURSOR FOR SELECT dp.name FROM sys.database_principals AS dp JOIN sys.server_principals AS sp ON dp.sid = sp.sid WHERE dp.authentication_type = 1 AND dp.name NOT IN ('dbo','sys','guest','INFORMATION_SCHEMA'); OPEN user_cursor FETCH NEXT FROM user_cursor INTO @username WHILE @@FETCH_STATUS = 0 BEGIN EXECUTE sp_migrate_user_to_contained @username = @username, @rename = N'copy_login_name', @disablelogin = N'do_not_disable_login'; FETCH NEXT FROM user_cursor INTO @username END CLOSE user_cursor ; DEALLOCATE user_cursor ; END GO USE appservice_metering IF EXISTS(SELECT * FROM sys.databases WHERE Name=DB_NAME() AND containment = 1) BEGIN DECLARE @username sysname ; DECLARE user_cursor CURSOR FOR SELECT dp.name FROM sys.database_principals AS dp JOIN sys.server_principals AS sp ON dp.sid = sp.sid WHERE dp.authentication_type = 1 AND dp.name NOT IN ('dbo','sys','guest','INFORMATION_SCHEMA'); OPEN user_cursor FETCH NEXT FROM user_cursor INTO @username WHILE @@FETCH_STATUS = 0 BEGIN EXECUTE sp_migrate_user_to_contained @username = @username, @rename = N'copy_login_name', @disablelogin = N'do_not_disable_login'; FETCH NEXT FROM user_cursor INTO @username END CLOSE user_cursor ; DEALLOCATE user_cursor ; END GO升级后,租户应用程序无法将证书绑定到应用程序。
此问题发生的原因是升级到Windows Server 2022后前端缺少功能。 操作员必须按照此流程操作以解决该问题。
在Azure Stack Hub管理门户中,转到网络安全组并查看 ControllersNSG 网络安全组。
默认情况下,已对所有应用程序服务基础结构角色禁用远程桌面。 将 Inbound_Rdp_3389 规则操作更改为 “允许 访问”。
转到包含应用服务资源提供程序部署的资源组。 默认情况下,名称为 AppService。<region>. 连接到 CN0-VM。
返回到 CN0-VM 远程桌面会话。
在管理员 PowerShell 会话中,运行:
重要
在执行此脚本期间,前端扩展集中的每个实例都会暂停一次。 如果有一条消息指示正在安装该功能,则会重新启动该实例。 请使用脚本中的暂停来维护前端可用性。 操作员必须确保至少有一个前端实例随时处于“就绪”状态,以确保租户应用程序能够接收流量,并且不会经历停机。
$c = Get-AppServiceConfig -Type Credential -CredentialName FrontEndCredential $spwd = ConvertTo-SecureString -String $c.Password -AsPlainText -Force $cred = New-Object System.Management.Automation.PsCredential ($c.UserName, $spwd) Get-AppServiceServer -ServerType LoadBalancer | ForEach-Object { $lb = $_ $session = New-PSSession -ComputerName $lb.Name -Credential $cred Invoke-Command -Session $session { $f = Get-WindowsFeature -Name Web-CertProvider if (-not $f.Installed) { Write-Host Install feature on $env:COMPUTERNAME Install-WindowsFeature -Name Web-CertProvider Shutdown /t 5 /r /f } } } Remove-PSSession -Session $session Read-Host -Prompt "If installing the feature, the machine will reboot. Wait until there's enough frontend availability, then press ENTER to continue"在Azure Stack管理门户中,返回到 ControllersNSG 网络安全组。
更改 Inbound_Rdp_3389 规则以拒绝访问。
已知问题(安装后)
如《Azure Stack 上的 App Service 部署》文档中所述,在现有虚拟网络中部署 App Service 且文件服务器仅可通过私有网络访问时,工作器将无法访问该文件服务器。
如果选择部署到现有的虚拟网络中,并使用内部 IP 地址连接到文件服务器,则必须添加一条出站安全规则,以允许工作器子网与文件服务器之间的 SMB 流量。 在管理门户中转到 WorkersNsg,并添加具有以下属性的出站安全规则:
- 源:任意
- 源端口范围:*
- 目标:IP 地址
- 目标 IP 地址范围:文件服务器的 IP 范围
- 目标端口范围:445
- 协议:TCP
- 操作:允许
- 优先级:700
- 名称:Outbound_Allow_SMB445
若要消除工作器与文件服务器通信时的延迟,如果你使用 Active Directory 来保护文件服务器,还请将以下规则添加到 Worker NSG 中,以允许出站 LDAP 和 Kerberos 流量发送到你的 Active Directory 域控制器。 例如,如果您使用快速入门模板部署了 HA 文件服务器和 SQL Server。
在管理门户中转到 WorkersNsg,并添加具有以下属性的出站安全规则:
- 源:任意
- 源端口范围:*
- 目标:IP 地址
- 目标 IP 地址范围:您的 AD 服务器的 IP 地址范围,例如在快速入门模板中为 10.0.0.100、10.0.0.101
- 目标端口范围:389,88
- 协议: 任何
- 操作:允许
- 优先级:710
- 名称:Outbound_Allow_LDAP_and_Kerberos_to_Domain_Controllers
升级后,租户应用程序无法将证书绑定到应用程序。
此问题发生的原因是升级到Windows Server 2022后前端缺少功能。 操作员必须按照此流程操作以解决该问题:
在Azure Stack Hub管理门户中,转到网络安全组并查看 ControllersNSG 网络安全组。
默认情况下,已对所有应用程序服务基础结构角色禁用远程桌面。 将 Inbound_Rdp_3389 规则操作更改为 “允许 访问”。
转到包含应用服务资源提供程序部署的资源组。 默认情况下,名称为 AppService。<region>. 连接到 CN0-VM。
返回到 CN0-VM 远程桌面会话。
在管理员 PowerShell 会话中,运行:
重要
在执行此脚本期间,前端扩展集中的每个实例都会暂停一次。 如果有一条消息指示正在安装该功能,则会重新启动该实例。 请使用脚本中的暂停来维护前端可用性。 操作员必须确保至少有一个前端实例随时处于“就绪”状态,以确保租户应用程序能够接收流量,并且不会经历停机。
$c = Get-AppServiceConfig -Type Credential -CredentialName FrontEndCredential $spwd = ConvertTo-SecureString -String $c.Password -AsPlainText -Force $cred = New-Object System.Management.Automation.PsCredential ($c.UserName, $spwd) Get-AppServiceServer -ServerType LoadBalancer | ForEach-Object { $lb = $_ $session = New-PSSession -ComputerName $lb.Name -Credential $cred Invoke-Command -Session $session { $f = Get-WindowsFeature -Name Web-CertProvider if (-not $f.Installed) { Write-Host Install feature on $env:COMPUTERNAME Install-WindowsFeature -Name Web-CertProvider Read-Host -Prompt "If installing the feature, the machine will reboot. Wait until there's enough frontend availability, then press ENTER to continue" Shutdown /t 5 /r /f } } } Remove-PSSession -Session $session在Azure Stack管理门户中,返回到 ControllersNSG 网络安全组。
更改 Inbound_Rdp_3389 规则以拒绝访问。
云管理员在 Azure Stack 上运行应用服务的已知问题
自定义域在离线环境中不受支持。
应用服务通过公共 DNS 终结点验证域所有权。 由于此验证方法,在断开连接的方案中不支持自定义域。
Web 和函数应用不支持虚拟网络集成。
Azure Stack Hub门户显示将虚拟网络集成添加到 Web 和函数应用的选项。 如果租户尝试配置此功能,则会收到内部服务器错误。 Azure Stack Hub上的应用服务不支持此功能。
后续步骤
- 有关应用服务的概述,请参阅Azure Stack概述上的Azure 应用服务。
- 若要详细了解如何完成基于 Azure Stack 的应用程序服务的部署准备,请参阅基于 Azure Stack 的应用程序服务的准备工作。