[App Service] az webapp update: Add parameter --platform-release-channel to support setting the platform release channel for the web app

linter_exclusions.yml

@@ -3966,6 +3966,9 @@ webapp update:
     force_dns_registration:
       rule_exclusions:
       - option_length_too_long
+    platform_release_channel:
+      rule_exclusions:
+      - option_length_too_long
     skip_custom_domain_verification:
       rule_exclusions:
       - option_length_too_long

src/azure-cli/azure/cli/command_modules/appservice/_help.py

@@ -2627,6 +2627,9 @@
   - name: Update a web app. (autogenerated)
     text: az webapp update --https-only true --name MyAppName --resource-group MyResourceGroup
     crafted: true
+  - name: Update the platform release channel of a web app. Possible values are Latest, Standard, Extended.
+    text: az webapp update --platform-release-channel Extended --name MyAppName --resource-group MyResourceGroup
+    crafted: true
 """
 
 helps['webapp vnet-integration'] = """

src/azure-cli/azure/cli/command_modules/appservice/_params.py

@@ -41,6 +41,7 @@
 ASE_KINDS = ['ASEv3']
 PUBLIC_NETWORK_ACCESS_MODES = ['Enabled', 'Disabled']
 BASIC_AUTH_TYPES = ['Enabled', 'Disabled']
+PLATFORM_RELEASE_CHANNEL_TYPES = ['Standard', 'Latest', 'Extended']
 DAPR_LOG_LEVELS = ['debug', 'error', 'info', 'warn']
 INSTALL_SCRIPT_TYPES = ['RemoteAzureBlob', 'PlatformStorage']
 STORAGE_MOUNT_TYPES = ['AzureFiles', 'LocalStorage', 'FileShare']
@@ -454,6 +455,9 @@ def load_arguments(self, _):
         c.argument('end_to_end_encryption_enabled', options_list=['--end-to-end-encryption-enabled', '-e'],
                    help='Enable or disable end-to-end encryption between the Front End and the Workers.',
                    arg_type=get_three_state_flag(return_label=True))
+        c.argument('platform_release_channel', options_list=['--platform-release-channel'],
+                   help='Set the platform release channel for the web app. Possible values: Latest, Standard, Extended.',
+                   arg_type=get_enum_type(PLATFORM_RELEASE_CHANNEL_TYPES))
 
     with self.argument_context('webapp browse') as c:
         c.argument('logs', options_list=['--logs', '-l'], action='store_true',

src/azure-cli/azure/cli/command_modules/appservice/custom.py

@@ -2153,7 +2153,8 @@ def set_webapp(cmd, resource_group_name, name, slot=None, skip_dns_registration=
 
 
 def update_webapp(cmd, instance, client_affinity_enabled=None, https_only=None, minimum_elastic_instance_count=None,
-                  prewarmed_instance_count=None, end_to_end_encryption_enabled=None):
+                  prewarmed_instance_count=None, end_to_end_encryption_enabled=None,
+                  platform_release_channel=None):
     if 'function' in instance.kind:
         raise ValidationError("please use 'az functionapp update' to update this function app")
     if minimum_elastic_instance_count or prewarmed_instance_count:
@@ -2190,6 +2191,10 @@ def update_webapp(cmd, instance, client_affinity_enabled=None, https_only=None,
     if prewarmed_instance_count is not None:
         instance.site_config.pre_warmed_instance_count = prewarmed_instance_count
 
+    if platform_release_channel is not None:
+        use_additional_properties(instance)
+        instance.additional_properties["properties"]["platformReleaseChannel"] = platform_release_channel
+
     return instance
 
 

src/azure-cli/azure/cli/command_modules/appservice/tests/latest/test_webapp_commands.py

@@ -2164,6 +2164,28 @@ def test_webapp_update(self, resource_group):
             self.check('clientAffinityEnabled', True)
         ])
 
+    @AllowLargeResponse()
+    @ResourceGroupPreparer(location=WINDOWS_ASP_LOCATION_WEBAPP)
+    def test_webapp_update_platform_release_channel(self, resource_group):
+        webapp_name = self.create_random_name('webapp-prc-test', 40)
+        plan_name = self.create_random_name('webapp-prc-plan', 40)
+        self.cmd('appservice plan create -g {} -n {} --sku S1'
+                 .format(resource_group, plan_name))
+
+        self.cmd('webapp create -g {} -n {} --plan {}'
+                 .format(resource_group, webapp_name, plan_name))
+
+        # JMESPathCheck is not used here since platformReleaseChannel is not returned in the response of webapp show/list commands and we just want to make sure the update command goes through without any errors
+        # Set platform release channel to Extended
+        self.cmd('webapp update -g {} -n {} --platform-release-channel Extended'
+                 .format(resource_group, webapp_name)).assert_with_checks([
+                     JMESPathCheck('name', webapp_name)])
+
+        # Update platform release channel to Standard
+        self.cmd('webapp update -g {} -n {} --platform-release-channel Standard'
+                 .format(resource_group, webapp_name)).assert_with_checks([
+                     JMESPathCheck('name', webapp_name)])
+
     @AllowLargeResponse()
     @ResourceGroupPreparer(location=WINDOWS_ASP_LOCATION_WEBAPP)
     def test_webapp_update_e2e_encryption(self, resource_group):

src/azure-cli/azure/cli/command_modules/appservice/tests/latest/test_webapp_commands_thru_mock.py

@@ -32,7 +32,8 @@
                                                          create_managed_ssl_cert,
                                                          add_github_actions,
                                                          update_app_settings,
-                                                         update_application_settings_polling)
+                                                         update_application_settings_polling,
+                                                         update_webapp)
 
 # pylint: disable=line-too-long
 from azure.cli.core.profiles import ResourceType
@@ -603,6 +604,41 @@ def test_update_app_settings_success_with_slot_settings(self, mock_build, mock_s
         mock_build.assert_called_once()
 
 
+class TestUpdateWebapp(unittest.TestCase):
+
+    def _create_site_instance(self, cmd):
+        Site = cmd.get_models('Site')
+        SiteConfig = cmd.get_models('SiteConfig')
+        site_config = SiteConfig(number_of_workers=1)
+        instance = Site(location='eastus', site_config=site_config)
+        instance.kind = 'app,linux'
+        return instance
+
+    def test_update_webapp_platform_release_channel_extended(self):
+        cmd_mock = _get_test_cmd()
+        instance = self._create_site_instance(cmd_mock)
+
+        result = update_webapp(cmd_mock, instance, platform_release_channel='Extended')
+
+        self.assertEqual(result.additional_properties["properties"]["platformReleaseChannel"], "Extended")
+
+    def test_update_webapp_platform_release_channel_standard(self):
+        cmd_mock = _get_test_cmd()
+        instance = self._create_site_instance(cmd_mock)
+
+        result = update_webapp(cmd_mock, instance, platform_release_channel='Standard')
+
+        self.assertEqual(result.additional_properties["properties"]["platformReleaseChannel"], "Standard")
+
+    def test_update_webapp_platform_release_channel_latest(self):
+        cmd_mock = _get_test_cmd()
+        instance = self._create_site_instance(cmd_mock)
+
+        result = update_webapp(cmd_mock, instance, platform_release_channel='Latest')
+
+        self.assertEqual(result.additional_properties["properties"]["platformReleaseChannel"], "Latest")
+
+
 class FakedResponse:  # pylint: disable=too-few-public-methods
     def __init__(self, status_code):
         self.status_code = status_code