4.1 KiB
Wellcome to Cloudeploy
How this documentation is organized
Introductions of Cloudeploy.
Requirements and installation
Demo Case
License
What is Cloudeploy？
Cloudeploy is an online platform for deploying and configuring cloud based applications.User can easily achieve the following functions without high level specific domain knowledge.
- Continuous deployment and configuration for cloud based applications(such as Tomcat,Nginx,MySQL etc.) .
- Management of cloud based components on topology relations and consistency of parameters.
- Health monitor and report for middleware instances.
- Dynamic scale on numbers of middleware instances.
- Fault Self-tolerance for instances.
How to install Cloudeploy?
Required Files :
Cloudeploy.zip
cloudeploy.sql
ConsulAgent.zip
Overview:The Frame of this platform consists of two part: agent cluster and servers, as the figure1 shows.
Figure-1: ![framework][1] [1]:https://raw.githubusercontent.com/xpxstar/Cloudeploy/master/doc-image/framwork.jpg "framework for cloudeploy"
1.Install agent cluster
Agent cluster consists of at least three computers(agent 1-3 in figure1), which are hosts of cloud based applications. For every agent, the environment is built as follows.
OS：Liunx-x64
Java (version >= 7.0)
docker(version >= 1.9)[Download and Install](https://docs.docker.com/engine/installation/linux/)
consul(version >= 0.6)[Download and Install](https://www.consul.io/intro/getting-started/install.html)
(1)Docker
start docker with listening socket of tcp:
docker daemon -H tcp://0.0.0.0:2375 &
download images that needed:
docker pull xpxstar/mysql
docker pull xpxstar/tomcat
docker pull docker.io/nginx
(2)consul
unzip consulAgent.zip to directory of "／opt"
start consul on agent1、agent2 with model of server and add itself to consul cluster.
consul agent -server -data-dir /opt/data/ -ui-dir /opt/ui -bootstrap-expect 2 -node=node1 -dc=dc1 -bind=<agent-ip> -client=0.0.0.0 &
consul join <agent1-ip>
start consul on agent3 and other agent with model of agent,and add itself to consul cluster
consul agent -data-dir /opt/data/ -ui-dir /opt/ui -node=node3 -dc=dc1 -bind=<agent-ip> -client=0.0.0.0 &
consul join <agent1-ip>
(3)consul-template
start consul-template on agent:
/opt/consul-template -config /opt/agent/consul-template --consul 0.0.0.0:8500 -retry=1s &
(4)consulAgent
start consulAgent.jar with the following command:
java -jar /opt/agent/consulAgent-0.0.1-SNAPSHOT.jar
notice: you should open some ports through firewall of agent.：
2375,3306,8300,8301,8301,8400,8500,8600,8380
2.Install Servers
There are Web server,Database server,File server.The OS of server hosts can be linux or windows.And You can install them in the same host as you like.
Environment of Host A:
MySQL(version >= 5.1) [Download and Install](http://dev.mysql.com/downloads/mysql/)
start mysql and create database named cloudeploy.Import cloudeploy.sql into database to build data structures.
Environment of Host B and C Here we can put file servr and web server into the same Host, named Host B
JAVA (version >= 7.0)
Tomcat (version>=7.0.30) [Download and Install] (https://tomcat.apache.org/download-70.cgi)
unzip cloudapp.zip to directory of "$TOMCAT_PATH/webapps",edit configure files：
Cloudeploy/WEB-INF/classes/application.properties:
jdbc.url=<HostA-ip>
consul_host=<agent1-ip>
Cloudeploy/WEB-INF/lib/configs.properties:
deploy.server.host=<agent1-ip>
server.root=http://<Host B-ip>:8080/cloudapp
start tomcat to finish installation
sh $TOMCAT_PATH/bin/startup.sh
User Demo Guide
To see document/Demo.mp4
Develpment based on Cloudeploy
Server project of Cloudeploy_app is develped by java with maven,so just import the project into Eclipse in maven environment.
Client Agent project( https://github.com/xpxstar/ConsulAgent) of ConsulAgent is a normal java project.
see：
document/design document.pdf
document/requirement document.pdf
FAQ: Support By Pershing [xupeixing14@otcaix.iscas.ac.cn]
with License under GNU showing in LICENSE.