Page History

Bug Reference

N/ACLOUDSTACK-8249

Branch

dockerfile

Introduction

...

• Automated Build on Jenkins.buildacloud.org will push images on triggered events and publish containers on https://registry.hub.docker.com/repos/cloudstack/

• Expected container list:

  container name	tag	Jenkins job	include	Status
  simulator (ubuntu)	latest 4.5 4.6	dockerbuild-master-simulator dockerbuild-4.5-simulator	java managment-server (build via mvn) marvin maven MySQL server	https://hub.docker.com/r/cloudstack/simulator/
  management_centos6 management_centos7 management_ubuntu1404	latest	dockerbuild-master-management_centos6	java MySQL server management-server (from rpm/deb)	https://hub.docker.com/r/cloudstack/management_centos6/
  marvin	latest	dockerbuild-master-marvin	Python 2.7 marvin	https://hub.docker.com/r/cloudstack/marvin/
  usage_centos6 usage_centos7 usage_ubuntu1404	latest		java usage-server (from rpm/deb)
  cloudmonkey	latest		Python 2.7 cloudmonkey	https://hub.docker.com/r/cloudstack/cloudstack-cloudmonkey/
  ec2stack	latest
  agent_centos7 agent_ubuntu1404	latest		java cloudstack-agent
  database	latest		MySQL with pre-configured database (integration.api.port)

• quality risks (test guidelines)
  • might not perfectly refect a production environment
  • cannot be use into a production environment as sshkeys are pregenerated.
  • negative usage scenarios: don't use in prod

...

• discussion of alternatives amongst design ideas, their resources/time tradeoffs and limitations. Explain why a certain design idea is chosen over others
• highlight architectural patterns being used (queues, async/sync, state machines, etc)
• talk about main algorithms used
• explain what components are being changed and what the dependent components are
• regarding database: talk about tables being added/modified
• performance implications: what are the improvements or risks introduced to capacity, response time, resources usage and other relevant KPIs
• preferably show class diagrams, sequence diagrams and state diagrams
• if possible, publish signatures of all methods classes and interfaces implement, and the explain the object information of different classes

UserGuide

Prerequisites

• NFS server with share for  primary and secondary storage
• Hypervisor ready to be managed
• docker host
• preconfigured network

Self deployed cloud using XenServermount NFS share localy ex: /data/secondary

1. Download images

   Code Block
   docker pull cloudstack/management_centos6 docker pull cloudstack/marvin

2. prepare Secondary Storage NFS share for the systemVM template
   
   The NFS server should not run on the management-server.

   Code Block
   mount <NFS IP>:/share/secondary /data/secondary

3. Start CloudStack Management server

   Code Block
   docker run --name cloudstack -d -p 8080:8080 -v /data/secondary:/secondary cloudstack/management_centos6

   • Expose UI and API on port 8080 (http://localhost:8080/client)
   • username = admin
   • password = password
   • share nfs mounted drive as /secondary

4. Download systemVM template of your choice:

   (This will take a moment...)

   Code Block
   docker exec -ti cloudstack /usr/share/cloudstack-common/scripts/storage/secondary/cloud-install-sys-tmplt \ -m /secondary \ -u http://jenkins.buildacloud.org/job/build-systemvm64-master/lastSuccessfulBuild/artifact/tools/appliance/dist/systemvm64template-master-4.6.0-xen.vhd.bz2 \ -h xenserver -F

5. Create a cloud configuration file, this example use mytests/mycloud.cfg filename as example.

   refer to setup/dev example from cloudstack source.
   
   Make sure to use following statement (hypervisor can change) for the CloudStack endpoint:

   Code Block
   title advanced.cfg
   "mgtSvr": [ { "mgtSvrIp": "cloudstack", "passwd": "password", "user": "root", "port": 8096, "hypervisor": "xenserver", "useHttps": "False", "certCAPath": "NA", "certPath": "NA" } ]

6. Deploy your Cloud from a configuration file using Marvin:

   Code Block
   docker run -ti --name marvin --link cloudstack:8096 \ -v /data/home/pldionjdoe/Documents/acs:/marvin/mytests \ docker.io/cloudstack/marvin \ python marvin/deployDataCenter.py \ -i mytests/mycloud.cfg

   
   This will mount mytests/ into the container and execute marvin to deploy DataCenter using api port, cloudstack:8096.
   
   
   
   

...