Skip to content

Commit

Permalink
update links and text description (#1029)
Browse files Browse the repository at this point in the history
fixes #1027

Signed-off-by: Nicolas MASSART <nicolas.massart@consensys.net>
  • Loading branch information
NicolasMassart committed May 2, 2022
1 parent 1e00a2d commit 54bb372
Show file tree
Hide file tree
Showing 4 changed files with 22 additions and 25 deletions.
12 changes: 6 additions & 6 deletions docs/Tutorials/Kubernetes/Deploy-Charts.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,12 +13,12 @@ description: Deploying Besu Helm Charts for a Kubernetes cluster
## Provision with Helm charts

Helm allows you to package a collection of objects into a chart which can be deployed to the cluster. For the
rest of this tutorial we use the **[Dev](https://github.com/ConsenSys/quorum-kubernetes/tree/master/dev)** Helm charts.
rest of this tutorial we use the [**Helm charts**](https://github.com/ConsenSys/quorum-kubernetes/tree/master/helm).
After cloning the [Quorum-Kubernetes](https://github.com/ConsenSys/quorum-kubernetes) repository, change
to the `dev` directory for the rest of this tutorial.

```bash
cd dev/helm
cd helm
```

If you're running the cluster on AWS or Azure, update the `values.yml` with `provider: aws` or
Expand Down Expand Up @@ -75,7 +75,7 @@ which allow Prometheus to scrape metrics from the pod at a specified port and pa
prometheus.io/path: "/metrics"
```

Update the admin `username` and `password` in the [monitoring values file](https://github.com/ConsenSys/quorum-kubernetes/blob/master/dev/helm/values/monitoring.yml).
Update the admin `username` and `password` in the [monitoring values file](https://github.com/ConsenSys/quorum-kubernetes/blob/master/helm/values/monitoring.yml).
Configure alerts to the receiver of your choice (for example, email or Slack), then deploy the chart using:

```bash
Expand Down Expand Up @@ -103,7 +103,7 @@ helm install filebeat elastic/filebeat --namespace quorum --values ./values/fil
If you install `filebeat`, please create a `filebeat-*` index pattern in `kibana`. All the logs from the nodes are sent to the `filebeat` index.

You can optionally deploy BlockScout to aid with monitoring the network. To do this, update the
[BlockScout values file](https://github.com/ConsenSys/quorum-kubernetes/blob/master/dev/helm/values/blockscout-besu.yml)
[BlockScout values file](https://github.com/ConsenSys/quorum-kubernetes/blob/master/helm/values/blockscout-besu.yml)
and set the `database` and `secret_key_base` values.

!!! important
Expand All @@ -128,7 +128,7 @@ The genesis chart creates the genesis file and keys for the validators and bootn
pool can be named to anything you like.

Update the number of validators, accounts, chain ID, and any parameters for the genesis file in the
[`genesis-besu` values file](https://github.com/ConsenSys/quorum-kubernetes/blob/master/dev/helm/values/genesis-besu.yml), then
[`genesis-besu` values file](https://github.com/ConsenSys/quorum-kubernetes/blob/master/helm/values/genesis-besu.yml), then
deploy the chart using:

```bash
Expand Down Expand Up @@ -204,7 +204,7 @@ first validator was spun up, before the logs display blocks being created.
![k8s-validator-logs](../../images/kubernetes-validator-logs.png)

**To add a validator into the network**, deploy a normal RPC node (step 7) and then
[vote](../../HowTo/Configure/Consensus-Protocols/IBFT.md#adding-and-removing-validators) it into the validator pool.
[vote](../../HowTo/Configure/Consensus-Protocols/IBFT.md#add-and-remove-validators) it into the validator pool.

### 7. Deploy RPC or transaction nodes

Expand Down
2 changes: 1 addition & 1 deletion docs/Tutorials/Kubernetes/Maintenance.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Production charts for Azure use Azure Files, and on AWS use EBS Block Store whic

To update the volume size, you must update the override values file.
For example, to increase the size on the transaction nodes volumes, add the following snippet to the
[`txnode values.yml`](https://github.com/ConsenSys/quorum-kubernetes/blob/master/dev/helm/values/txnode.yml) file, with
[`txnode values.yml`](https://github.com/ConsenSys/quorum-kubernetes/blob/master/helm/values/txnode.yml) file, with
the new size limit (the following example uses 50Gi).

```bash
Expand Down
22 changes: 10 additions & 12 deletions docs/Tutorials/Kubernetes/Overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ description: Deploying Hyperledger Besu with Kubernetes
Use the [reference implementations](https://github.com/ConsenSys/besu-kubernetes) to install
private networks using Kubernetes (K8s). Reference implementations are available using:

* [Helm](https://github.com/ConsenSys/quorum-kubernetes/tree/master/dev).
* [Helm](https://github.com/ConsenSys/quorum-kubernetes/tree/master/helm).
* [Helmfile](https://github.com/roboll/helmfile).
* [`kubectl`](https://github.com/ConsenSys/besu-kubernetes/tree/master/playground/kubectl).

Expand All @@ -23,22 +23,20 @@ Helm charts that you can customize and deploy on a local cluster or in the cloud

We recommend starting with the [playground](https://github.com/ConsenSys/quorum-kubernetes/tree/master/playground)
directory and working through the example setups before moving to the
[`dev`](https://github.com/ConsenSys/quorum-kubernetes/tree/master/dev) directory, and finally to the
[`prod`](https://github.com/ConsenSys/quorum-kubernetes/tree/master/prod) directory.
[`Helm charts`](https://github.com/ConsenSys/quorum-kubernetes/tree/master/helm/) directory.

The `dev` and `prod` directories are identical in terms of what gets deployed, but differ in that the `prod` folder uses
best practices to manage identity (Managed Identities in Azure and IAM in AWS), vaults (KeyVault in Azure and Secrets
Manager in AWS), and CSI drivers.
The Helm charts follow best practices to manage identity (Managed Identities in Azure and IAM in AWS),
vaults (KeyVault in Azure and Secrets Manager in AWS), and CSI drivers.

All setups use monitoring and we recommend deploying the monitoring manifests or charts to get an overview of the
network, nodes, and volumes, and you can create alerts accordingly.
In addition, there's an example configuration for ingress and routes that you can customize to suit your requirements.
Provided Helm charts use monitoring, and we recommend deploying the monitoring manifests or charts
to get an overview of the network, nodes, and volumes, and you can create alerts accordingly.

An example configuration is available for ingress and routes that you can customize to suit your requirements.

### Cloud support

The repository's `dev` charts support on premise and cloud providers like AWS, Azure, GCP, IBM etc. The `prod` charts
currently only supports AWS EKS and Azure AKS natively. You can configure the provider in
the [values.yml](https://github.com/ConsenSys/quorum-kubernetes/blob/master/dev/helm/values/genesis-goquorum.yml)
The charts support on premise AWS EKS and Azure AKS cloud providers natively. You can configure the provider in
the [values.yml](https://github.com/ConsenSys/quorum-kubernetes/blob/master/helm/values/genesis-goquorum.yml)
file by setting `provider` to `local`, `aws`, or `azure`.
You can also pass in extra configuration such as a KeyVault name (Azure only).

Expand Down
11 changes: 5 additions & 6 deletions docs/Tutorials/Kubernetes/Production.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,17 +44,16 @@ Server Version: version.Info{Major:"1", Minor:"22", GitVersion:"v1.22.3", GitCom

### Deploy the network

For the rest of this tutorial we use the **[Prod](https://github.com/ConsenSys/quorum-kubernetes/tree/master/prod)**
Helm charts. After you have cloned the [Quorum-Kubernetes](https://github.com/ConsenSys/quorum-kubernetes) repository,
For the rest of this tutorial we use the [**Helm charts**](https://github.com/ConsenSys/quorum-kubernetes/tree/master/helm). After you have cloned the [Quorum-Kubernetes](https://github.com/ConsenSys/quorum-kubernetes) repository,
change the directory to `prod` for the rest of this tutorial.

```bash
cd prod/helm
cd helm
```

!!!attention

Please update all the [values files](https://github.com/ConsenSys/quorum-kubernetes/tree/master/prod/helm/values)
Please update all the [values files](https://github.com/ConsenSys/quorum-kubernetes/tree/master/helm/values)
with your choice of cloud provider (AWS or Azure) and set `provider: aws` or `provider: azure` as required.
Depending on the provider, you may also need to update the `azure:` or `aws:` dictionaries with specifics of your
cluster and account.
Expand All @@ -78,9 +77,9 @@ Please check the [limitations](./Overview.md#limitations) and use CNI where poss
To connect an external node to your cluster, the easiest way is to use a VPN as seen in the
following [multi-cluster](#multi-cluster-support) setup.

Finally, we recommend setting up monitoring and alerting from the beginning so you can get early warnings of issues
Finally, we recommend setting up monitoring and alerting from the beginning, so you can get early warnings of issues
rather than after failure.
We have a monitoring chart which uses Grafana and you can use it in conjunction with Alertmanager to create alerts or
We have a monitoring chart which uses Grafana and you can use it with Alertmanager to create alerts or
alternatively alert via Cloudwatch or Azure Monitoring.

## Multi-cluster support
Expand Down

0 comments on commit 54bb372

Please sign in to comment.