Skip to content

Commit 1f9eafc

Browse files
committed
Remove marketplace search
1 parent 2065343 commit 1f9eafc

File tree

3 files changed

+31
-39
lines changed

3 files changed

+31
-39
lines changed

articles/blockchain/workbench/deploy.md

Lines changed: 31 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: azure-blockchain
55
keywords:
66
author: PatAltimore
77
ms.author: patricka
8-
ms.date: 11/07/2019
8+
ms.date: 11/19/2019
99
ms.topic: article
1010
ms.service: azure-blockchain
1111
ms.reviewer: brendal
@@ -53,17 +53,9 @@ Azure Blockchain Workbench requires Azure AD configuration and application regis
5353
Once the prerequisite steps have been completed, you are ready to deploy the Blockchain Workbench. The following sections outline how to deploy the framework.
5454

5555
1. Sign in to the [Azure portal](https://portal.azure.com).
56-
2. Select your account in the top-right corner, and switch to the desired Azure AD tenant where you want to deploy Azure Blockchain Workbench.
57-
3. In the left pane, select **Create a resource**. Search for `Azure Blockchain Workbench` in the **Search the Marketplace** search bar.
58-
59-
![Marketplace search bar](media/deploy/marketplace-search-bar.png)
60-
61-
4. Select **Azure Blockchain Workbench**.
62-
63-
![Marketplace search results](media/deploy/marketplace-search-results.png)
64-
65-
5. Select **Create**.
66-
6. Complete the basic settings.
56+
1. Select your account in the top-right corner, and switch to the desired Azure AD tenant where you want to deploy Azure Blockchain Workbench.
57+
1. Select **Create a resource** in the upper left-hand corner of the Azure portal.
58+
1. Select **Blockchain** > **Azure Blockchain Workbench (preview)**.
6759

6860
![Create Azure Blockchain Workbench](media/deploy/blockchain-workbench-settings-basic.png)
6961

@@ -80,9 +72,9 @@ Once the prerequisite steps have been completed, you are ready to deploy the Blo
8072
| Resource groups | Create a new Resource group by selecting **Create new** and specify a unique resource group name. |
8173
| Location | Specify the region you wish to deploy the framework. |
8274

83-
7. Select **OK** to finish the basic setting configuration section.
75+
1. Select **OK** to finish the basic setting configuration section.
8476

85-
8. In **Advanced Settings**, choose if you want to create a new blockchain network or use an existing proof-of-authority blockchain network.
77+
1. In **Advanced Settings**, choose if you want to create a new blockchain network or use an existing proof-of-authority blockchain network.
8678

8779
For **Create new**:
8880

@@ -115,13 +107,13 @@ Once the prerequisite steps have been completed, you are ready to deploy the Blo
115107
| Azure Active Directory settings | Choose **Add Later**.</br>Note: If you chose to [pre-configure Azure AD](#azure-ad-configuration) or are redeploying, choose to *Add Now*. |
116108
| VM selection | Select preferred storage performance and VM size for your blockchain network. Choose a smaller VM size such as *Standard DS1 v2* if you are on a subscription with low service limits like Azure free tier. |
117109

118-
9. Select **OK** to finish Advanced Settings.
110+
1. Select **OK** to finish Advanced Settings.
119111

120-
10. Review the summary to verify your parameters are accurate.
112+
1. Review the summary to verify your parameters are accurate.
121113

122114
![Summary](media/deploy/blockchain-workbench-summary.png)
123115

124-
11. Select **Create** to agree to the terms and deploy your Azure Blockchain Workbench.
116+
1. Select **Create** to agree to the terms and deploy your Azure Blockchain Workbench.
125117

126118
The deployment can take up to 90 minutes. You can use the Azure portal to monitor progress. In the newly created resource group, select **Deployments > Overview** to see the status of the deployed artifacts.
127119

@@ -133,14 +125,14 @@ The deployment can take up to 90 minutes. You can use the Azure portal to monito
133125
Once the deployment of the Blockchain Workbench has completed, a new resource group contains your Blockchain Workbench resources. Blockchain Workbench services are accessed through a web URL. The following steps show you how to retrieve the web URL of the deployed framework.
134126

135127
1. Sign in to the [Azure portal](https://portal.azure.com).
136-
2. In the left-hand navigation pane, select **Resource groups**.
137-
3. Choose the resource group name you specified when deploying Blockchain Workbench.
138-
4. Select the **TYPE** column heading to sort the list alphabetically by type.
139-
5. There are two resources with type **App Service**. Select the resource of type **App Service** *without* the "-api" suffix.
128+
1. In the left-hand navigation pane, select **Resource groups**.
129+
1. Choose the resource group name you specified when deploying Blockchain Workbench.
130+
1. Select the **TYPE** column heading to sort the list alphabetically by type.
131+
1. There are two resources with type **App Service**. Select the resource of type **App Service** *without* the "-api" suffix.
140132

141133
![App service list](media/deploy/resource-group-list.png)
142134

143-
6. In the App Service **Overview**, copy the **URL** value, which represents the web URL to your deployed Blockchain Workbench.
135+
1. In the App Service **Overview**, copy the **URL** value, which represents the web URL to your deployed Blockchain Workbench.
144136

145137
![App service essentials](media/deploy/app-service.png)
146138

@@ -151,30 +143,30 @@ To associate a custom domain name with Blockchain Workbench, see [configuring a
151143
Azure AD must be configured to complete your Blockchain Workbench deployment. You'll use a PowerShell script to do the configuration.
152144

153145
1. In a browser, navigate to the [Blockchain Workbench Web URL](#blockchain-workbench-web-url).
154-
2. You'll see instructions to set up Azure AD using Cloud Shell. Copy the command and launch Cloud Shell.
146+
1. You'll see instructions to set up Azure AD using Cloud Shell. Copy the command and launch Cloud Shell.
155147

156148
![Launch AAD script](media/deploy/launch-aad-script.png)
157149

158-
3. Choose the Azure AD tenant where you deployed Blockchain Workbench.
159-
4. In Cloud Shell, paste and run the command.
160-
5. When prompted, enter the Azure AD tenant you want to use for Blockchain Workbench. This will be the tenant containing the users for Blockchain Workbench.
150+
1. Choose the Azure AD tenant where you deployed Blockchain Workbench.
151+
1. In Cloud Shell, paste and run the command.
152+
1. When prompted, enter the Azure AD tenant you want to use for Blockchain Workbench. This will be the tenant containing the users for Blockchain Workbench.
161153

162154
> [!IMPORTANT]
163155
> The authenticated user requires permissions to create Azure AD application registrations and grant delegated application permissions in the tenant. You may need to ask an administrator of the tenant to run the Azure AD configuration script or create a new tenant.
164156
165157
![Enter Azure AD tenant](media/deploy/choose-tenant.png)
166158

167-
6. You'll be prompted to authenticate to the Azure AD tenant using a browser. Open the web URL in a browser, enter the code, and authenticate.
159+
1. You'll be prompted to authenticate to the Azure AD tenant using a browser. Open the web URL in a browser, enter the code, and authenticate.
168160

169161
![Authenticate with code](media/deploy/authenticate.png)
170162

171-
7. The script outputs several status messages. You get a **SUCCESS** status message if the tenant was successfully provisioned.
172-
8. Navigate to the Blockchain Workbench URL. You are asked to consent to grant read permissions to the directory. This allows the Blockchain Workbench web app access to the users in the tenant. If you are the tenant administrator, you can choose to consent for the entire organization. This option accepts consent for all users in the tenant. Otherwise, each user is prompted for consent on first use of the Blockchain Workbench web application.
173-
9. Select **Accept** to consent.
163+
1. The script outputs several status messages. You get a **SUCCESS** status message if the tenant was successfully provisioned.
164+
1. Navigate to the Blockchain Workbench URL. You are asked to consent to grant read permissions to the directory. This allows the Blockchain Workbench web app access to the users in the tenant. If you are the tenant administrator, you can choose to consent for the entire organization. This option accepts consent for all users in the tenant. Otherwise, each user is prompted for consent on first use of the Blockchain Workbench web application.
165+
1. Select **Accept** to consent.
174166

175167
![Consent to read users profiles](media/deploy/graph-permission-consent.png)
176168

177-
10. After consent, the Blockchain Workbench web app can be used.
169+
1. After consent, the Blockchain Workbench web app can be used.
178170

179171
## Azure AD configuration
180172

@@ -191,11 +183,11 @@ Blockchain Workbench deployment requires registration of an Azure AD application
191183

192184
![App registration](media/deploy/app-registration.png)
193185

194-
4. Provide a display **Name** and choose **Accounts in this organizational directory only**.
186+
1. Provide a display **Name** and choose **Accounts in this organizational directory only**.
195187

196188
![Create app registration](media/deploy/app-registration-create.png)
197189

198-
5. Select **Register** to register the Azure AD application.
190+
1. Select **Register** to register the Azure AD application.
199191

200192
### Modify manifest
201193

@@ -227,21 +219,21 @@ Next, you need to modify the manifest to use application roles within Azure AD t
227219
> [!IMPORTANT]
228220
> The value **Administrator** is needed to identify Blockchain Workbench administrators.
229221

230-
4. In the manifest, also change the **Oauth2AllowImplicitFlow** value to **true**.
222+
1. In the manifest, also change the **Oauth2AllowImplicitFlow** value to **true**.
231223

232224
``` json
233225
"oauth2AllowImplicitFlow": true,
234226
```
235227

236-
5. Select **Save** to save the manifest changes.
228+
1. Select **Save** to save the manifest changes.
237229

238230
### Add Graph API required permissions
239231

240232
The API application needs to request permission from the user to access the directory. Set the following required permission for the API application:
241233

242234
1. In the *Blockchain API* app registration, select **API permissions**. By default, the Graph API **User.Read** permission is added.
243235

244-
3. In **Grant consent**, select **Grant admin consent** for the domain then select **Yes** for the verification prompt.
236+
1. In **Grant consent**, select **Grant admin consent** for the domain then select **Yes** for the verification prompt.
245237

246238
![Grant permissions](media/deploy/client-app-grant-permissions.png)
247239

@@ -252,7 +244,7 @@ The API application needs to request permission from the user to access the dire
252244
The application ID and tenant information are required for deployment. Collect and store the information for use during deployment.
253245

254246
1. For the application you registered, select **Overview**.
255-
2. Copy and store the **Application ID** value for later use during deployment.
247+
1. Copy and store the **Application ID** value for later use during deployment.
256248

257249
![API app properties](media/deploy/app-properties.png)
258250

@@ -273,7 +265,7 @@ In the left-hand navigation pane, select the **Azure Active Directory** service.
273265
If you have guest users in your Azure AD tenant, follow the additional steps to ensure Blockchain Workbench user assignment and management works properly.
274266

275267
1. Switch you your Azure AD tenant and select **Azure Active Directory > User settings > Manage external collaboration settings**.
276-
2. Set **Guest user permissions are limited** to **No**.
268+
1. Set **Guest user permissions are limited** to **No**.
277269
![External collaboration settings](media/deploy/user-collaboration-settings.png)
278270

279271
## Configuring the reply URL
@@ -300,7 +292,7 @@ Once the Azure Blockchain Workbench has been deployed, you have to configure the
300292
When a deployment is no longer needed, you can remove a deployment by deleting the Blockchain Workbench resource group.
301293

302294
1. In the Azure portal, navigate to **Resource group** in the left navigation pane and select the resource group you want to delete.
303-
2. Select **Delete resource group**. Verify deletion by entering the resource group name and select **Delete**.
295+
1. Select **Delete resource group**. Verify deletion by entering the resource group name and select **Delete**.
304296

305297
![Delete resource group](media/deploy/delete-resource-group.png)
306298

Binary file not shown.
Binary file not shown.

0 commit comments

Comments
 (0)