Merge pull request #41 from microsoft/sovereign_cloud_installation_in…

…structions

Update INSTALLATION.md

INSTALLATION.md

@@ -1,33 +1,51 @@
 # App Installation Guide
 
-This document provides instructions on how to download the app package and install the sample app by uploading a [custom app](https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/apps-upload) to Teams or [import the app as a solution](https://learn.microsoft.com/en-us/power-apps/teams/import-solution-in-teams) to your Power Apps environment.
+This document provides instructions on how to download the app package and install the sample app by uploading a [custom app](https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/apps-upload) to Teams or [importing the app as a solution](https://learn.microsoft.com/en-us/power-apps/teams/import-solution-in-teams) to your Power Apps environment.
 
 
 ## Contents 
 1. [Upload the app to Teams as a custom app](#p1)
-2. [Import the solution to Power Apps environment](#p2)
----
+3. [Import the solution to Power Apps environment](#p2)
 
 ## Upload the app to Teams as a custom app<a name="p1"></a>
-Below are the steps for uploading sample app 'Milestones' as a Teams custom app. You can use similar steps to install other sample apps.
+The sample apps can be uploaded via the Teams client or through the Teams admin center. These two installation methods are only available to the Public and GCC clouds. DoD admins, however, are also able to upload a custom app via the Teams client. Below are the steps for uploading sample app 'Milestones' as a Teams custom app. You can use similar steps to install other sample apps.   
 
 1. Browse to the Releases section of the Github repository.  
 ![image](https://user-images.githubusercontent.com/84343636/210909295-2cd818b2-c77a-4176-9a8b-f0f76b816956.png)
 
 2. Review the assets for the latest release and download the 'AppPackages.zip' file.  
 ![image](https://user-images.githubusercontent.com/84343636/210909692-0a65cf3d-7065-4ee3-ac1d-0269d6aac177.png)
 
-3. Extract the ZIP file and go to the 'Milestones' folder. Find the file 'TeamsCustomApp.zip'.  
+3. Extract the ZIP file and go to the 'Milestones' folder. Find the custom app ZIP file appropriate for your cloud. The file name is simply 'TeamsCustomApp.zip' for the Public cloud. For GCC and DoD clouds, the file name will have a suffix (i.e. '\_GCC' or '\_DoD').
 ![image](https://user-images.githubusercontent.com/84343636/210910318-3ddbcd33-ddbb-44d3-a5c9-0d03f758c47f.png)
 
-4. Go to 'Teams' - 'Apps' - 'Manage your apps' - 'Upload an app' - 'Upload a custom app'.  
+Below are the steps for uploading the app via the [Teams client](#p1a) and via the [Teams admin center](#p1b). Follow the steps for your chosen installation method, and then go to Step 6.
+
+---
+
+### Option #1: Upload the app via the Teams client<a name="p1a"></a>
+
+4. Go to 'Teams' - 'Apps' - 'Manage your apps' - 'Upload an app' - 'Upload a custom app'. 
 ![image](https://user-images.githubusercontent.com/84343636/210911499-c30a25ff-4cc8-4147-b475-3494550fc2b9.png)
 
-5. Select the 'TeamsCustomApp.zip' from Step 3 and click 'Open'.  
+5. Select the custom app ZIP from Step 3 and click 'Open'. Go to Step 6.
 ![image](https://user-images.githubusercontent.com/84343636/210911862-12d03758-7f0b-4cb3-a9f0-f252e75f928d.png)
 
-6. On the pop-up card, click 'Add to a team' to continue.  
-![image](https://user-images.githubusercontent.com/84343636/210911990-7afff477-7daf-4d3e-982a-be76737c264c.png)
+### Option #2: Upload the app via the Teams admin center<a name="p1b"></a>
+
+4. In the Microsoft Teams Admin center, go to 'Teams apps' - 'Manage apps' and click 'Upload new app'. 
+![image](https://user-images.githubusercontent.com/122298060/224442989-cf5e7adf-acf2-4bbd-be55-548f664acf35.png)
+
+5. Select the 'Upload' button and choose the custom app ZIP from Step 3. Click 'Open'.  
+![image](https://user-images.githubusercontent.com/84343636/210911862-12d03758-7f0b-4cb3-a9f0-f252e75f928d.png)
+
+   Find the custom app in the Teams store. Note that the developer name is "Open Source". Select the app. Go to Step 6.
+![image](https://user-images.githubusercontent.com/122298060/224800653-b2dcf649-ee0f-4e10-a67f-118a073f35f6.png)
+
+---
+
+6. On the pop-up card, click 'Add to a team'.
+![image](https://user-images.githubusercontent.com/122298060/224798342-b7284970-2824-4cfe-a52b-31db212a6d8e.png)
 
 7. Select the channel in the Teams team where you want to install the app and click 'Set up a tab' to continue.  
 ![image](https://user-images.githubusercontent.com/84343636/210912245-68315923-b1aa-47be-be5a-4ef0586d7839.png)
@@ -41,7 +59,6 @@ Below are the steps for uploading sample app 'Milestones' as a Teams custom app.
 10. Go back to your Teams channel and start using the Milestones app in the tab.  
 ![image](https://user-images.githubusercontent.com/84343636/210912785-5e5b0048-506f-49dd-8763-5a8403d58dbc.png)
 
-
 ## Import the solution to Power Apps environment<a name="p2"></a>
 Below are the steps for import sample app 'Boards' as a dataverse solution. You can use similar steps to install other sample apps.
 You need to have a [Power Apps Teams environment](https://learn.microsoft.com/en-us/power-platform/admin/about-teams-environment) as a prerequisite.
@@ -58,10 +75,14 @@ You need to have a [Power Apps Teams environment](https://learn.microsoft.com/en
 4. Open Teams. Go to the Power Apps personal app. If you do not have it installed, install the app from the Teams app store.  
 ![03](https://user-images.githubusercontent.com/84343636/210960240-224a9a54-5bd6-40a7-9b09-07af23847027.jpeg)
 
-5. In the 'Build' tab, browse to the Teams team environment where you’d like to import the solution. If you don't see the team you're interested in, an environment needs to be created for that team. Kick-off environment creation by creating a blank app in that team. Click the 'Create' button and follow the prompts.
+5. In the 'Build' tab, browse to the Teams team environment where you’d like to import the solution. If you don't see the team you're interested in, an environment needs to be created for that team. Kick-off environment creation by clicking the 'Create' button and following the prompts.
 
 ![image](https://user-images.githubusercontent.com/122298060/222273910-ee15efdc-c808-4d33-95e3-05a5f97d33dc.png)
 
+Once you see this pop-up, environment creation has begun, and this pop-up can be closed. You may need to wait a short time before the environment becomes visible in the 'Build' tab.
+
+![image](https://user-images.githubusercontent.com/122298060/224439408-d5afef83-6f10-45bd-89fc-4846063beae0.png)
+
 6. If there are apps in the 'Built by this team' section, select 'See all', and go to Step 7.  
 ![04](https://user-images.githubusercontent.com/84343636/210960269-fec54f92-8d0f-44bc-85b2-1182f6414534.jpeg)  
 Otherwise, if there are no apps in this section, click the 'Import your solution' button, and skip to Step 7.