From d5efd51bce4f48d3fa5129f5df1c250da12b0d29 Mon Sep 17 00:00:00 2001 From: "sownak.roy" Date: Wed, 3 Jul 2024 15:19:11 +0100 Subject: [PATCH] [docs] Updated for latest release Signed-off-by: sownak.roy --- docs/mkdocs.yml | 6 +-- docs/source/concepts/ansible.md | 6 ++- docs/source/concepts/features.md | 10 +++- docs/source/concepts/gitops.md | 4 ++ docs/source/concepts/sequence-diagram.md | 4 +- docs/source/concepts/vault.md | 4 ++ .../configure-prerequisites.md | 10 ++-- .../getting-started/prerequisites-machine.md | 2 +- docs/source/getting-started/prerequisites.md | 42 +++++++++------ docs/source/getting-started/run-bevel.md | 25 ++++++--- docs/source/guides/networkyaml-corda.md | 2 +- docs/source/guides/networkyaml-fabric.md | 2 +- docs/source/guides/networkyaml-indy.md | 2 +- docs/source/index.md | 18 +++---- docs/source/tutorials/index.md | 53 +++++++++++++++---- docs/source/tutorials/machine-deploy.md | 2 +- 16 files changed, 132 insertions(+), 60 deletions(-) diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index e2054b0c709..7c498c06490 100644 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -92,10 +92,10 @@ nav: - Concepts: - Sequence Diagram: concepts/sequence-diagram.md - Features: concepts/features.md - - Ansible: concepts/ansible.md - - Gitops: concepts/gitops.md - Helm: concepts/helm.md - Kubernetes: concepts/kubernetes.md + - Ansible: concepts/ansible.md + - Gitops: concepts/gitops.md - Vault: concepts/vault.md - Getting Started: - Pre-requisites: getting-started/prerequisites.md @@ -103,7 +103,7 @@ nav: - Configure pre-requisites: getting-started/configure-prerequisites.md - Running: getting-started/run-bevel.md - Tutorials: - - Tutorial List: tutorials/index.md + - Tutorials: tutorials/index.md - Developer pre-requisites: tutorials/dev-prereq.md - Deploy using Docker: tutorials/docker-deploy.md - Deploy using Machine: tutorials/machine-deploy.md diff --git a/docs/source/concepts/ansible.md b/docs/source/concepts/ansible.md index 6d7bc5e8e85..9cfa42c3fdb 100644 --- a/docs/source/concepts/ansible.md +++ b/docs/source/concepts/ansible.md @@ -3,10 +3,14 @@ [//]: # (SPDX-License-Identifier: Apache-2.0) [//]: # (##############################################################################################) -# **Ansible** +# Ansible [Ansible](https://docs.ansible.com/ansible/latest/index.html) is an open-source automation tool that simplifies the process of managing IT infrastructure and automating repetitive tasks. It is designed to make complex configuration and deployment processes easier, faster, and more consistent. Ansible is agentless, meaning it doesn't require any software to be installed on the managed hosts, making it lightweight and easy to set up. +!!! tip + + With 1.1 Release, Ansible is optional and can be used only for large deployment automation. + With Ansible, you can define your infrastructure as code using simple, human-readable YAML files called "playbooks." Playbooks describe the desired state of your systems, specifying which tasks should be performed and in what order. These tasks can range from simple tasks like copying files or installing packages to more complex tasks like configuring services or managing cloud resources. Here's how Ansible works in a nutshell: diff --git a/docs/source/concepts/features.md b/docs/source/concepts/features.md index b7fee17cf36..7d2bd45297b 100644 --- a/docs/source/concepts/features.md +++ b/docs/source/concepts/features.md @@ -19,14 +19,20 @@ The setup of a Distributed Ledger Technology (DLT) network doesn't hinge on mana ## One touch/command deployment With just one Ansible playbook — aptly named [site.yaml](https://github.com/hyperledger/bevel/tree/main/platforms/shared/configuration/site.yaml), you can orchestrate the creation of an entire Distributed Ledger Technology (DLT) network. Brace yourself for efficiency gains as this streamlined process significantly slashes the time typically spent configuring and managing the network components of Corda, Besu, Fabric or other supported DLT networks. -## Security through Vault -In the realm of identity-based security, HashiCorp Vault takes centre stage within Hyperledger Bevel. Especially in the complex terrain of managing secrets across multiple clouds, the dynamic capabilities of HashiCorp Vault shine through. With Vault at its core, Hyperledger Bevel ensures the secure storage and precise control of access to critical elements like tokens, passwords, certificates, and encryption keys. This robust approach safeguards machines, applications, and sensitive data within a multi-cloud environment. +## Security through Vault (Optional) +In the realm of identity-based security, HashiCorp Vault takes centre stage within Hyperledger Bevel. Especially in the complex terrain of managing secrets across multiple clouds, the dynamic capabilities of HashiCorp Vault shine through. With Vault at its core, Hyperledger Bevel ensures the secure storage and precise control of access to critical elements like tokens, passwords, certificates, and encryption keys. This robust approach safeguards machines, applications, and sensitive data within a multi-cloud environment. Now **optional** for development environments. ## Sharing a Network.yaml file without disclosing any confidentiality Unlocking a new level of efficiency, Hyperledger Bevel empowers organizations to initiate a Distributed Ledger Technology (DLT) or Blockchain network swiftly. Leveraging a configured [network.yaml](../guides/networkyaml-fabric.md) file, the setup process is not only streamlined but sets the stage for seamless collaboration. Here's the game-changer: this [network.yaml](../guides/networkyaml-fabric.md) file can be easily shared with new organizations looking to join the DLT/Blockchain network. The brilliance lies in the ability to reuse this file without compromising the confidentiality of the initial organization's sensitive data. +## Helm Chart Support +Simplifies deployment of DLT networks with Helm charts. Specially for development environments, only `helm install` commands can be used to setup a DLT network in few minutes. + +## GitOps Optionality +Provides flexibility by making GitOps deployment optional for development environments. This gives the developers a faster access to the DLT environment without the complexities of configuring GitOps. + ## How is it different from other BaaS? - Hyperledger Bevel deployment scripts can be reused across cloud providers like AWS, Azure, GCP, DigitalOcean and OpenShift - Can deploy networks and smart contracts across different DLT/Blockchain platforms diff --git a/docs/source/concepts/gitops.md b/docs/source/concepts/gitops.md index 0f25f57db58..562f1a663ac 100644 --- a/docs/source/concepts/gitops.md +++ b/docs/source/concepts/gitops.md @@ -7,6 +7,10 @@ [GitOps](https://www.weave.works/technologies/gitops/) is a modern approach to managing and deploying applications in Kubernetes clusters. It leverages the version control system Git as the source of truth for defining the desired state of your infrastructure and applications. Flux is a popular tool used to implement GitOps workflows, enabling automatic synchronization of changes from Git repositories to Kubernetes clusters. +!!! tip + + With 1.1 Release, GitOps is optional for small development environments. + ## Features 1. Source of Truth: In GitOps, the Git repository serves as the single source of truth for your infrastructure and application configurations. All desired states are declared and versioned in Git. diff --git a/docs/source/concepts/sequence-diagram.md b/docs/source/concepts/sequence-diagram.md index 989fa885a39..5301649a122 100644 --- a/docs/source/concepts/sequence-diagram.md +++ b/docs/source/concepts/sequence-diagram.md @@ -1,10 +1,10 @@ # Bevel Sequence Diagram -It is important to understand the sequence and flow for Bevel as this will determine how you confgure your networking. +When using Ansible automation in Bevel, it is important to understand the sequence and flow as this will determine how you confgure your networking. !!! tip - Do not use 127.0.0.1 or localhost to configure any services like Kubernetes or Vault + Do not use 127.0.0.1 or localhost to configure any services like Kubernetes or Vault. ``` mermaid sequenceDiagram diff --git a/docs/source/concepts/vault.md b/docs/source/concepts/vault.md index 965b468ada2..16d0cc39bf4 100644 --- a/docs/source/concepts/vault.md +++ b/docs/source/concepts/vault.md @@ -7,6 +7,10 @@ [HashiCorp Vault](https://www.vaultproject.io/) is an open-source tool designed to manage secrets and protect sensitive data in modern computing environments. It provides a secure and centralized way to store, access, and distribute secrets such as passwords, API keys, encryption keys, and other confidential information. Vault is especially useful in cloud-native and distributed systems where securing secrets is crucial. +!!! tip + + With 1.1 Release, Hahsicorp Vault is optional for development environments, and Cloud KMS integration is on the roadmap. + Hyperledger Bevel relies on Hashicorp Vault for managing all secrets like public and private certificates, passwords to repos or databases etc. which are used in a DLT/Blockchain network during the lifecycle of a deployment, and it is a prerequisite that the Vault is installed and unsealed prior to deployment of a DLT/Blockchain network. ## Core Features diff --git a/docs/source/getting-started/configure-prerequisites.md b/docs/source/getting-started/configure-prerequisites.md index 9068e48f6e4..939fb539fbe 100644 --- a/docs/source/getting-started/configure-prerequisites.md +++ b/docs/source/getting-started/configure-prerequisites.md @@ -6,10 +6,9 @@ # Configure Common Pre-requisites - [GitOps Authentication](#gitops-authentication) -- [Vault Initialization and unseal](#vaultunseal) -- [Docker Images](#docker) +- [Unseal Hashicorp Vault](#unseal-hashicorp-vault) +- [Docker Images](#docker-images) - ## GitOps Authentication For synchronizing the Git repo with the cluster, Hyperledger Bevel configures Flux for each cluster. The authentication can be via SSH or HTTPS. @@ -34,7 +33,6 @@ The above command generates an SSH key-pair: **gitops** (private key) and **gito And add the public key contents (starts with **ssh-rsa**) as an Access Key (with read-write permissions) in your Github repository by following [this guide](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account). - ## Unseal Hashicorp Vault The [Hashicorp Vault](../concepts/vault.md) must be initialised and unsealed. Complete the following steps to unseal and access the Vault. @@ -43,7 +41,7 @@ The [Hashicorp Vault](../concepts/vault.md) must be initialised and unsealed. Co !!! important - Vault version should be > **1.13.1** + Vault version should be > **1.13.1** and <= **1.15.2** * Set the environment Variable **VAULT_ADDR** as the Vault service. @@ -83,8 +81,6 @@ The [Hashicorp Vault](../concepts/vault.md) must be initialised and unsealed. Co It is recommended to use Vault auto-unseal using Cloud KMS for Production Systems. And also, rotate the root token regularly. - - ## Docker Images Hyperledger Bevel provides pre-built docker images which are available on [GitHub Repo](https://github.com/orgs/hyperledger/packages?repo_name=bevel). Ensure that the versions/tags you need are available. If not, [ask a question](../contributing/asking-a-question.md). diff --git a/docs/source/getting-started/prerequisites-machine.md b/docs/source/getting-started/prerequisites-machine.md index a1d9a384f84..e27e05040f1 100644 --- a/docs/source/getting-started/prerequisites-machine.md +++ b/docs/source/getting-started/prerequisites-machine.md @@ -11,7 +11,7 @@ ## Ansible -Hyperledger Bevel configuration is essentially Ansible scripts, so install Ansible on the machine from which you will deploy the DLT/Blockchain network. This can be a local machine as long as Ansible commands can run on it. +Hyperledger Bevel automation is essentially Ansible scripts, so install Ansible on the machine from which you will deploy the DLT/Blockchain network. This can be a local machine as long as Ansible commands can run on it. As per our [sequence diagram](../concepts/sequence-diagram.md), this machine (also called **Ansible Controller**) should have connectivity to the Kubernetes cluster(s) and the Hashicorp Vault service(s). And it is essential to install the [git client](https://git-scm.com/download) on the Ansible Controller. diff --git a/docs/source/getting-started/prerequisites.md b/docs/source/getting-started/prerequisites.md index 8ca46ee70e9..8e0b04e4e92 100644 --- a/docs/source/getting-started/prerequisites.md +++ b/docs/source/getting-started/prerequisites.md @@ -7,53 +7,65 @@ Following are the common prerequisite software/client/platforms etc. needed before you can start deploying/operating blockchain networks using Hyperledger Bevel. -## Git Repository -[GitOps](../concepts/gitops.md) is a key concept for Hyperledger Bevel, so a Git repository is needed for Bevel (this can be a [GitHub](https://github.com/) repository as well). -Fork or import the [Bevel GitHub repo](https://github.com/hyperledger/bevel) to this Git repository. +## Helm -The Operator should have a user created on this repo with read-write access to the Git Repository. +[Helm](../concepts/helm.md) is a crucial tool for managing Kubernetes applications, simplifying the deployment and management of Kubernetes manifests. For Hyperledger Bevel, Helm charts are used to streamline the deployment of DLT networks, ensuring consistency and efficiency. -!!! tip +To install Helm, follow the official [Helm installation guide](https://helm.sh/docs/intro/install/). Ensure the version is compatible with your Kubernetes setup. - Install Git Client Version > **2.31.0** +!!! tip + Install Helm Version > **v3.6.2** ## Kubernetes Hyperledger Bevel deploys the DLT/Blockchain network on [Kubernetes](https://kubernetes.io/) clusters; hence, at least one Kubernetes cluster should be available. -Bevel recommends one Kubernetes cluster per organization for production-ready projects. -Also, a user needs to make sure that the Kubernetes clusters can support the number of pods and persistent volumes that will be created by Bevel. + +Bevel recommends one Kubernetes cluster per organization for production-ready projects. Also, a user needs to make sure that the Kubernetes clusters can support the number of pods and persistent volumes that will be created by Bevel. !!! tip - For the current release Bevel has been tested on Amazon EKS with Kubernetes version **1.23**. + For the current release Bevel has been tested on Amazon EKS with Kubernetes version **1.28**. - Bevel has been tested on Kubernetes >= 1.19 and <= 1.23 + Bevel has been tested on Kubernetes >= 1.19 and <= 1.28 !!! warning Icon Filename - Also, install kubectl Client version as per Kubernetes version **v1.23.0** + Also, install kubectl Client version as per Kubernetes version **v1.28.0** -Please follow respective Cloud provider instructions, like [ for Amazon](https://aws.amazon.com/eks/getting-started/) to set-up your required Kubernetes cluster(s). +Please follow respective Cloud provider instructions, like [for Amazon](https://aws.amazon.com/eks/getting-started/) to set-up your required Kubernetes cluster(s). To connect to Kubernetes cluster(s), you will also need kubectl Command Line Interface (CLI). Refer [here](https://kubernetes.io/docs/tasks/tools/install-kubectl/) for installation instructions, although Hyperledger Bevel configuration code (Ansible scripts) installs this automatically. +## Git Repository + +Release 1.1 onwards, [GitOps](../concepts/gitops.md) is a optional concept for Hyperledger Bevel. Although, for Production-ready deployment with Ansible automation, GitOps is needed for Bevel. + +Fork or import the [Bevel GitHub repo](https://github.com/hyperledger/bevel) to your own Git repository. The Operator should have a user created on this repo with read-write access to the Git Repository. + +!!! tip + + Install Git Client Version > **2.31.0** + ## HashiCorp Vault -In this current release, [Hashicorp Vault](https://www.vaultproject.io/) is mandatory for Hyperledger Bevel as the certificate and key storage solution; hence, at least one Vault server should be available. Bevel recommends one Vault per organization for production-ready projects. + +Release 1.1 onwards, [Hashicorp Vault](https://www.vaultproject.io/) is optional for Hyperledger Bevel as the certificate and key storage solution. But, for Production-ready deployment with Ansible automation, at least one Vault server should be available. Bevel recommends one Vault per organization for production-ready projects. Follow [official instructions](https://developer.hashicorp.com/vault/docs/install) to deploy Vault in your environment. !!! tip + The recommended approach is to create one Vault deployment on one VM and configure the backend as cloud storage. !!! warning - Vault version should be **1.13.1** + Vault version should be <= **1.15.2** ## Internet Domain + Hyperledger Bevel uses [Ambassador Edge Stack](https://www.getambassador.io/products/edge-stack/api-gateway) or [HAProxy Ingress Controller](https://haproxy-ingress.github.io/) for inter-cluster communication. So, for the Kubernetes services to be available outside the specific cluster, at least one DNS Domain is required. This domain name can then be sub-divided across multiple clusters and the domain-resolution configured for each. Although for production implementations, each organization (and thereby each cluster), must have one domain name. -!!! tip +!!! note If single cluster is being used for all organizations in a dev/POC environment, then domain name is not needed. diff --git a/docs/source/getting-started/run-bevel.md b/docs/source/getting-started/run-bevel.md index 1f96d735a5c..4c07fb89cee 100644 --- a/docs/source/getting-started/run-bevel.md +++ b/docs/source/getting-started/run-bevel.md @@ -4,19 +4,32 @@ [//]: # (##############################################################################################) # Run Bevel -Once your [pre-requisites](./prerequisites.md) are [configured](./configure-prerequisites.md), it's time to take the next step. Fork the [Hyperledger Bevel GitHub](https://github.com/hyperledger/bevel) repository and unlock the potential of this powerful tool for your Distributed Ledger Technology (DLT) deployment. +Once your [pre-requisites](./prerequisites.md) are [configured](./configure-prerequisites.md), it's time to take the next step. -Now, let's explore two user-friendly methods for using Hyperledger Bevel: +There are three user-friendly methods for using Hyperledger Bevel: -- [Using the **bevel-build** Docker container as Ansible controller.](#bevel-build) -- [Using your own machine as Ansible controller.](#own-machine) +- [Using Helm Charts](#using-helm-charts) +- [Using the **bevel-build** Docker container as Ansible controller.](#using-docker-container) +- [Using your own machine as Ansible controller.](#using-own-machine) + +## Using Helm Charts + +Release 1.1 onwards, Bevel can be used without Ansible automation. If you want to create a small development network, using the Helm charts will be simpler and faster. For production-ready networks or complex networks with multiple organisations, the below two options are recommended. + +Follow the respective Helm chart documentation to setup your network: + +* [R3 Corda Opensource Charts](https://github.com/hyperledger/bevel/tree/main/platforms/r3-corda/charts) +* [R3 Corda Enterprise Charts](https://github.com/hyperledger/bevel/tree/main/platforms/r3-corda-ent/charts) +* [Hyperledger Fabric Charts](https://github.com/hyperledger/bevel/tree/main/platforms/hyperledger-fabric/charts) +* [Hyperledger Indy Charts](https://github.com/hyperledger/bevel/tree/main/platforms/hyperledger-indy/charts) +* [Quorum Charts](https://github.com/hyperledger/bevel/tree/main/platforms/quorum/charts) +* [Hyperledger Besu Charts](https://github.com/hyperledger/bevel/tree/main/platforms/hyperledger-besu/charts) +* [Substrate Charts](https://github.com/hyperledger/bevel/tree/main/platforms/substrate/charts) - ## Using Docker container Follow [this tutorial](../tutorials/docker-deploy.md) for how to deploy from the docker container. - ## Using Own machine Using own machine as Ansible Controller needs these [additional pre-requisites](./prerequisites-machine.md). diff --git a/docs/source/guides/networkyaml-corda.md b/docs/source/guides/networkyaml-corda.md index d82a36bf796..313c750cecb 100644 --- a/docs/source/guides/networkyaml-corda.md +++ b/docs/source/guides/networkyaml-corda.md @@ -88,7 +88,7 @@ The fields under `docker` section are | password | Password or Access token required for login | !!! note - Please follow [these instructions](../getting-started/configure-prerequisites.md#docker) to build and store the docker images before running the Ansible playbooks. + Please follow [these instructions](../getting-started/configure-prerequisites.md#docker-images) to build and store the docker images before running the Ansible playbooks. network_services diff --git a/docs/source/guides/networkyaml-fabric.md b/docs/source/guides/networkyaml-fabric.md index 77ebe8d1237..7587ce4d6a0 100644 --- a/docs/source/guides/networkyaml-fabric.md +++ b/docs/source/guides/networkyaml-fabric.md @@ -96,7 +96,7 @@ The fields under `docker` section are !!! tip - Please follow [these instructions](../getting-started/configure-prerequisites.md#docker) to build and store the docker images before running the Ansible playbooks. + Please follow [these instructions](../getting-started/configure-prerequisites.md#docker-images) to build and store the docker images before running the Ansible playbooks. consensus diff --git a/docs/source/guides/networkyaml-indy.md b/docs/source/guides/networkyaml-indy.md index 0c407f0e7d7..0d55aa15f52 100644 --- a/docs/source/guides/networkyaml-indy.md +++ b/docs/source/guides/networkyaml-indy.md @@ -82,7 +82,7 @@ The fields under `docker` section are !!! tip - Please follow [these instructions](../getting-started/configure-prerequisites.md#docker) to build and store the docker images before running the Ansible playbooks. + Please follow [these instructions](../getting-started/configure-prerequisites.md#docker-images) to build and store the docker images before running the Ansible playbooks. name diff --git a/docs/source/index.md b/docs/source/index.md index 6e489321c74..06fbe61269d 100644 --- a/docs/source/index.md +++ b/docs/source/index.md @@ -1,27 +1,27 @@ # Introduction -Hyperledger Bevel is an advanced automation framework tailored for the seamless deployment of robust, production-ready Distributed Ledger Technology (DLT) networks on cloud-based infrastructures. Eliminating the need for intricate solution architecture, Bevel empowers teams to deliver with precision. +Hyperledger Bevel is a sophisticated automation framework designed for the deployment of production-ready Distributed Ledger Technology (DLT) networks across cloud infrastructures. By eliminating the need for complex solution architecture, Bevel empowers teams to deliver with precision and efficiency. ![](./_static/bevel-overview.png) ## Key Features - * Security Excellence: Bevel establishes a secure foundation for DLT development, implementing best practices in key management and providing essential security features by default. - * Scalability at Its Core: Bevel's network implementation is designed for seamless scalability, allowing users to effortlessly expand their environment and resources according to project requirements. - * Accelerated Deployment: Bevel expedites blockchain solution deployment, offering an opportunity for active participation and the acceleration of additional services. + - **Helm Charts**: Simplifies the deployment of complex DLT networks. + - **Security**: Implements best practices in key management. + - **Scalability**: Designed for seamless expansion. + - **Accelerated Deployment**: Expedites the creation of complex DLT environments. + - **Developer Flexibility**: Option to deploy without Hahsicorp Vault and Flux for streamlined development. -Hyperledger Bevel serves as a pivotal accelerator, enabling developers to efficiently create a DLT environment. With Bevel, users not only expedite the creation of a DLT network but also ensure its suitability for continuous utilization throughout the project lifecycle. +## Supported DLT Platforms -## Which platforms does Bevel Support? - -Bevel currently supports the following DLT/Blockchain Platforms: +Hyperledger Bevel currently supports the following DLT/Blockchain Platforms: * [R3 Corda](https://docs.corda.net/) * [Hyperledger Fabric](https://hyperledger-fabric.readthedocs.io) * [Hyperledger Indy](https://hyperledger-indy.readthedocs.io/en/latest/) * [Hyperledger Besu]( https://besu.hyperledger.org/en/stable/) * [Quorum]( https://www.goquorum.com/) - * [Substrate](https://www.parity.io/technologies/substrate/). + * [Substrate](https://www.parity.io/technologies/substrate/) Get started with the [pre-requisites](./getting-started/prerequisites.md) to rapidly deploy blockchain networks. diff --git a/docs/source/tutorials/index.md b/docs/source/tutorials/index.md index b916ba76b0d..d517bee3967 100644 --- a/docs/source/tutorials/index.md +++ b/docs/source/tutorials/index.md @@ -1,12 +1,45 @@ # Tutorials -These are the developer and operator tutorials: - -| Tutorial | Description | -| :-------------------------- | :---------------------------------- | -| [Developer pre-requisites](dev-prereq.md)| How to set up Developer pre-requisites| -| [Deploy using Docker](docker-deploy.md) | How to use Bevel from a docker container which has all pre-requisites installed. | -| [Deploy using Machine](machine-deploy.md) | How to use Bevel from your own machine. | -| [Update DNS](dns-settings.md) | How to configure DNS for use with Bevel. | -| [Use Bevel with minikube](bevel-minikube-setup.md)| How to deploy any network on minikube| -| [Add a new StorageClass](adding-new-storageclass.md)| How to add a new StorageClass for a new Cloud Provider| +Here are few developer and operator tutorials: + +
+ +- :fontawesome-solid-laptop-code:{ .lg .middle } __[Developer pre-requisites](dev-prereq.md)__ + + --- + + Learn how to set up Developer pre-requisites. + +- :fontawesome-solid-box:{ .lg .middle } __[Deploy using Docker](docker-deploy.md)__ + + --- + + Learn how to use Bevel from a docker container which has all pre-requisites installed. + +- :fontawesome-solid-laptop:{ .lg .middle } __[Deploy using Machine](machine-deploy.md)__ + + --- + + Learn how to use Bevel from your own machine. + +- :material-dns-outline:{ .lg .middle } __[Update DNS](dns-settings.md)__ + + --- + + Learn how to configure DNS for use with Bevel. + +- :material-school:{ .lg .middle } __[Use Bevel with minikube](bevel-minikube-setup.md)__ + + --- + + Learn how to deploy any network on minikube. + +- :fontawesome-regular-hard-drive:{ .lg .middle } __[Add a new StorageClass](adding-new-storageclass.md)__ + + --- + + Learn how to add a new StorageClass for a new Cloud Provider. + + + +
diff --git a/docs/source/tutorials/machine-deploy.md b/docs/source/tutorials/machine-deploy.md index d8de332fcb9..f912d8a4389 100644 --- a/docs/source/tutorials/machine-deploy.md +++ b/docs/source/tutorials/machine-deploy.md @@ -8,7 +8,7 @@ To create a Production DLT/Blockchain network, ensure you have the following: 1. One running Kubernetes Cluster and the Config file (default ~/.kube.config) per Organization. -1. One running Hashicorp Vault server per Organization. Unsealed and configured as per [guidance here](../getting-started/configure-prerequisites.md#vaultunseal). +1. One running Hashicorp Vault server per Organization. Unsealed and configured as per [guidance here](../getting-started/configure-prerequisites.md#unseal-hashicorp-vault). 1. Domain Name(s) configured as per [tutorial here](../tutorials/dns-settings.md). 1. Git user details per Organization as per [pre-requisites](../getting-started/configure-prerequisites.md#gitops-authentication). 1. Ansible controller configured as per [guidance here](../getting-started/prerequisites-machine.md).