GoFabric Infrastructure Guide

Access GoInfra by clicking on the App Menu in the navigation bar and selecting the application.

Create an infrastructure

You will need to choose between two provider options:

  1. External: This option allows you to create your infrastructure on your own servers.
  2. AWS: This option allows you to create your infrastructure on your Amazon Web Services, by informing your Access Key and Secret Key.
  3. GCP: This option allows you to create your infrastructure on your Google Cloud Platform, by informing Service access JSON file.
  4. GoLedger: This option will use GoLedger as a provider, so you don't need to manage any infrastructure. (Coming soon)
  5. Kubernetes On-Premise: Set up infrastructure using a self-managed Kubernetes cluster by providing a kubeconfig file and cluster details.
  6. Kubernetes EKS: Set up infrastructure on AWS EKS by providing a kubeconfig file and EKS cluster configuration.

The Starter Organization tier allows External and GoLedger providers. The AWS provider is available on higher plans.

For Kubernetes infrastructure setup, see the dedicated Kubernetes Infrastructure Setup guide.

Creating an External infra provider

If you choose the External provider, you will need to inform the following information:

  1. Name: The name of your infrastructure

Then just click on the "Create Infra" button to create your infrastructure.

Creating External Infra

Now you can proceed to the next step, which is setting up your virtual machines (VMs).

To set up your VMs, you will need to inform the following information:

  1. SSH User: The user that will be used to connect to the VMs
  2. SSH Key: The SSH key that will be used to connect to the VMs
  3. IP Addresses: The IP addresses of the VMs that will be setup

Setting Up External VMs

During setup, you can see the progress of the VM configuration.

Creating an AWS infra provider

If you choose the AWS provider, you will need to inform the following information:

  1. Name: The name of your infrastructure
  2. Region: The AWS region where your infrastructure will be created
  3. Access Key: Your AWS Access Key
  4. Secret Key: Your AWS Secret Key
  5. Security Group Name: The name of the security group that will be created. This should not exist in your AWS account. GoInfra will the firewall rules for the blockchain resources.
  6. SSH Key Name: The name of the SSH key that will be created. This should not exist in your AWS account. GoInfra will create the SSH key to be used to connect to the VMs.

Then just click on the "Create Infra" button to create your infrastructure.

Creating AWS Infra

Now you can proceed to the next step, which is setting up your virtual machines (VMs).

To set up your VMs, you will need to inform the following information:

  1. Instance Type: The type of the VM that will be created
  2. SSH Key: The SSH key that will be used to connect to the VMs. This was created in the previous step.
  3. Instance name: The name of the VM that will be created
  4. Instance image: The image of the VM that will be created. Currently, only Ubuntu 20 is supported.
  5. Instance count: The number of VMs that will be created
  6. Storage size: The size of the storage that will be created
  7. Security Group Name: The name of the security group that will be used. This was created in the previous step.

Creating AWS VMs

During setup, you can see the progress of the VM configuration.

VM Success

You can also see the details of the VMs that were created on your AWS account.

After setting up your VMs, you can proceed to the next step, which is setting up your first organization.

Creating a GCP infra provider

If you choose the GCP provider, you will need to fill in the following information:

Infra Details

  1. Name (required): The name of your infrastructure.
  2. Zone (required): The GCP zone where your infrastructure will be created. Select from the available zones in the dropdown.
  3. Json File GCP (required): Upload the GCP service account JSON key file. This file provides the credentials GoInfra needs to provision resources on your Google Cloud project.

VPC Network

  1. VPC Network Name (required): The name of the VPC network that will be created for your infrastructure.
  2. VPC Network Description (required): A description for the VPC network.

Create Private Key

  1. Key Name (required): The name of the SSH private key that will be created. This key is used to securely access your instances.
  2. Key Description (required): A description for the private key.

Then click on the Create Infra button to create your infrastructure.

After creating the infrastructure, the VM setup process is analogous to the AWS provider.

Creating an Azure infra provider

If you choose the Azure provider, you will need to fill in the following information:

Infra Details

  1. Name (required): The name of your infrastructure.
  2. Resource Group (required): The name of an existing Azure Resource Group where the infrastructure will be created. Make sure it exists in the selected location.
  3. Location (required): The Azure region where your infrastructure will be deployed. The selected location must match the region of your Resource Group.
  4. Client Secret (required): The client secret of the Azure Active Directory application used for authentication.
  5. Client ID (required): The application (client) ID of the Azure Active Directory app registration.
  6. Tenant ID (required): The directory (tenant) ID of your Azure Active Directory.
  7. Subscription ID (required): The ID of the Azure subscription where resources will be provisioned.

Virtual Network

  1. Virtual Network Name (required): The name of the Virtual Network (VNet) that will be created for your infrastructure.
  2. Virtual Network Description (required): A description for the Virtual Network.

Create Private Key

  1. Key Name (required): The name of the SSH private key that will be created. This key is used to securely access your instances.
  2. Key Description (required): A description for the private key.

Then click on the Create Infra button to create your infrastructure.

After creating the infrastructure, the VM setup process is analogous to the AWS provider.

Creating a GoLedger infra provider

Coming soon: GoLedger-managed infrastructure is not yet available. Check back later for updates.

Next Steps

With your infrastructure and VMs set up, you are ready to create your organization: