Skip to content

Commit 1845755

Browse files
authored
Merge pull request #88022 from PatAltimore/patricka-blockchain-split-tutorial
Split tutorial into quickstart and tutorial
2 parents 82fb72c + 619affb commit 1845755

File tree

11 files changed

+97
-61
lines changed

11 files changed

+97
-61
lines changed

articles/blockchain/service/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,8 @@
1313
href: create-member-cli.md
1414
- name: Connect to transaction node
1515
items:
16+
- name: Using VS Code
17+
href: connect-vscode.md
1618
- name: Using MetaMask
1719
href: connect-metamask.md
1820
- name: Using Geth

articles/blockchain/service/connect-geth.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Geth is a Go Ethereum client you can use to attach to a Geth instance on an Azur
2222
## Prerequisites
2323

2424
* Install [Geth](https://github.com/ethereum/go-ethereum/wiki/geth)
25-
* [Create an Azure Blockchain member](create-member.md)
25+
* Complete [Quickstart: Create a blockchain member using the Azure portal](create-member.md) or [Quickstart: Create an Azure Blockchain Service blockchain member using Azure CLI](create-member-cli.md)
2626

2727
## Get the Geth connection string
2828

@@ -63,7 +63,7 @@ You can find the Geth connection string in the Azure portal.
6363
6464
## Next steps
6565
66-
In this quickstart, you used the Geth client to attach to a Geth instance on an Azure Blockchain Service transaction node. Try the next tutorial to deploy and send a transaction using Truffle.
66+
In this quickstart, you used the Geth client to attach to a Geth instance on an Azure Blockchain Service transaction node. Try the next tutorial to use Azure Blockchain Development Kit for Ethereum and Truffle to create, build, deploy, and execute a smart contract function via a transaction.
6767
6868
> [!div class="nextstepaction"]
69-
> [Send a transaction](send-transaction.md)
69+
> [Use Visual Studio Code to create, build, and deploy smart contracts](send-transaction.md)

articles/blockchain/service/connect-metamask.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ In this quickstart, you'll use MetaMask to connect to an Azure Blockchain Servic
2121

2222
## Prerequisites
2323

24-
* [Create an Azure Blockchain member](create-member.md)
24+
* Complete [Quickstart: Create a blockchain member using the Azure portal](create-member.md) or [Quickstart: Create an Azure Blockchain Service blockchain member using Azure CLI](create-member-cli.md)
2525
* Install [MetaMask browser extension](https://metamask.io)
2626
* Generate a MetaMask [wallet](https://metamask.zendesk.com/hc/en-us/articles/360015488971-New-to-MetaMask-Learn-How-to-Setup-MetaMask-the-First-Time)
2727

@@ -140,7 +140,7 @@ Remix is a browser-based Solidity development environment. Using MetaMask and Re
140140
141141
## Next steps
142142
143-
In this quickstart, you used the MetaMask browser extension to connect to an Azure Blockchain Service transaction node, deploy a smart contract, and send a transaction to the blockchain. Try the next tutorial to deploy and send a transaction using Truffle.
143+
In this quickstart, you used the MetaMask browser extension to connect to an Azure Blockchain Service transaction node, deploy a smart contract, and send a transaction to the blockchain. Try the next tutorial to use Azure Blockchain Development Kit for Ethereum and Truffle to create, build, deploy, and execute a smart contract function via a transaction.
144144
145145
> [!div class="nextstepaction"]
146-
> [Send a transaction](send-transaction.md)
146+
> [Use Visual Studio Code to create, build, and deploy smart contracts](send-transaction.md)

articles/blockchain/service/connect-truffle.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Truffle is a blockchain development environment you can use to connect to an Azu
2121

2222
## Prerequisites
2323

24-
* [Create an Azure Blockchain member](create-member.md)
24+
* Complete [Quickstart: Create a blockchain member using the Azure portal](create-member.md) or [Quickstart: Create an Azure Blockchain Service blockchain member using Azure CLI](create-member-cli.md)
2525
* Install [Truffle](https://github.com/trufflesuite/truffle). Truffle requires several tools to be installed including [Node.js](https://nodejs.org), [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git).
2626
* Install [Python 2.7.15](https://www.python.org/downloads/release/python-2715/). Python is needed for Web3.
2727

@@ -120,7 +120,7 @@ Use *Web3* to connect to the transaction node.
120120

121121
In this quickstart, you created a Truffle project to connect to your Azure Blockchain Service default transaction node.
122122

123-
Try the next tutorial to use Azure Blockchain Development Kit for Ethereum and Truffle to execute a smart contract function via a transaction on a consortium blockchain network.
123+
Try the next tutorial to use Azure Blockchain Development Kit for Ethereum and Truffle to create, build, deploy, and execute a smart contract function via a transaction.
124124

125125
> [!div class="nextstepaction"]
126-
> [Use smart contracts on Azure Blockchain Service](send-transaction.md)
126+
> [Use Visual Studio Code to create, build, and deploy smart contracts](send-transaction.md)
Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
---
2+
title: Use Azure Blockchain Development Kit for Ethereum to connect to Azure Blockchain Service
3+
description: Connect to an Azure Blockchain Service consortium network using the Azure Blockchain Development Kit for Ethereum extension in Visual Studio Code
4+
services: azure-blockchain
5+
keywords:
6+
author: PatAltimore
7+
ms.author: patricka
8+
ms.date: 09/10/2019
9+
ms.topic: quickstart
10+
ms.service: azure-blockchain
11+
ms.reviewer: chrisseg
12+
manager: femila
13+
#Customer intent: As a developer, I want to connect to my blockchain consortium so that I can perform actions on a blockchain.
14+
---
15+
16+
# Quickstart: Use Visual Studio Code to connect to an Azure Blockchain Service consortium network
17+
18+
In this quickstart, you install and use the Azure Blockchain Development Kit for Ethereum Visual Studio Code extension to attach to a consortium on Azure Blockchain Service. The Azure Blockchain Development Kit simplifies how you create, connect, build, and deploy smart contracts on Ethereum ledgers.
19+
20+
[!INCLUDE [quickstarts-free-trial-note](../../../includes/quickstarts-free-trial-note.md)]
21+
22+
## Prerequisites
23+
24+
* Complete [Quickstart: Create a blockchain member using the Azure portal](create-member.md) or [Quickstart: Create an Azure Blockchain Service blockchain member using Azure CLI](create-member-cli.md)
25+
* [Visual Studio Code](https://code.visualstudio.com/Download)
26+
* [Azure Blockchain Development Kit for Ethereum extension](https://marketplace.visualstudio.com/items?itemName=AzBlockchain.azure-blockchain)
27+
* [Node.js](https://nodejs.org)
28+
* [Git](https://git-scm.com)
29+
* [Python](https://www.python.org/downloads/release/python-2715/). Add python.exe to your path. Python in your path is required for Azure Blockchain Development Kit.
30+
* [Truffle](https://www.trufflesuite.com/docs/truffle/getting-started/installation)
31+
* [Ganache CLI](https://github.com/trufflesuite/ganache-cli)
32+
33+
### Verify Azure Blockchain Development Kit environment
34+
35+
Azure Blockchain Development Kit verifies your development environment prerequisites have been met. To verify your development environment:
36+
37+
From the VS Code command palette, choose **Azure Blockchain: Show Welcome Page**.
38+
39+
Azure Blockchain Development Kit runs a validation script that takes about a minute to complete. You can view the output by selecting **Terminal > New Terminal**. In the terminal menu bar, select the **Output** tab and **Azure Blockchain** in the dropdown. Successful validation looks like the following image:
40+
41+
![Valid dev environment](./media/connect-vscode/valid-environment.png)
42+
43+
If you are missing a required tool, a new tab named **Azure Blockchain Development Kit - Preview** lists the required apps to install and links to download the tools.
44+
45+
![Dev kit required apps](./media/connect-vscode/required-apps.png)
46+
47+
Install any missing prerequisites before continuing with the quickstart.
48+
49+
## Connect to consortium member
50+
51+
You can connect to consortium members using the Azure Blockchain Development Kit VS Code extension. Once connected to a consortium, you can compile, build, and deploy smart contracts to an Azure Blockchain Service consortium member.
52+
53+
If you don't have access to an Azure Blockchain Service consortium member, complete the prerequisite [Quickstart: Create a blockchain member using the Azure portal](create-member.md) or [Quickstart: Create an Azure Blockchain Service blockchain member using Azure CLI](create-member-cli.md).
54+
55+
1. In the Visual Studio Code (VS Code) explorer pane, expand the **Azure Blockchain** extension.
56+
1. Select **Connect to Consortium**.
57+
58+
![Connect to consortium](./media/connect-vscode/connect-consortium.png)
59+
60+
If prompted for Azure authentication, follow the prompts to authenticate using a browser.
61+
1. Choose **Connect to Azure Blockchain Service consortium** in the command palette dropdown.
62+
1. Choose the subscription and resource group associated with your Azure Blockchain Service consortium member.
63+
1. Choose your consortium from the list.
64+
65+
The consortium and blockchain members are listed in the Visual Studio explorer side bar.
66+
67+
![Consortium displayed in explorer](./media/connect-vscode/consortium-node.png)
68+
69+
## Next steps
70+
71+
In this quickstart, you used Azure Blockchain Development Kit for Ethereum Visual Studio Code extension to attach to a consortium on Azure Blockchain Service. Try the next tutorial to use Azure Blockchain Development Kit for Ethereum and Truffle to create, build, deploy, and execute a smart contract function via a transaction.
72+
73+
> [!div class="nextstepaction"]
74+
> [Use Visual Studio Code to create, build, and deploy smart contracts](send-transaction.md)

articles/blockchain/service/index.yml

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,8 @@ landingContent:
3939
url: create-member-cli.md
4040
- linkListType: quickstart
4141
links:
42+
- text: Use Visual Studio Code to connect to a consortium network
43+
url: connect-vscode.md
4244
- text: Use MetaMask to connect and Remix to deploy a smart contract
4345
url: connect-metamask.md
4446
- text: Use Geth to connect to a transaction node
@@ -47,7 +49,7 @@ landingContent:
4749
url: connect-truffle.md
4850
- linkListType: tutorial
4951
links:
50-
- text: Use smart contracts on Azure Blockchain Service
52+
- text: Use Visual Studio Code to create, build, and deploy smart contracts
5153
url: send-transaction.md
5254
- linkListType: video
5355
links:

0 commit comments

Comments
 (0)