My Application Setup

Install and update My Application automatically via Ansible. Integrate it into your CI/CD process or test it locally with Vagrant and VirtualBox.

Local installation with Vagrant for testing

Scenario: To test My Application a little bit with minimal effort, you can use a local installation in the local VirtualBox VM via Vargant. This is also suitable for developers to perform "system tests" for their changes.

Prerequisites

• Git
• Vagrant
• VirtualBox

Perform the following steps in the terminal (Linux / macOS) or in the GitBash (Windows):

git clone https://github.com/mirjan-hoffmann/test-box.git
cd test-box
vagrant up

When the installation is complete, My Application will be running on

• 192.168.98.141

Helpful Vagrant commands

• vagrant up - Creates a new VM and runs the Ansible playbook, if no VM exists. Turn on a shut down VM, if the VM was created before
• vagrant halt - Shuts down the VM
• vagrant destroy - Removes the VM
• vagrant reload --provision - Restarts the VM and re-runs the Ansible playbook
• vagrant provision - Re-runs the Ansible playbook without updating the ansible-scripts and without restarting the VM
• vagrant ssh - SSH into the running VM

Integration into a CI/CD process

Scenario: Install My Application automatically on an existing system like your Test/Prod system. Since this is done via Docker containers here, the environment from which the installation is performed is always the same and there are no conflicts due to different Ansible versions on the installation host. This makes the installation more stable. You will be able to start the installation fully automatically with a simple click in the browser or even use a scheduled or triggered installation.

GitLab CI/CD

see https://github.com/TIBHannover/application-setup-box-template/wiki/Integration-of-automated-installation-into-GitLab-CI-CD-process

also have a look at the gitlab-config-example