Caution
The contents of the docs folder have been moved to the docs-internal-orchestration repository. Please update this documentation in that repository instead.
To view the Scalar Kubernetes documentation, visit the documentation site for the product you are using:
This guide explains how to deploy ScalarDL Ledger and ScalarDL Auditor on Amazon Elastic Kubernetes Service (EKS).
In this guide, you will create one of the following three environments in your AWS environment. To make Byzantine fault detection work properly, we recommend deploying ScalarDL Ledger and ScalarDL Auditor on different administrative domains (i.e., separate environments).
-
Use different AWS accounts (most recommended way)
-
Use different Amazon Virtual Private Clouds (VPCs) (second recommended way)
-
Use different namespaces (third recommended way)
Note: This guide follows the second recommended way, "Use different VPCs."
You must get the ScalarDL Ledger and ScalarDL Auditor container images from AWS Marketplace and subscribe to ScalarDL Ledger and ScalarDL Auditor. For details on how to subscribe to ScalarDL Ledger and ScalarDL Auditor in AWS Marketplace, see Subscribe to Scalar products from AWS Marketplace.
You must create an EKS cluster for the ScalarDL Ledger deployment. For details, see Guidelines for creating an Amazon EKS cluster for Scalar products.
You must also create an EKS cluster for the ScalarDL Auditor deployment. For details, see Guidelines for creating an Amazon EKS cluster for Scalar products.
You must prepare a database before deploying ScalarDL Ledger. Because ScalarDL Ledger uses ScalarDB internally to access databases, refer to ScalarDB Supported Databases to see which types of databases ScalarDB supports.
For details on setting up a database, see Set up a database for ScalarDB/ScalarDL deployment on AWS.
You must also prepare a database before deploying ScalarDL Auditor. Because ScalarDL Auditor uses ScalarDB internally to access databases, refer to ScalarDB Supported Databases to see which types of databases ScalarDB supports.
For details on setting up a database, see Set up a database for ScalarDB/ScalarDL deployment on AWS.
To execute some tools for deploying and managing ScalarDL Ledger on EKS, you must prepare a bastion server in the same VPC of the EKS cluster that you created in Step 2. For details, see Create a Bastion Server.
To execute some tools for deploying and managing ScalarDL Auditor on EKS, you must prepare a bastion server in the same VPC of the EKS cluster that you created in Step 3. For details, see Create a Bastion Server.
To make ScalarDL work properly, ScalarDL Ledger and ScalarDL Auditor need to connect to each other. You must connect two VPCs by using VPC peering. For details, see Configure network peering for ScalarDL Auditor mode.
Step 9. Prepare custom values files for the Scalar Helm Charts for ScalarDL Ledger and ScalarDL Schema Loader
To perform tasks, like accessing information in the database that you created in Step 4, you must configure custom values files for the Scalar Helm Charts for ScalarDL Ledger and ScalarDL Schema Loader (for Ledger) based on your environment. For details, see Configure a custom values file for Scalar Helm Charts.
Deploy ScalarDL Ledger in your EKS cluster by using the Helm Chart for ScalarDL Ledger. For details, see Deploy Scalar products using Scalar Helm Charts.
Note: We recommend creating a dedicated namespace by using the kubectl create ns scalardl-ledger command and deploying ScalarDL Ledger in the namespace by using the -n scalardl-ledger option with the helm install command.
Step 11. Prepare custom values files for the Scalar Helm Charts for both ScalarDL Auditor and ScalarDL Schema Loader
To perform tasks, like accessing information in the database that you created in Step 5, you must configure custom values files for the Scalar Helm Charts for both ScalarDL Auditor and ScalarDL Schema Loader (for Auditor) based on your environment. For details, see Configure a custom values file for Scalar Helm Charts.
Deploy ScalarDL Auditor in your EKS cluster by using the Helm Chart for ScalarDL Auditor. For details , see Deploy Scalar products using Scalar Helm Charts.
Note: We recommend creating a dedicated namespace by using the kubectl create ns scalardl-auditor command and deploying ScalarDL Auditor in the namespace by using the -n scalardl-auditor option with the helm install command.
After deploying ScalarDL Ledger in your EKS cluster, you must check the status of each component. For details, see Components to Regularly Check When Running in a Kubernetes Environment for more details.
After deploying ScalarDL Auditor on your EKS cluster, you need to check the status of each component. See Components to Regularly Check When Running in a Kubernetes Environment for more details.
After deploying ScalarDL Ledger in your EKS cluster, we recommend monitoring the deployed components and collecting their logs, especially in production. For details, see Monitoring Scalar products on a Kubernetes cluster and Collecting logs from Scalar products on a Kubernetes cluster.
After deploying ScalarDL Auditor in your EKS cluster, we recommend monitoring the deployed components and collecting their logs, especially in production. For details, see Monitoring Scalar products on a Kubernetes cluster and Collecting logs from Scalar products on a Kubernetes cluster.
If you want to remove the environment you created, please remove all the resources in reverse order from which you created them in.