mirror of
https://github.com/corda/corda.git
synced 2024-12-19 13:08:04 +00:00
017ffab60b
* added doc page for running Corda on GCP vis Explore * Fix bash code examples * add images * add images * more typos fixed * typo * fix firewall commands * more screenshots * add screenshots for new projewct * scale images * screenshot * added screenshot * Bold steps * more screenshots * added screenshots * upload screenshots * added screenshots * add contents * add azure file * add azure file * updated azure screenshots * updated azure screenshots * more screenshots and text * Updated run commands * Updated run commands * Update azure-vm-explore.rst * Fix urls * add AWS setup for explore * aws screenshots * update test for AWS * aws screenshots * aws screenshots * add screenshots * AWS updates * AWS * aws screenshot * aws screenshots * aws images * aws updates * aws updates * aws screenshot * Updated intro to new branding * Added resoure group docs to azure page * Updated azure screenshots * Updated azure screenshots * Updated azure screenshots * Updated azure screenshots * Updated aws docs * Updated GCP docs * Updated GCP docs * Adding a Testnet overview page * Adding a Testnet overview page * Adding a Testnet overview page * Adding a Testnet overview page * Adding a Testnet overview page * Adding a Testnet overview page * Adding elastic IP to AWS * Adding elastic IP to AWS * Adding elastic IP to AWS * updated dl link * Update aws-vm-explore.rst * update dl link * Update gcp-vm.rst * Fixing changes requested by RGB. * Fixed link * Additional changes requested in review. * Updated based on RGB review comments. * Minor formatting * minor formatting * Address review comments * Address the review comments from RGB * typo * typo * typo * typo * make underlines same length as headers * Fix review comments * Fix review comments * fix review comments * adding to index
121 lines
3.8 KiB
ReStructuredText
121 lines
3.8 KiB
ReStructuredText
Deploying Corda to Corda Testnet from a Google Cloud Platform VM
|
|
================================================================
|
|
|
|
.. contents::
|
|
|
|
This document explains how to deploy a Corda node to Google Cloud Platform that can connect directly to the Corda Testnet. A self service download link can be obtained from https://testnet.corda.network. This document will describe how to set up a virtual machine on the Google Cloud Platform (GCP) to deploy your pre-configured Corda node and automatically connnect to Testnet.
|
|
|
|
Pre-requisites
|
|
--------------
|
|
* Ensure you have a registered Google Cloud Platform account with
|
|
billing enabled (https://cloud.google.com/billing/docs/how-to/manage-billing-account) which can create virtual machines under your subscription(s) and you are logged on to the GCP console: https://console.cloud.google.com.
|
|
|
|
|
|
Deploy Corda node
|
|
-----------------
|
|
|
|
Browse to https://console.cloud.google.com and log in with your
|
|
Google credentials.
|
|
|
|
**STEP 1: Create a GCP Project**
|
|
|
|
In the project drop down click on the plus icon to create a new
|
|
project to house your Corda resources.
|
|
|
|
.. image:: resources/consolegcp.png
|
|
|
|
.. image:: resources/console2.png
|
|
|
|
.. image:: resources/newprojectgcp.png
|
|
|
|
Enter a project name and click Create.
|
|
|
|
**STEP 2: Launch the VM**
|
|
|
|
In the left hand side nav click on Compute Engine.
|
|
|
|
.. image:: resources/gcpcompute.png
|
|
|
|
Click on Create Instance.
|
|
|
|
.. image:: resources/consolegcpcreatevm.png
|
|
|
|
Fill in the form with the desired VM specs:
|
|
|
|
Recommended minimum 4vCPU with 15GB memory and 40GB Persistent disk.
|
|
Ubuntu 16.04 LTS.
|
|
|
|
Allow full API access.
|
|
|
|
Dont worry about firewall settings as you will configure those later.
|
|
|
|
.. image:: resources/gcpconsolevmsettings.png
|
|
|
|
Click Create and wait a few sections for your instance to provision
|
|
and start running.
|
|
|
|
**STEP 3: Connect to your VM and set up the environment**
|
|
|
|
Once your instance is running click on the SSH button to launch a
|
|
cloud SSH terminal in a new window.
|
|
|
|
.. image:: resources/gcpconsolelaunchssh.png
|
|
|
|
.. image:: resources/gcpshell.png
|
|
|
|
Run the following to configure the firewall to allow Corda traffic
|
|
|
|
.. code:: bash
|
|
|
|
gcloud compute firewall-rules create nodetonode --allow tcp:10002
|
|
gcloud compute firewall-rules create nodetorpc --allow tcp:10003
|
|
gcloud compute firewall-rules create webserver --allow tcp:8080
|
|
|
|
|
|
Promote the ephemeral IP address associated with this
|
|
instance to a static IP address.
|
|
|
|
First check the region and select the one you are using from the list:
|
|
|
|
.. code:: bash
|
|
|
|
gcloud compute regions list
|
|
|
|
Find your external IP:
|
|
|
|
.. code:: bash
|
|
|
|
gcloud compute addresses list
|
|
|
|
Run this command with the ephemeral IP address as the argument to
|
|
the --addresses flag and the region:
|
|
|
|
.. code:: bash
|
|
|
|
gcloud compute addresses create corda-node --addresses 35.204.53.61 --region europe-west4
|
|
|
|
**STEP 4: Download and set up your Corda node**
|
|
|
|
Now your GCP environment is configured you can switch to the Testnet
|
|
web application and click on the copy to clipboard button to get a one
|
|
time installation script.
|
|
|
|
.. note:: If you have not already set up your account on Testnet then please visit https://testnet.corda.network and sign up.
|
|
|
|
.. image:: resources/testnet-platform.png
|
|
|
|
You can generate as many Testnet identites as you like by refreshing
|
|
this page to generate a new one time link.
|
|
|
|
In the terminal of your cloud instance paste the command you just copied to install and run
|
|
your unique Corda instance:
|
|
|
|
.. code:: bash
|
|
|
|
sudo ONE_TIME_DOWNLOAD_KEY=YOUR_UNIQUE_DOWNLOAD_KEY_HERE bash -c "$(curl -L https://testnet.corda.network/api/user/node/install.sh)"
|
|
|
|
.. warning:: This command will execute the install script as ROOT on your cloud instance. You may wish to examine the script prior to executing it on your machine.
|
|
|
|
You can now navigate to the external web address of the instance and
|
|
see any cordapps running on port 8080 (if you have any installed).
|