mirror of https://github.com/hyperledger/besu
Azure quickstart tutorial seed (#536)
* Quick typo fix on Private-Network-Quickstart.md * Seeded azure quickstart ready to be improved by technical writers Signed-off-by: Adrian Sutton <adrian.sutton@consensys.net>pull/2/head
parent
4503db764a
commit
ee1ef2aba7
@ -0,0 +1,168 @@ |
|||||||
|
description: Pantheon private network quickstart on Azure tutorial |
||||||
|
<!--- END of page meta data --> |
||||||
|
|
||||||
|
# Azure Private Network Quickstart tutorial |
||||||
|
|
||||||
|
This tutorial describes how to use the [Pantheon quickstart](https://github.com/PegaSysEng/pantheon-quickstart) |
||||||
|
to run a private network of Pantheon nodes in a Docker container in a Linux Virtual |
||||||
|
machine hosted on Microsoft Azure. |
||||||
|
|
||||||
|
## Requirements |
||||||
|
|
||||||
|
* An azure account. A [free trial account](https://azure.microsoft.com/en-us/free/) will work for this tutorial. |
||||||
|
* Be able to conne t to a remote console using SSH. If you use Linux or macOS, you already have one |
||||||
|
integrated, otherwise you can try tools like [Putty](https://www.putty.org/) (free; open-source), |
||||||
|
[mRemoteNG](https://mremoteng.org/) (free; open-source), |
||||||
|
[Terminals](https://github.com/terminals-Origin/Terminals) (free; open-source) |
||||||
|
or [MobaXterm](https://mobaxterm.mobatek.net/) (free; paid Pro version available). |
||||||
|
|
||||||
|
## Connect to Azure Portal |
||||||
|
Log in to [Azure portal](https://portal.azure.com/) using your account credentials. |
||||||
|
|
||||||
|
## Creating resources |
||||||
|
On the home page, click on ![Create resource button](create-resource-button-screenshot.png) |
||||||
|
at the top left hand corner. |
||||||
|
|
||||||
|
Search the Marketplace for **Ubuntu Server 18.04 LTS** by Canonical and click on it. |
||||||
|
An information page is displayed. Accept the default deployment model of Resource Manager and click **Create**. |
||||||
|
|
||||||
|
In **Create a virtual machine**, set the following values for each tab as follows:: |
||||||
|
|
||||||
|
### Basics step |
||||||
|
* Subscription --> free trial |
||||||
|
* Resource group --> create a new one and call it as you like, "pantheon-quickstart" may be a good name. |
||||||
|
* Virtual machine name --> quickstart |
||||||
|
* Region --> **Central US** will probably selected by default, don't bother changing it. |
||||||
|
* Availability options --> No infrastructure redundancy required |
||||||
|
* Image --> Ubuntu Server 18.04 LTS |
||||||
|
* Size --> You can keep the proposed hosting plan size as this quickstart won't require a lot |
||||||
|
of power and disk space. A **Standard D2s v3 (2 vcpus, 8 GB memory)** will do the job and will be |
||||||
|
less expensive. |
||||||
|
* Authentication type --> choose the one you prefer, as this is not a critical machine, you can just |
||||||
|
use a password, but a SSH public key is nice too and simpler if you have one. |
||||||
|
* Username --> provide a user name, here we propose **azure** as a user name and we'll use it all |
||||||
|
along this tutorial. |
||||||
|
* Depending on the authentication method you chose, either fill the password or the public key. |
||||||
|
* Login with Azure Acrive Directory --> keep it **off** |
||||||
|
* Public inbound ports --> Allow selected ports |
||||||
|
* Select inbound ports --> select **HTTP** and **SSH** |
||||||
|
|
||||||
|
Then go up on the top of the page and switch to the **Guest config** step tab. |
||||||
|
|
||||||
|
### Guest config |
||||||
|
This step aims at installing required software (Docker and Docker-compose) on your virtual machine |
||||||
|
and retrieve and run the quickstart private network. |
||||||
|
|
||||||
|
To do so, click on the link named **Select an extension to install** and a new resource pane will |
||||||
|
appear on the right. |
||||||
|
|
||||||
|
In the list click on **Custom Script For Linux**, another pane opens with a blue **Create** button at |
||||||
|
its bottom, click on it. |
||||||
|
|
||||||
|
A form with only two fields appear: |
||||||
|
|
||||||
|
First open another browser tab or window with [https://raw.githubusercontent.com/PegaSysEng/pantheon-quickstart/master/azure/install_and_run.sh](https://raw.githubusercontent.com/PegaSysEng/pantheon-quickstart/master/azure/install_and_run.sh) |
||||||
|
|
||||||
|
Save (++ctrl+s++) this script to your computer, anywhere you like, as install_and_run.sh. |
||||||
|
|
||||||
|
Then click on the **Script files** field, and once the file browsing dialog appear, select the `install_and_run.sh` |
||||||
|
you just saved. |
||||||
|
|
||||||
|
Fill the second field named **Command** with the following informations (replacing the pre filled `sh script.sh`): |
||||||
|
|
||||||
|
```bash |
||||||
|
sh install_and_run.sh azure |
||||||
|
``` |
||||||
|
|
||||||
|
!!!important |
||||||
|
The username is included at the end of this command, **azure** in our case, but change |
||||||
|
to whatever you defined on the Basics step if you did not use the same as us. |
||||||
|
|
||||||
|
Then click **Ok** and then on the **Review + create** blue button at the bottom. |
||||||
|
|
||||||
|
Then once everything is ok (a green **Validation passed** message should show on the top of the screen), |
||||||
|
press the blue **Create** button. |
||||||
|
|
||||||
|
You should see a **Your deployment is underway** screen with all the resources creating. It takes |
||||||
|
some time, around 5mn, so be patient and have a nice :tea: or :coffee:. |
||||||
|
|
||||||
|
Once the deployment is done, you should see **Your deployment is complete** and a list of all the |
||||||
|
deployed resources with green check-marks. |
||||||
|
|
||||||
|
![Your deployment is complete screenshot](deployment-complete-screenshot.png) |
||||||
|
|
||||||
|
CLick on the resource named **quickstart** in this list and you'll land on the virtual |
||||||
|
machine overview page. |
||||||
|
|
||||||
|
## Accessing the Alethio EthStat-light explorer |
||||||
|
|
||||||
|
On the right part of the virtual machine page you can read the **Public IP address** of this machine. |
||||||
|
Copy it then open a new browser tab or window and past it in the navigation bar. |
||||||
|
|
||||||
|
You now should see the the EthStat-light explorer. |
||||||
|
Wait a few seconds and you should see 6 peers indicated and a few blocks mined. |
||||||
|
|
||||||
|
![Alethio EthStat-light explorer](alethio-light-explorer-screenshot.png) |
||||||
|
|
||||||
|
## Rpc enpoints |
||||||
|
|
||||||
|
For the following tutorial steps, you will have to know that your RPC endpoints are the |
||||||
|
following : |
||||||
|
|
||||||
|
* for the HTTP RPC endpoint: **http://<your VM public IP>/jsonrpc** |
||||||
|
* for the Web Socket RPC endpoint: **ws://<your VM public IP>/jsonws** |
||||||
|
|
||||||
|
You can now follow the quickstart tutorial starting from |
||||||
|
[the part where we show how to create RPC requests](../Private-Network-Quickstart.md#run-json-rpc-requests). |
||||||
|
|
||||||
|
## Shutting down the quickstart |
||||||
|
|
||||||
|
!!!attention |
||||||
|
Don't forget to shutdown the quickstart it you don't need it as it will consume your Azure resources |
||||||
|
and that can be expensive of at least drain your free credits from your free trial account. |
||||||
|
|
||||||
|
You have multiple ways to shutdown the quickstart depending on if you want to restart it |
||||||
|
from scratch after that or continue using the same installation. Here are the options: |
||||||
|
|
||||||
|
### I want to remove everything from my Azure account. |
||||||
|
|
||||||
|
This is the only way to be sure your Azure resources won't consume any credits. |
||||||
|
|
||||||
|
To do so, simply navigate in the Azure portal to your resource group, the one we named **pantheon-quickstart** |
||||||
|
then click on the **Delete resource group** button. |
||||||
|
|
||||||
|
### I want to remove the virtual machine only. |
||||||
|
Then simply navigate in the Azure portal to your resource group, the one we named **pantheon-quickstart** |
||||||
|
then click on the virtual machine resource and click the **Delete** button. |
||||||
|
|
||||||
|
### I want to keep the VM but remove the nodes network. |
||||||
|
Navigate to the VM in your Azure portal (click on **All services** in the left pane, then on |
||||||
|
**Virtual machines** and click on the one you named **quickstart**) and click the **connect** |
||||||
|
button that will give you the information to connect with SSH (see [Requirements](#requirements)). |
||||||
|
|
||||||
|
Once connected to the machine, navigate to the pantheon-quickstart directory: |
||||||
|
```bash |
||||||
|
cd pantheon-quickstart |
||||||
|
``` |
||||||
|
then run the remove script |
||||||
|
```bash |
||||||
|
./remove.sh |
||||||
|
``` |
||||||
|
|
||||||
|
If you want to run the network again, then you can use the following script: |
||||||
|
```bash |
||||||
|
./run.sh -p 80 |
||||||
|
``` |
||||||
|
|
||||||
|
Where 80 is the port number to use for Block Explorer and RPC connections. |
||||||
|
|
||||||
|
### I just want to stop the nodes network and be able to resume it. |
||||||
|
Connect to the VM using SSH like for "[I want to keep the VM but remove the nodes network.](#i-want-to-keep-the-vm-but-remove-the-nodes-network)" |
||||||
|
but instead of running the remove script, run the stop script. |
||||||
|
```bash |
||||||
|
./stop.sh |
||||||
|
``` |
||||||
|
you will be then able to resume the network with |
||||||
|
```bash |
||||||
|
./resume.sh |
||||||
|
``` |
After Width: | Height: | Size: 323 KiB |
After Width: | Height: | Size: 986 B |
After Width: | Height: | Size: 321 KiB |
Loading…
Reference in new issue