Dante Cloud Documentation

Dante Cloud is an enterprise-grade, cloud-native microservices foundation designed for high-quality code, low security vulnerabilities, and high modularity. It is built on the Spring ecosystem and utilizes Domain-Driven Design (DDD) principles.

Key features include:

• Dual-Architecture Support: A unique "one code, two architectures" approach that allows seamless switching between monolithic and microservices architectures using the same codebase.
• Security-Focused: Supports IoT device authentication (Smart TVs, etc.), meets National Level 3 security requirements, and supports Chinese national cryptographic (Guomi) digital envelope encryption.
• Modular & Extensible: Highly modular and componentized design, allowing for "pluggable" functionality and adaptation to various business scenarios.
• High-Performance: Supports both blocking and reactive services in parallel.

Since version 2.7.X, the project has been split into two distinct engineering entities:

1. Dante Cloud: The main application runtime and module combination engineering. It provides a set of microservices that can be flexibly split or assembled like Lego blocks.
2. Dante Engine: The core component library engineering. It contains highly abstracted code designed for high reusability across different projects.

Users typically interact with Dante Cloud to deploy systems, but can leverage the underlying component architecture for custom implementations.

To set up the database for the Dante Monolith version, you need to create a specific user and database. This script creates a user named athena with the password athena, initializes a database named dante_athena owned by that user, and grants full privileges to the user.

Note: For production environments, you should adjust the privilege settings and credentials according to your security requirements.

-- Create user athena with password 'athena'. Skip if user already exists.
CREATE USER athena WITH PASSWORD 'athena';

-- Create database dante_athena and assign owner to athena
CREATE DATABASE dante_athena OWNER athena;

-- Grant all privileges on dante_athena to athena. Adjust for production.
GRANT ALL PRIVILEGES ON DATABASE dante_athena TO athena;

Nacos 3.2.0 does not support automatic user creation. To set up the default user with credentials nacos / nacos, execute the following SQL script against your Nacos database. This creates a user named nacos with the corresponding hashed password and enabled status.

INSERT INTO users (username, password, enabled) VALUES ('nacos', '$2a$10$EuWPZHzz32dJN7jexM34MOeYirDdFAZm2kuWj7VEOJhhZkDrxfvUu', TRUE);

The configurations/scripts/tick/ directory contains default configuration files for components like InfluxDB and Telegraf. These files are exported based on official documentation to serve as templates for external custom configurations.

To use these configurations in your own environment, follow the directory structure defined in the volumes configuration within env.tick.yml. Place your customized configuration files into the corresponding directories mapped by those volumes.

To ensure smooth upgrades and maintain compatibility with official releases, follow these guidelines:

1. Minimize Customizations: Avoid modifying the source code of Dante Engine, Dante OSS, or other core components outside of your own project.
2. Contribute Changes: If you must modify core components, submit a Pull Request to the official repository so your changes can be synchronized with future official updates.
3. Consult Release Logs: Check the Official Update Logs for new features and improvements in each version.
4. Follow Breaking Change Guides: For versions with significant architectural changes, refer to the Breaking Change Guides for specific migration instructions.

To set up a PostgreSQL database for Nacos, execute the following SQL commands. This script creates a dedicated user named nacos with the password nacos, creates a database named nacos owned by that user, and grants all privileges to the user.

Note: In production environments, you should adjust the user permissions and password strength according to your security requirements.

-- Create user nacos with password 'nacos'. If the user already exists, you can skip this.
CREATE USER nacos WITH PASSWORD 'nacos';

-- Create database nacos and assign the user nacos as the owner.
CREATE DATABASE nacos OWNER nacos;

-- Grant all privileges on the nacos database to the nacos user.
-- Adjust this for production environments based on actual needs.
GRANT ALL PRIVILEGES ON DATABASE nacos TO nacos;

To set up the required PostgreSQL databases for Dante Cloud and Athena, execute the following SQL commands. These scripts create dedicated users and databases with appropriate ownership and privileges.

Dante Cloud Setup

Creates a user herodotus and a database dante_cloud.

Athena Setup

Creates a user athena and a database dante_athena.

Note: For production environments, you should adjust the GRANT ALL PRIVILEGES settings according to your security requirements.

-- Dante Cloud Setup
CREATE USER herodotus WITH PASSWORD 'herodotus';
CREATE DATABASE dante_cloud OWNER herodotus;
GRANT ALL PRIVILEGES ON DATABASE dante_cloud TO herodotus;

-- Athena Setup
CREATE USER athena WITH PASSWORD 'athena';
CREATE DATABASE dante_athena OWNER athena;
GRANT ALL PRIVILEGES ON DATABASE dante_athena TO athena;