Welcome to the SiSa Wiki

This project was invented to have a quick start building web applications. It was planned to setup a development environment quickly and fast. But that's not all, it should help you also to setup equal testing, staging and production servers to start up your company without loosing time in provisioning and configuration management. As I started the focus was on PHP applications, but I started with microservices implemented in Golang. Therefor I defined more and more server roles doing these jobs.

You can use this package in your project with Composer, NPM or Bower. Therefor have a look at the wiki page Use SiSa In Your Project.

Getting Started

If you are familiar with Oracle Virtual Box and Vagrant just start as described in Chapter Setup for Composer as decribed in the README.md or Overview. Otherwise continue with next chapter. You'll find also some examples in the Vagrantfile which you'll find in the root folder of this project.

Using Vagrant and VirtualBox for Development Environment

To setup a development vm my advice is to use the following tools:

You can also use another virtualization, but than you are on your own. You should start downloading and installing the latest version of these tools.

The next step is to install some vagrant plugins. Let's start with vagrant-vbguest. This plugins ensures you have the correct guest additions matching to your VirtualBox version installed.

#!shell

vagrant plugin install vagrant-vbguest

To manage the host name for the boxes we need to install the vagrant-hostmanager plugin:

#!shell

vagrant plugin install vagrant-hostmanager

No give it a try. Create a new directory. Clone this repository in that new folder and start a machine.

#!shell

mkdir [project]
cd [project]
git clone https://bitbucket.org/Rebel-L/sisa.git
vagrant up ToolBox

Now we can try to ping the vm by dns from your host machine and guest vm:

#!shell

ping sisa-toolbox.dev
ssh sisa-toolbox.dev
ping sisa-toolbox.dev

The result should be similar to the following:

# by host
Antwort von 192.168.33.253: Bytes=32 Zeit<1ms TTL=64
Antwort von 192.168.33.253: Bytes=32 Zeit<1ms TTL=64
Antwort von 192.168.33.253: Bytes=32 Zeit<1ms TTL=64
Antwort von 192.168.33.253: Bytes=32 Zeit<1ms TTL=64

Ping-Statistik für 192.168.33.253:
    Pakete: Gesendet = 4, Empfangen = 4, Verloren = 0
    (0% Verlust),
Ca. Zeitangaben in Millisek.:
    Minimum = 0ms, Maximum = 0ms, Mittelwert = 0ms


# by guest
PING sisa-toolbox.dev (127.0.1.1) 56(84) bytes of data.
64 bytes from sisa-toolbox.dev (127.0.1.1): icmp_seq=1 ttl=64 time=0.013 ms
64 bytes from sisa-toolbox.dev (127.0.1.1): icmp_seq=2 ttl=64 time=0.054 ms
64 bytes from sisa-toolbox.dev (127.0.1.1): icmp_seq=3 ttl=64 time=0.036 ms
64 bytes from sisa-toolbox.dev (127.0.1.1): icmp_seq=4 ttl=64 time=0.044 ms