DLT Blockchain Network deployment using own Machine¶
Pre-requisites¶
To create a Production DLT/Blockchain network, ensure you have the following:
- One running Kubernetes Cluster and the Config file (default ~/.kube.config) per Organization.
- One running Hashicorp Vault server per Organization. Unsealed and configured as per guidance here.
- Domain Name(s) configured as per tutorial here.
- Git user details per Organization as per pre-requisites.
- Ansible controller configured as per guidance here.
- If using SSH for Git, Private key file per Organization for GitOps with write-access to the Git repo as per guidance here.
Important
All commands are executed from the bevel
directory which is the default directory created when you clone our Git repo.
Prepare build folder¶
If not already done, clone the git repository on your Ansible controller.
Create a folder calledbuild
inside bevel
.
Copy the following files into the build
folder:
- All the Kubernetes config files (config, kubeconfig.yaml).
- All the private key files (if using SSH for git).
Edit the configuration file¶
Depending on your choice of DLT/Blockchain Platform, select a network.yaml and copy it to build
folder.
# eg for Fabric
cp platforms/hyperledger-fabric/configuration/samples/network-fabricv2.yaml build/network.yaml
network.yaml
according to the following Platform specific guides.
In summary, you will need to update the following:
docker
url, username and password.external_url_suffix
depending on your Domain Name(s).- All DNS addresses depending on your Domain Name(s).
cloud_provider
k8s
section depending on your Kubernetes zone/cluster name/config filepath.vault
gitops
section depending on your git username, tokens and private key filepath.
Execute provisioning script¶
After all the configurations are updated in the network.yaml
, execute the following to create the DLT network
# Run the provisioning scripts
ansible-playbook platforms/shared/configuration/site.yaml -e "@./build/network.yaml"
site.yaml
playbook, in turn calls various playbooks depending on the configuration file and sets up your DLT/Blockchain network.
Verify successful configuration¶
For instructions on how to troubleshoot network, read our troubleshooting guide
Deleting an existing network¶
The above mentioned playbook site.yaml (ReadMe) can be run to reset the network using the network configuration file having the specifications which was used to setup the network using the following command: