palazzem / hanzo Goto Github PK

View Code? Open in Web Editor NEW

23.0 3.0 5.0 400 KB

Ansible orchestration to configure a development environment -

Home Page: http://hanzo.sh

License: Other

Shell 85.46% Dockerfile 5.72% Jinja 8.82%

ansible ansible-playbook devops-tools devtools devenv

hanzo's Introduction

Hanzō

Hattori Hanzō: You must have big rats if you need Hattori Hanzo's steel. The Bride: ...Huge.

This Ansible playbook configures a new ArchLinux installation with some development tools. The goal of the playbook is inspiring developers to prepare programmatically their development environment. This repository targets my requirements and it's very unlikely it can be used in a general purpose sense.

Quickstart

If you like living on the bleeding edge and curlbombs don't scare you, the automatic installer is the easiest way to configure your system:

    $ sh <(curl -L http://j.mp/hattori-hanzo)

A clean ArchLinux installation is recommended but not required. Anyway, bear in mind it WILL OVERWRITE ENTIRELY your system.

If you use this approach, nothing else is required and you can enjoy your new system!

Manual Installation

In case you don't want to use the curl command above, you can clone or download this repository, using either git or the release page. After the checkout, run the following commands:

    $ cd hanzo/
    $ HANZO_FOLDER=$(pwd) bash bin/bootstrap.sh

Unattended Installer

If you don't want to use the interactive shell to configure Hanzo, you can set the following environment variables:

HANZO_FOLDER: if specified, that folder is used as Hanzo root. If not specified, the bootstrap script fetches Hanzo from GitHub.
HANZO_FULLNAME: your full name used in the .gitconfig.
HANZO_EMAIL: your email address used in the .gitconfig.
HANZO_USERNAME: username used to create the main user.
TAGS: sets Ansible tags. Available options are [chromeos]. If not tags are set, a standard Archlinux toolbox is configured.
EXTRA_ARGS: sets Ansible extra arguments. Use this variable if you want to set options such as --verbose or --check.

Testing

If you want to apply the playbook changes without touching your current configuration, or you want to test any change of the current configuration, a Dockerfile is available to build an ArchLinux container. To start the provisioning, just:

    $ docker build -t hanzo:test . \
        --build-arg HANZO_FULLNAME=test \
        --build-arg HANZO_USERNAME=test \
        --build-arg [email protected] \
        && docker rmi hanzo:test

Contribute

The playbook provisions a machine with my current configuration. Because it's unlikely that you use exactly my current environment, you may use this repository as a base to create your own configuration. Indeed, I'll be glad to accept any PR that:

Fixes the current playbook execution
Improves the playbook styles or Ansible best practices
Enhances or makes me aware of different methods to distribute the playbook

I will not accept any PR that adds new development tools, but I will be grateful if you can discuss about it in the issue tracker.

hanzo's People

Contributors

Stargazers

Watchers

Forkers

vladdancer devangpaliwal 0x6b386f baod-rate

hanzo's Issues

Find a better way to get IDE and framework versions instead of hardcoding them on group_var

without the right fonts, browsers pages rendering is a bit weird

this could be fixed installing ttf-ms-fonts from AUR repositories

update project tree according to latest Ansible best practices

using vim as default editor requires a better integration with the system clipboard

use gnome-terminal instead of Terminator

gnome-terminal ensures a terminal with True Color compatibility (24-bit colors)

add "ionic" installation to development role

provide a valid .xinitrc so the desktop environment will start after login

Python 3 libraries missing

Add python3-dev package

Provide a default XInput configuration that prevents annoying behaviors

For instance, the click event on touchpad double-tap

Postgresql users doesn't accept md5 auth on local

change pg_hba.conf to md5 instead of ident

missing Windows filesystem tools

Install:

dosfstools
ntfsprogs

vagrant-libvirt
vagrant-lxc

update & reboot instruction before everything
git clone https instead of git (it requires authentication)
pip install ansible==1.1

Add postgresql devel package

Package: libpq-dev

the window manager choice should be more generic and easy to extend

Use the desktop variable for a conditional import
Write an awesome.yml file that includes all awesome customizations

create the folder $HOME/.config/nvim/
create the nvimrc symlink into $HOME/.config/nvim/init.vim

add pythonz with the following zshrc improvement

if [[ -s $HOME/.pythonz/etc/bashrc ]]
then
    source $HOME/.pythonz/etc/bashrc
    PATH=$PATH:$(pythonz list -p | awk 'BEGIN {ORS=":"} /^ / {print $2"/bin"}')
fi

(it's just an example)

provide a role that updates all dot and config files

Dot and config files (such as .vimrc and rc.lua and so on) should be provided in this repository as a separated role so other devices may update their config files using a simple Ansible tag

missing ntpd daemon

Ansible role should achieve the following steps:

pacman -S ntp
systemctl enable ntpd
systemctl start ntpd (optional)

add docker machine and swarm for server management

ZSH configuration file

Install oh-my-zsh
Copy configuration file