REAMDE.md

Cloudogu EcoSystem (CES)

This is the repository containing all setup scripts and resources to install a Cloudogu EcoSystem. For help, you can have a look at our documentation or ask a question in our community.

Documentation Community

Quick start

There are three ways to get your Cloudogu EcoSystem. The easiest is to register at the Cloudogu Platform and download the VirtualBox or QEMU image. Alternatively, you can create it from scratch with Vagrant or Packer.

1. Download VirtualBox or QEMU image from the Cloudogu Platform

Install VirtualBox or QEMU
Register at the platform and download the image for VirtualBox or QEMU
- If you want to verify the integrity of the download, you can also get the SHA256 hash
Follow the quickstart guide at cloudogu.com.

2. Build from scratch with vagrant

Install git
Install virtualbox
Install vagrant
Checkout EcoSystem repository git clone https://github.com/cloudogu/ecosystem
cd ecosystem
vagrant up to run EcoSystem in a virtual machine
When vagrant is done, enter the following URL in your browser : http://192.168.56.2:8080
Follow the steps of the setup wizard

VM configuration (bridged network)

By default our vagrant configuration uses a host-only network, which makes the EcoSystem only accessible from your machine.

If you want it to be accessible from other hosts in your network, you can change this behavior in the Vagrantfile. To do so,

remove the private_network line and
uncomment the public_network line.

Next time you start the VM, it will use a bridged network and try to get an IP address from the network your host is in.

By the way:

You can shut down the VM by calling vagrant halt.
If you want to start over with a clean slate call vagrant destroy.

3. Build with Packer

Download Packer from https://www.packer.io/downloads.html and move the extracted binary to /usr/local/bin/packer.

Build the VM according to your liking with one of the builders in images/template.prod.json.

What is the Cloudogu EcoSystem?

The Cloudogu EcoSystem is an open platform, which lets you choose how and where your team creates great software. Each service or tool is delivered as a Dogu, a Docker container. Each Dogu can easily be integrated in your environment just by pulling it from our registry.

We have a growing number of ready-to-use Dogus, e.g. SCM-Manager, Jenkins, Nexus Repository, SonarQube, Redmine and many more. Every Dogu can be tailored to your specific needs. Take advantage of a central authentication service, a dynamic navigation, that lets you easily switch between the web UIs and a smart configuration magic, which automatically detects and responds to dependencies between Dogus.

The Cloudogu EcoSystem is open source and it runs either on-premises or in the cloud. The Cloudogu EcoSystem is developed by Cloudogu GmbH under AGPL-3.0-only.

License

Copyright © 2020 - present Cloudogu GmbH This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, version 3. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/. See LICENSE for details.

MADE WITH :heart: FOR DEV ADDICTS. Legal notice / Imprint