Azure Stack Hub 上的应用服务 2022 H1 发行说明

这些发行说明介绍了 Azure Stack Hub 2022 H1 上的应用服务中的改进和修复以及任何已知问题。 已知问题分为两类:一类是与部署和更新过程直接相关的问题,另一类是构建版本在安装后存在的问题。

重要

在部署或更新Azure 应用服务资源提供程序之前,如有必要,请将Azure Stack Hub更新到受支持的版本。 请务必阅读资源提供程序的发行说明,了解可能影响部署的新功能、修补程序和任何已知问题。

支持的最低 Azure Stack Hub 版本 应用服务资源提供程序版本
2311 及更高版本 26R1 安装程序,26R1 脱机包 (发行说明)
2311 及更高版本 25R1 安装程序,25R1 脱机包 (发行说明)

构建参考

Azure Stack Hub 2022 H1 内部版本号上的应用服务为 98.0.1.699。

新变化

Azure Stack Hub 2022 H1 上的应用服务为Azure Stack Hub带来了许多新功能。

  • 所有角色现在都使用 Windows Server 2022 Datacenter。
  • 管理员可以通过将 SKU 设置为 AppService,单独隔离出供 Azure Stack Hub 上的 App Service 使用的平台映像。
  • 针对所有工作器虚拟机规模集的网络设计更新,以解决客户面临的 SNAT 端口耗尽问题。
  • 增加了所有应用程序可用的出站地址数量。 可以在Azure Stack Hub门户中应用程序的属性中发现出站地址的更新列表。
  • 管理员可以为其部署的每个虚拟机规模集中的各个实例设置三字符部署前缀,这在管理多个 Azure Stack Hub 实例时非常有用。
  • 现在会为租户启用部署中心,它取代了“部署选项”体验。 重要提示:操作员需要 重新配置其部署源 ,因为重定向 URL 随此更新而更改。 此外,租户需要将其应用重新连接到其源代码管理提供程序。
  • 自此次更新起,字母 K 现已成为保留的 SKU 字母。 如果定义使用字母 K 的自定义 SKU,请联系支持人员,以帮助在升级之前解决这种情况。

先决条件

在开始部署之前,请参阅准备工作文档。

在开始将 Azure Stack 上的应用服务升级到 2022 H1 版本之前:

  • 确保 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 Update 2022 H1 上的应用服务包括以下改进和修复:

  • 应用服务租户、管理、Functions 门户和 Kudu 工具更新 与 Azure Stack 门户 SDK 版本一致。

  • 将 Azure Functions 运行时更新到 v1.0.13154。

  • 更新核心服务以提高可靠性和错误消息,从而更轻松地诊断常见问题。

  • 针对以下应用程序框架和工具的更新:

    • 适用于 x64 的 Microsoft 服务器操作系统版本 21H2 的 .NET Framework 3.5 和 .NET Framework 4.8 2022-09 累积更新(KB5017028)。
    • ASP.NET Core
      • 3.1.18
      • 3.1.23
      • 6.0.2
      • 6.0.3
    • Eclipse Temurin OpenJDK 8
      • 8u302
      • 8u312
      • 8u322
    • Microsoft OpenJDK 11
      • 11.0.12.7.1
      • 11.0.13.8
      • 11.0.14.1
      • 17.0.1.12
      • 17.0.2.8
    • MSBuild
      • 16.7.0
      • 17.1.0
    • MSDeploy 3.5.100608.567
    • NodeJS
      • 14.18.1
      • 16.9.1
      • 16.13.0
    • npm
      • 6.14.15
      • 7.21.1
      • 8.1.0
    • Tomcat
      • 8.5.69
      • 8.5.72
      • 8.5.78
      • 9.0.52
      • 9.0.54
      • 9.0.62
      • 10.0.12
      • 10.0.20
    • 已将 Kudu 更新到 97.40427.5713。
  • 对所有角色的基础操作系统的更新:

  • Windows Server 的累积更新现在会在部署和升级过程中应用到控制器角色。

此版本中已修复的问题

  • 此更新会自动清理应用服务资源提供程序数据库中的 SiteDataRecord 和 TraceMessages 表。
  • 专用证书现在显示在具有部署槽位的站点中。
  • 升级过程更可靠,因为它验证所有角色都已准备就绪。

更新前的步骤

Azure Stack Hub 2022 H1 上的应用服务是一项重大更新。 更新可能需要几个小时才能完成,因为整个部署已更新,并且所有角色都使用 Windows Server 2022 Datacenter OS 重新创建。 在实施该更新之前,请告知您的终端客户此次计划中的更新。

  • 自 Azure Stack Hub 2022 H1 Update 上的应用服务起,字母 K 是保留的 SKU 字母。 如果定义使用字母 K 的自定义 SKU,请在升级之前联系支持人员来解决这种情况。

查看更新的已知问题,并采取规定的操作。

部署后步骤

重要

如果向应用服务资源提供程序提供 SQL Always On 实例,则必须 将appservice_hosting和appservice_metering数据库添加到可用性组 ,并同步数据库,以防止在发生数据库故障转移时丢失服务。

已知问题(更新)

  • 如果将应用服务托管数据库和应用服务计量数据库转换为包含的数据库,但不会将登录名迁移到包含的用户,则升级可能会失败。

如果在部署后将应用服务托管数据库和应用服务计量数据库转换为包含的数据库,但不会将数据库登录名迁移到包含的用户,则可能会遇到升级失败。

在将 Azure Stack Hub 上的 App Service 安装升级到 2020 Q3 之前,请针对承载 appservice_hosting 和 appservice_metering 数据库的 SQL Server 运行以下脚本。 此脚本是非破坏性的,不会导致停机。

在以下条件下运行此脚本:

  • 由具有系统管理员权限的用户执行,例如 SQL SA 帐户;

  • 如果使用 SQL Server Always On,请确保从包含表单中所有应用服务登录名的SQL Server实例运行脚本:

    • 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 后前端缺少功能。 操作员必须按照此流程操作以解决该问题。

    1. 在Azure Stack Hub管理门户中,转到网络安全组并查看 ControllersNSG 网络安全组。

    2. 默认情况下,已对所有应用程序服务基础结构角色禁用远程桌面。 将 Inbound_Rdp_2289 规则操作更改为 “允许 访问”。

    3. 转到包含应用服务资源提供程序部署的资源组。 默认情况下,名称为 AppService。<region>. 连接到 CN0-VM。

    4. 返回到 CN0-VM 远程桌面会话。

    5. 在管理员 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     
      
    6. 在Azure Stack管理门户中,返回到 ControllersNSG 网络安全组。

    7. 更改 Inbound_Rdp_3389 规则以拒绝访问。

已知问题(安装后)

  • 如 Azure Stack Hub 上的 Azure 应用服务 和 Azure Functions 概述 中所述,当您在现有虚拟网络中部署应用服务,且文件服务器仅可通过专用网络访问时,工作器将无法访问该文件服务器。

    如果选择部署到现有的虚拟网络中,并使用内部 IP 地址连接到文件服务器,则必须添加一条出站安全规则,以允许工作器子网与文件服务器之间的 SMB 流量。 转到管理门户中的 WorkerNsg ,并添加具有以下属性的出站安全规则:

    • 源:任意
    • 源端口范围:*
    • 目标:IP 地址
    • 目标 IP 地址范围:文件服务器的 IP 范围
    • 目标端口范围:445
    • 协议:TCP
    • 操作:允许
    • 优先级:700
    • 名称:Outbound_Allow_SMB445
  • 若要消除工作器与文件服务器通信时的延迟,如果你使用 Active Directory 保护文件服务器,请将以下规则添加到 工作器 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 后前端缺少功能。 操作员必须按照此流程操作以解决该问题。

    1. 在Azure Stack Hub管理门户中,转到网络安全组并查看 ControllersNSG 网络安全组。

    2. 默认情况下,已对所有应用程序服务基础结构角色禁用远程桌面。 将 Inbound_Rdp_2289 规则操作更改为 “允许 访问”。

    3. 转到包含应用服务资源提供程序部署的资源组。 默认情况下,名称为 AppService。<region>. 连接到 CN0-VM。

    4. 返回到 CN0-VM 远程桌面会话。

    5. 在管理员 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"
      
    6. 在Azure Stack管理门户中,返回到 ControllersNSG 网络安全组。

    7. 更改 Inbound_Rdp_3389 规则以拒绝访问。

云管理员在 Azure Stack 上运行应用服务的已知问题

  • 自定义域在离线环境中不受支持。

    应用服务通过公共 DNS 终结点验证域所有权。 由于此验证方法,在断开连接的方案中不支持自定义域。

  • Web 和函数应用不支持虚拟网络集成。

    Azure Stack Hub门户显示将虚拟网络集成添加到 Web 和函数应用的选项。 如果租户尝试配置此功能,则会收到内部服务器错误。 Azure Stack Hub上的应用服务不支持此功能。

后续步骤