DoPaaS

中文文档 | English version goes here

<b style="color:red">Notes: Currently, the fully distributed version is being incubation, so it is not a good choice to run directly in the production environment !</b>

One stop solution of PaaS platform based on DevSecOps

Based on SpringCloud/Docker/ServiceMesh(istio), the main modules are: unified asset management center (Cmdb), unified continuous delivery center (distributed compilation CI/CD), Iam Certification Center(Rbac/Oidc/[Saml2])), unified monitoring center (SBA/Zipkin/Promethous), unified configuration center, unified operation center (Elasticjob/Spark/Flink/MR), unified Document Center (Swagger/Rap), unified development center (Lcdp/Autogen), unified private object storage management, unified library management (Git/Nexus(Maven/Image)), Shell-Cli, multiple tool chains (Hdfs/HBase/Phoenix/OSS), instant messaging, lightweight risk control, etc

1. Development and runtime on technology stack(primary)

This project is mainly based on the development of SpringBoot/Cloud/Dubbo, which supports the operation of traditional monomer (standalone) mode and fully distributed micro service (cluster) mode. The source structure is carefully designed as  <b>It's both a platform and a framework demonstration</b>.

• Required dependencies: Spring Boot:2.3 +
  Spring Cloud:Hoxton.x +
  Eureka:1.10 +
  Zipkin:2.15 +
  Jdk:8 +
  Maven:3.5 +
  Mysql:5.6 +

• Optional dependencies:
  Kafka:2.3.1 +
  Zookeeper:3.6.0 +
  DockerCE:18.06 +
  CoreDNS:1.7.0 +
  MinIO:latest
  Elasticsearch(EFK):6.2.3 +
  Shardingsphere-Elasticjob:3.0.0 +

• Developments Guide

2.1 OneStop auto deployment

This method is applicable to the rapid deployment of regular hosts (non container). The deployment script will automatically detect the installation, including jdk/nginx/git/maven/node/eureka/zookeeper and all springboot apps, but not including redis/redis cluster(one of the options) and Mysql, which need to be manually installed.

bash -c "$(curl -L https://raw.githubusercontent.com/wl4g/dopaas/master/script/deploy/deploy-boot.sh)"
# or
bash -c "$(curl -L https://gitee.com/wl4g/dopaas/raw/master/script/deploy/deploy-boot.sh)"

• Please pay attention to modify deploy-env.sh custom environment configuration according to the script prompt, and then re execute ./deploy-boot.sh. Please wait about 8-20 minutes patiently for the deployment from source code compilation (because the first time the code and dependency library will be slow to download. If you need to redeploy, you can set the export buildForcedOnPullUpToDate=true or export deployFrontendSkip=true to skip backend compilation and frontend compilation to accelerate)

• Before deployment, check whether nginx / zookeeper / Eureka has been installed on the target host. If so, it is recommended to stop first, because automatic deployment will also avoid conflicts

Cluster management tools:
./dopaas-ctl.sh

Usage: {start-all|stop-all|restart-all|status-all|<appName> <start|stop|restart|status>}
    start-all    Start all remote nodes apps.
     stop-all    Stop all remote nodes apps.
  restart-all    Restart all remote nodes apps.
   status-all    Query status all remote nodes apps.
    <appName> <start|stop|restart|status>   for example: {cmdb-facade restart}
        Restart only the cmdb-facade application of all remote nodes,
        The optionals are: zookeeper/eureka-server/iam-web/iam-facade/iam-data/cmdb-facade/cmdb-manager/... etc.

Server specs requirements:

| Runtime Mode | Min requirements | Description | | ---- | ---- | ---- | | cluster | CentOS7+ / Ubuntu18+ (4C+8G+) | Only pseudo distributed clusters can be deployed when there is only one host | | standalone | 2C+4G+ | Monomer application |

2.2 Manual compilation and build

It is suitable for build secondary development environment

2.2.1 Editing .m2/settings.xml

<mirror>
    <id>nexus-aliyun</id>
    <mirrorOf>central</mirrorOf>
    <name>Nexus aliyun</name>
    <url>http://maven.aliyun.com/nexus/content/groups/public<url>
</mirror>

2.2.2 Backend compiling

Compile according to the order of project dependency. The mvn -P options are: springExecJar (packaged as a single executable jar) and mvnAssTar (packaged as a general software release package), default.

git clone https://github.com/wl4g/component.git # Relatively new upstream (recommended)
# git clone https://gitee.com/wl4g/component.git # or
mvn -f component -U clean install -DskipTests -T 2C

git clone https://github.com/wl4g/iam.git # Relatively new upstream (recommended)
# git clone https://gitee.com/wl4g/iam.git # or
mvn -f iam -U clean install -DskipTests -T 2C

git clone https://github.com/wl4g/dopaas.git # Relatively new upstream (recommended)
# git clone https://gitee.com/wl4g/dopaas.git # or
mvn -f dopaas -U clean install -DskipTests -T 2C

2.2.3 Frontend compiling

git clone https://github.com/wl4g/dopaas-view.git # Relatively new upstream (recommended)
or git clone https://gitee.com/wl4g/dopaas-view.git
npm run dev # Development debugging
npm run build # Production building

2.3 Init DB: first, prepare a MySQL5.6+ instance and create a database named dopaas(utf8/utf8)_bin), and then Init DB sql.

Notes: the SQL script should correspond to the source code version. We will update it regularly. It is recommended to use the latest version

2.4 Configure DNS resolutio(C:\Windows\System32\drivers\etc or vim /etc/hosts)

Standalone mode resolution example
Cluster mode resolution example

Note: the domain names used for external services in different environments should correspond to sys_cluster_config.extranet_base_uri table

2.5 Quickly build a redis cluster/docker(or self built)

https://github.com/wl4g/docker-redis-cluster or
https://gitee.com/wl4g/docker-redis-cluster

2.6 Launch and testing access (chrome recommended)

Notes：
a. There is no need to specify any JVM args when trying to start (the default configuration is used). For example, only the configuration of dev environment will be activated by default;
b. Whether it is standalone mode or cluster mode, it can correspond to four environments respectively (dev/fat/uat/pro).

2.6.1 Starting for standalone mode.

Just run the following bootstrap classes:

com.wl4g.StandaloneDopaas  
com.wl4g.StandaloneIam  

2.6.2 Starting for cluster mode.

Run the following bootstrap classes:

com.wl4g.EurekaServer  
com.wl4g.IamWeb  
com.wl4g.IamFacade  
com.wl4g.IamData  
com.wl4g.CmdbFacade  
com.wl4g.CmdbManager  
com.wl4g.HomeFacade  
com.wl4g.HomeManager  
com.wl4g.LcdpFacade  
com.wl4g.LcdpManager  
com.wl4g.UciFacade  
com.wl4g.UciServer  
com.wl4g.UdmFacade  
com.wl4g.UdmManager  
com.wl4g.UdsFacade  
com.wl4g.UdsManager 
com.wl4g.UmcFacade 
com.wl4g.UmcManager  
com.wl4g.UmcTracker 
com.wl4g.UmcCollector 
com.wl4g.UosFacade  
com.wl4g.UosManager  
com.wl4g.UrmFacade  
com.wl4g.UrmManager  

2.6.3 Testing access (chrome recommended)

http://wl4g.debug    Default account password: root/wl4g.com

2.7 Deployed successful screenshot:

Tips: the screenshot may be slightly different due to the version evolution, if you have any questions, please join the communication group (see the end section)

• More shots

3. Submodule documents

• UCI Unified Continuous Integration Service(CI/CD)
• UMC Unified Monitoring and Operation Center(applications healthing, tracking, alarming, ELK log analysis, etc)
• URM Unified Repository Management(source repo/build repo/image repo)
• UCM Unified Config Management(Online configuration of hot updates such as dataSource, redisClient, etc)
• CMDB Configuration Management D