ferrarimarco / open-development-environment-devbox Goto Github PK

6.0 6.0 5.0 230 KB

An automatically provisioned and configured virtual machine serving as a development box

Home Page: https://app.vagrantup.com/ferrarimarco/boxes/open-development-environment-devbox

License: Apache License 2.0

Shell 65.89% Ruby 15.38% Makefile 18.73%

devbox ansible vagrant docker ruby java eclipse virtualbox oracle-sql-developer packer pgadmin shellcheck psscriptanalyzer

open-development-environment-devbox's Introduction

Open Development Environment: Devbox

Master branch:

A Vagrant box serving as a development machine. It's automatically built using Packer and Ansible. Read the related blog post.

Part of the Open Development Environment Project.

Changelog

For a list of changes, have a look at the changelog

Dependencies

These are the dependencies required to run the box:

Vagrant 2.0.3+
Virtualbox 5.2.8+

How to Run

To use the box:

Install the dependencies
Run vagrant init ferrarimarco/open-development-environment-devbox to initialize a Vagrantfile for this box
Run vagrant up

Credentials

There is a vagrant user already configured, password: vagrant

What's inside the box

This "development box" is based on Ubuntu with an XFCE Desktop environment and includes the following tools, ready to be used:

Ansible
Atom editor, along with the plugins listed in the playbook
bmon
Chromium
cookiecutter
curl
Docker
docker-clean
Docker Compose
Dockerlint
Eclipse with the plugins that the ferrarimarco.eclipse Ansible role installs by default
Github Changelog Generator
Git
glogg
hadolint
Imagemagick
Inspec
Java 8 (OpenJDK)
JMeter
Libreoffice Calc
Liquibase
Maven 3
Nano
Nethogs
Oracle SQL Developer: see note below
pgAdmin4
pip
PSScriptAnalyzer
Python
Ruby (with ruby-install and chruby)
Shellcheck
Subversion

Bash aliases

The following aliases are automatically set up during the provisioning process:

changelog-generator: to run Github Changelog Generator
docker-clean: to run docker-clean
dockerfile-lint: to run hadolint and dockerlint on every Dockerfile in the current directory and its subdirectories
git-log1, git-log2, git-log3: see open-development-environment-git for details
pgadmin4: to start a container running pgAdmin4 in single user mode and then open a browser window pointing to it. Data is saved in an external volume mapped to /home/vagrant/.pgadmin4
psscriptanalyzer: to run PSScriptAnalyzer on every Powershell script in the current directory and its subdirectories
shellcheck: to run Shellcheck on every shell script in the current directory and its subdirectories

Example Vagrantfile

Vagrant.configure("2") do |config|
  config.vm.box = "ferrarimarco/open-development-environment-devbox"
  config.vm.network "private_network", type: "dhcp"

  config.vm.provider "virtualbox" do |v|
    v.customize ["modifyvm", :id, "--cpus", 4]
    v.customize ["modifyvm", :id, "--clipboard", "bidirectional"]
    v.customize ["modifyvm", :id, "--memory", 4096]
    v.customize ["modifyvm", :id, "--natdnshostresolver1", "on"]
    v.customize ["modifyvm", :id, "--natdnsproxy1", "on"]
    v.customize ["modifyvm", :id, "--vram", "128"] # 10 MB is the minimum to enable Virtualbox seamless mode

    # Display the VirtualBox GUI
    v.gui = true
  end
end

Contributions

If you have suggestions, please create a new GitHub issue or pull request.

Manual Build

Dependencies

runtime dependencies listed above
GNU Make 4.1+
Packer 1.2.1+

Build

Install the dependencies
Clone the repository
Run make

Testing

Dependencies

Bundler 1.13.0+
Ruby 2.3.0+
Docker 1.12.0+
See Gemfile

Setup

Ssee .travis.yml

Manual Downloads

Due to licensing reasons, we cannot include the SQL Developer setup package. Download it manually from Oracle Website and place it in provisioning/downloads/ and update sql_developer_path value in the variables section of the template (or provide your own variables file).

open-development-environment-devbox's People

Contributors

Stargazers

Watchers

Forkers

ronwelch diassynthesis raisingstar 1211985

open-development-environment-devbox's Issues

Move locale setup and bash aliases configuration to their own playbooks

Use a single task to download dependencies in setup-eclipse.yml

Implement an automated test mechanism

Tools that may help:

Example to use Travis for CI and Test Kitchen: https://github.com/zuazo/kitchen-in-travis-native

Tasks:

Update .gitignore for Ruby and Test Kitchen projects
Setup Test Kitchen gem: test-kitchen
Setup Test Kitchen modules: kitchen-ansible, kitchen-docker, kitchen-inspec

Install Atom

Install Ansible using a shell script

Ansible is now installed using the ansible_local Vagrant provisioner.

I prefer to install it using a plain shell script for a more portable experience.

Remove bottom panel from desktop

Set open-development-environment-git aliases

Reduce the number of tasks used to setup facts during Eclipse installation

Use ferrarimarco.bash-aliases role

Use ferrarimarco.bash-aliases role instead of the builtin task

Use super user privileges to add vagrant user to docker group

Write a README

Set Github changelog generator aliases

Set an alias for the following command: docker run -it --rm -v $(pwd):/app prooph/github-changelog-generator

Install Apache JMeter

Add box version to Vagrantfile

Use config.vm.box_version to ensure that the build is repeatable.

Reduce the number of playbooks used to install and configure Eclipse

Merge ansible-role-xfce with ansible-role-devbox-base

Update open-development-environment-java playbook name

The name of the playbook should be updated to name open-development-environment-devbox

Configure TestNG output directory to /target/test-output

Avoid installing Virtualbox Guest Additions during the provisioning process

Guest additions are installed during the image generation process. There is no need to reinstall them using apt. This may also cause issues because often the version available in Ubuntu repos is not the latest one.

Update bash aliases to open-development-environment-git:1.0.1

Version 1.0.1 of open-development-environment-git supports colorized output.

Increase Eclipse console lines setting

Move Eclipse installation to a dedicated Ansible role

Document how to start installed tools

Eclipse
Oracle SQL Developer

Configure default Eclipse Workspace

Unable to add vagrant user to docker group during the first provisioning

Ansible cannot add vagrant user to the docker group when provisioning the machine for the first time (with vagrant up). If the provisioning is executed a second time (with vagrant provision), it runs fine and vagrant is added to docker group without problems.

This may be due to the SSH session caching done by Ansible. To avoid this issue it could be enough to run the related task in a separate playbook after the one that install Docker.

ferrarimarco / open-development-environment-devbox Goto Github PK

open-development-environment-devbox's Introduction

Open Development Environment: Devbox

Changelog

Dependencies

How to Run

Credentials

What's inside the box

Bash aliases

Example Vagrantfile

Contributions

Manual Build

Dependencies

Build

Testing

Dependencies

Setup

Manual Downloads

open-development-environment-devbox's People

Contributors

Stargazers

Watchers

Forkers

open-development-environment-devbox's Issues

Recommend Projects

Recommend Topics

Recommend Org