Merge pull request #296898 from jeffwmartinez/jefmarti-py-win-linux

adding guidance doc

Author: JillGrant615

articles/app-service/app-service-migration-windows-linux.md

@@ -0,0 +1,41 @@
+---
+title: What to consider when migrating from Windows to Linux on App Service 
+description: Learn key considerations when migrating apps from Windows to Linux on Azure App Service.
+keywords: azure app service, web app, python, windows, linux, migration
+author: jefmarti
+
+ms.topic: overview
+ms.date: 03/25/2025
+ms.author: jefmarti
+---
+# What to consider when migrating from Windows to Linux on App Service
+
+Azure App Service supports both Windows and Linux. The supported OS depends on your apps runtime of choice. If a given runtime is no longer supported on an OS, you may need to migrate your application to a supported OS. 
+
+If you received a notification that you need to migrate your Python on Windows apps to Linux, consider the following topics when migrating. 
+
+### Code dependencies and compatibility 
+
+Ensure that any dependencies or components that your application uses are also available on Linux. If Windows specific dependencies are not available on Linux, you may have to find an equivalent Linux option. 
+
+### Deployment tools 
+
+If you use continuous deployment tools like GitHub Actions or Azure Pipelines, you need to make sure the build agent is using the correct operating system. For Windows to Linux, the build agent should be changed from using Windows to Ubuntu. 
+
+### App Service features 
+
+While most App Service features will have parity between Windows and Linux, some Windows specific features like the Console are replaced with SSH tools on Linux. 
+
+### Domain name 
+
+Deploying a new Linux application requires a new name for your app. Keep in mind any connected custom domains need to be updated to route to the new name as well. 
+
+### Networking 
+
+When redeploying your application to Linux, your inbound IP address changes. See the documentation for more information on inbound IP addresses. 
+
+### Managed Identity 
+
+If you managed identity is configured with your applications, be sure to update your granted permissions to use the deployed Linux application. 
+
+ 

articles/app-service/toc.yml

@@ -541,6 +541,28 @@ items:
       href: https://azure.microsoft.com/resources/samples/?service=app-service
     - name: Videos
       href: https://azure.microsoft.com/resources/videos/index/?services=app-service
+    - name: Migrate to App Service
+      items:
+        - name: Assess .NET
+          href: app-service-migration-assess-net.md
+        - name: Discover .NET
+          href: app-service-migration-discover-net.md
+        - name: Migrate .NET
+          href: app-service-asp-net-migration.md
+        - name: Migrate containerized .NET
+          href: ../migrate/tutorial-app-containerization-aspnet-app-service.md?bc=/azure/bread/toc.json&toc=/azure/app-service/toc.json
+        - name: Migrate Java
+          href: app-service-java-migration.md
+        - name: Migrate Tomcat
+          href: /azure/developer/java/migration/migrate-tomcat-to-tomcat-app-service?toc=/azure/app-service/toc.json&bc=/azure/bread/toc.json
+        - name: Migrate JBoss EAP
+          href: /azure/developer/java/migration/migrate-jboss-eap-to-jboss-eap-on-azure-app-service?toc=/azure/app-service/toc.json&bc=/azure/bread/toc.json
+        - name: Migrate WebLogic
+          href: /azure/developer/java/migration/migrate-weblogic-to-jboss-eap-on-azure-app-service?toc=/azure/app-service/toc.json&bc=/azure/bread/toc.json
+        - name: Migrate WebSphere
+          href: /azure/developer/java/migration/migrate-websphere-to-jboss-eap-on-azure-app-service?toc=/azure/app-service/toc.json&bc=/azure/bread/toc.json
+        - name: Migrate Python Windows apps to Linux
+          href: app-service-migration-windows-linux.md
     - name: Cookbooks
       items:
         - name: Reference Architectures