App Service on Azure Stack Hub 更新 3 版本資訊App Service on Azure Stack Hub Update 3 release notes

這些版本資訊說明 App Service on Azure Stack Hub 更新 3 的增強功能、修正和已知問題。These release notes describe improvements, fixes, and known issues in Azure App Service on Azure Stack Hub Update 3. 已知問題分為三個部分:直接與部署相關的問題、更新程序的問題,以及組建 (安裝後) 的問題。Known issues are divided into three sections: issues directly related to deployment, issues with the update process, and issues with the build (post-installation).

重要

在部署 Azure App Service 1.3 之前,請先將 1807 更新套用到您的 Azure Stack Hub 整合系統,或部署最新的 Azure Stack 開發套件 (ASDK)。Apply the 1807 update to your Azure Stack Hub integrated system or deploy the latest Azure Stack Development Kit (ASDK) before deploying Azure App Service 1.3.

建置參考Build reference

App Service on Azure Stack Hub 更新 3 組建編號是 74.0.13698.31The App Service on Azure Stack Hub Update 3 build number is 74.0.13698.31.

PrerequisitesPrerequisites

開始部署之前,請參閱部署 App Service on Azure Stack Hub 的必要條件Refer to the Prerequisites for deploying App Service on Azure Stack Hub before beginning deployment.

開始將 Azure App Service on Azure Stack Hub 升級至 1.3 之前,請確定所有角色都已在 Azure Stack Hub 系統管理員入口網站的 Azure App Service 管理中就緒。Before you begin the upgrade of Azure App Service on Azure Stack Hub to 1.3, ensure all roles are ready in the Azure App Service administration in the Azure Stack Hub administrator portal.

App Service 角色狀態

新功能和修正New features and fixes

Azure App Service on Azure Stack Hub 更新 3 包含下列改良功能和修正:Azure App Service on Azure Stack Hub Update 3 includes the following improvements and fixes:

  • 支援對 Azure App Service 資源提供者資料庫使用 SQL Server Always On。Support for use of SQL Server Always On for Azure App Service resource provider databases.

  • 在 Create-AADIdentityApp 協助程式指令碼中新增環境變數,以協助將不同的 Azure AD 區域當作目標。Added new environment parameter to the Create-AADIdentityApp helper script to assist targeting different Azure AD regions.

  • App Service 租用戶、系統管理員、Functions 入口網站和 Kudu 工具的更新。Updates to App Service Tenant, Admin, Functions portals and Kudu tools. 與 Azure Stack Hub 入口網站 SDK 版本保持一致。Consistent with Azure Stack Hub portal SDK version.

  • Azure Functions 執行階段更新至 v1.0.11820Updates Azure Functions runtime to v1.0.11820.

  • 用來改善可靠性和錯誤訊息以利進行常見問題診斷的核心服務更新。Updates to core service to improve reliability and error messaging enabling easier diagnosis of common issues.

  • 下列應用程式架構和工具的更新Updates to the following application frameworks and tools:

    • 已新增 ASP.NET Core 2.1.2Added ASP.NET Core 2.1.2
    • 新增 NodeJS 10.0.0Added NodeJS 10.0.0
    • 新增 Zulu OpenJDK 8.30.0.1Added Zulu OpenJDK 8.30.0.1
    • 新增 Tomcat 8.5.31 和 9.0.8Added Tomcat 8.5.31 and 9.0.8
    • 新增 PHP 版本︰Added PHP Versions:
      • 5.6.365.6.36
      • 7.0.307.0.30
      • 7.1.177.1.17
      • 7.2.57.2.5
    • 新增 Wincache 2.0.0.8Added Wincache 2.0.0.8
    • 將 Git for Windows 更新為 v 2.17.1.2Updated Git for Windows to v 2.17.1.2
    • 將 Kudu 更新為 74.10611.3437Updated Kudu to 74.10611.3437
  • 所有角色的基礎作業系統更新Updates to underlying operating system of all roles:

更新後的步驟 (選擇性)Post Update Steps (optional)

對於想要遷移至 Azure Stack Hub 部署上現有 Azure App Service 自主資料庫的客戶,請在 Azure App Service on Azure Stack Hub 1.3 更新完成之後,執行這些步驟:For customers wishing to migrate to a contained database for existing Azure App Service on Azure Stack Hub deployments, execute these steps after the Azure App Service on Azure Stack Hub 1.3 update has completed:

重要

此程序需要大約 5-10 分鐘才能完成。This procedure takes approximately 5-10 minutes. 此程序可能會終止現有的資料庫登入工作階段。This procedure involves killing the existing database login sessions. 請規劃停機時間,以遷移 Azure App Service on Azure Stack Hub,並在遷移後進行驗證Plan for downtime to migrate and validate Azure App Service on Azure Stack Hub post migration

  1. AppService 資料庫 (appservice_hosting and appservice_metering) 新增至可用性群組Add AppService databases (appservice_hosting and appservice_metering) to an Availability group.

  2. 啟用自主資料庫。Enable contained database.

    
        sp_configure 'contained database authentication', 1;
        GO
        RECONFIGURE;
            GO
    
  3. 將資料庫轉換成部分自主。Converting a database to partially contained. 此步驟將會使機器停止,因為所有使用中的工作階段都必須終止。This step will incur downtime as all active sessions need to be killed.

        /******** [appservice_metering] Migration Start********/
            USE [master];
    
            -- kill all active sessions
            DECLARE @kill varchar(8000) = '';  
            SELECT @kill = @kill + 'kill ' + CONVERT(varchar(5), session_id) + ';'  
            FROM sys.dm_exec_sessions
            WHERE database_id  = db_id('appservice_metering')
    
            EXEC(@kill);
    
            USE [master]  
            GO  
            ALTER DATABASE [appservice_metering] SET CONTAINMENT = PARTIAL  
            GO  
    
        /********[appservice_metering] Migration End********/
    
        /********[appservice_hosting] Migration Start********/
    
            -- kill all active sessions
            USE [master];
    
            DECLARE @kill varchar(8000) = '';  
            SELECT @kill = @kill + 'kill ' + CONVERT(varchar(5), session_id) + ';'  
            FROM sys.dm_exec_sessions
            WHERE database_id  = db_id('appservice_hosting')
    
            EXEC(@kill);
    
            -- Convert database to contained
            USE [master]  
            GO  
            ALTER DATABASE [appservice_hosting] SET CONTAINMENT = PARTIAL  
            GO  
    
            /********[appservice_hosting] Migration End********/
    
  4. 將登入遷移至自主資料庫使用者。Migrate logins to contained database users.

        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
    

驗證Validate

  1. 檢查 SQL Server 是否已啟用內含項目。Check if SQL Server has containment enabled.

        sp_configure  @configname='contained database authentication'
    
  2. 檢查現有的自主行為。Check existing contained behavior.

        SELECT containment FROM sys.databases WHERE NAME LIKE (SELECT DB_NAME())
    

已知問題 (安裝後)Known issues (post-installation)

  • 將應用程式服務部署在現有的虛擬網路中且只能在私人網路上使用檔案伺服器時,背景工作角色無法連線到檔案伺服器。Workers are unable to reach file server when App Service is deployed in an existing virtual network and the file server is only available on the private network. 此問題會在 Azure App Service on Azure Stack Hub 部署文件中提及。This issue is called out in the Azure App Service on Azure Stack Hub deployment documentation.

如果您選擇要部署到現有的虛擬網路並以內部 IP 位址連線到檔案伺服器,便必須新增輸出安全性規則,以啟用背景工作角色子網路與檔案伺服器之間的 SMB 流量。If you chose to deploy into an existing virtual network and an internal IP address to connect to your file server, you must add an outbound security rule which enables SMB traffic between the worker subnet and the file server. 移至系統管理員入口網站中的 WorkersNsg,然後使用下列屬性新增輸出安全性規則:Go to the WorkersNsg in the administrator portal and add an outbound security rule with the following properties:

  • 來源:任意Source: Any
  • 來源連接埠範圍:*Source port range: *
  • 目的地:IP 位址Destination: IP addresses
  • 目的地 IP 位址範圍:檔案伺服器的 IP 範圍Destination IP address range: Range of IPs for your file server
  • 目的地連接埠範圍:445Destination port range: 445
  • 通訊協定:TCPProtocol: TCP
  • 動作:AllowAction: Allow
  • 優先順序:700Priority: 700
  • 名稱:Outbound_Allow_SMB445Name: Outbound_Allow_SMB445

雲端管理員操作 Azure App Service on Azure Stack Hub 時的已知問題Known issues for cloud admins operating Azure App Service on Azure Stack Hub

請參閱 Azure Stack Hub 1807 版本資訊中的文件。Refer to the documentation in the Azure Stack Hub 1807 release notes.

後續步驟Next steps