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

這些版本資訊說明 App Service on Azure Stack Hub 更新 5 的增強功能、修正和已知問題。These release notes describe improvements, fixes, and known issues in Azure App Service on Azure Stack Hub Update 5. 已知問題分為三個部分:直接與部署相關的問題、更新程序的問題,以及組建 (安裝後) 的問題。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.5 之前,請先將 1901 更新套用到您的 Azure Stack Hub 整合系統,或部署最新的 Azure Stack 開發套件 (ASDK)。Apply the 1901 update to your Azure Stack Hub integrated system or deploy the latest Azure Stack Development Kit (ASDK) before deploying Azure App Service 1.5.

建置參考Build reference

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

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.5 之前:Before you begin the upgrade of Azure App Service on Azure Stack Hub to 1.5:

  • 確定 Azure Stack Hub 系統管理員入口網站的 Azure App Service 管理中所有角色都已就緒。Ensure all roles are ready in the Azure App Service administration in the Azure Stack Hub administrator portal.

  • 在 Azure Stack Hub 管理入口網站中使用 App Service 管理來備份 App Service 祕密Backup App Service Secrets using the App Service Administration in the Azure Stack Hub Admin Portal

  • 備份 App Service 和 Master 資料庫:Back up the App Service and Master Databases:

    • AppService_Hosting;AppService_Hosting;
    • AppService_Metering;AppService_Metering;
    • MasterMaster
  • 備份租用戶應用程式內容檔案共用Back up the Tenant App content file share

    重要

    雲端操作員負責維護和操作檔案伺服器與 SQL Server。Cloud operators are responsible for the maintenance and operation of the File Server and SQL Server. 資源提供者不會管理這些資源。The resource provider does not manage these resources. 雲端操作員負責備份 App Service 資料庫和租用戶內容檔案共用。The cloud operator is responsible for backing up the App Service databases and tenant content file share.

  • 從 Azure Marketplace 同步發佈 自訂指令碼擴充功能 1.9.1 版。Syndicate the Custom Script Extension version 1.9.1 from Azure Marketplace.

新功能和修正New features and fixes

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

  • 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.12205Updates Azure Functions runtime to v1.0.12205.

  • 更新 Kudu 工具 來解決操作 已中斷連線 Azure Stack Hub 的客戶所遇到的樣式設定和功能方面的問題。Updates to Kudu tools to resolve issues with styling and functionality for customers operating disconnected Azure Stack Hub.

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

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

    • 已新增 ASP.NET Core 2.1.6 和 2.2.0Added ASP.NET Core 2.1.6 and 2.2.0
    • 已新增 NodeJS 10.14.1Added NodeJS 10.14.1
    • 已新增 NPM 6.4.1Added NPM 6.4.1
    • 已將 Kudu 更新為 79.20129.3767Updated Kudu to 79.20129.3767
  • 所有角色的基礎作業系統更新Updates to underlying operating system of all roles:

部署後步驟Post-deployment Steps

重要

如果您已對 App Service 資源提供者提供 SQL Always On 執行個體,就「必須」 將 appservice_hosting 和 appservice_metering 資料庫新增至可用性群組並同步處理資料庫,以避免在資料庫進行容錯移轉時中斷服務。If you've provided the App Service resource provider with a SQL Always On Instance you must add the appservice_hosting and appservice_metering databases to an availability group and synchronize the databases to prevent any loss of service in the event of a database failover.

更新後步驟Post-update steps

對於想要遷移至 Azure Stack Hub 部署上現有 Azure App Service 自主資料庫的客戶,請在 Azure App Service on Azure Stack Hub 1.5 更新完成之後,執行這些步驟: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.5 update has completed:

重要

移轉程序需要大約 5-10 分鐘才能完成。The migration procedure takes approximately 5-10 minutes. 此程序可能會終止現有的資料庫登入工作階段。The 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. 如果在更新至 Azure App Service on Azure Stack Hub 1.3 之後完成這些步驟,則不需要這些步驟。If you completed these steps after updating to Azure App Service on Azure Stack Hub 1.3 then these steps aren't required.

  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, the conversion 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.

        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
    

驗證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 1809 版本資訊中的文件。Refer to the documentation in the Azure Stack Hub 1809 release notes.

後續步驟Next steps