Skip to content

Latest commit

 

History

History
70 lines (51 loc) · 1.79 KB

README.md

File metadata and controls

70 lines (51 loc) · 1.79 KB
Raw

Kirk's Automated Linux Environment (KALE)

An ansible playbook designed to automate install of my (Kirk's) linux environment in Ubuntu.

About The Project

This repository originally a series of bash scripts to be used on an installation of Ubuntu server 21.10. But the scripts were fragile and had to be manually tested to ensure correctness. Ansible is the sensible alternative to this approach, so the scripts were rewritten for Ansible.

Getting Started

As stated above, this repository is intended to be used on an installation of Ubuntu server 21.10. It will likely work for other versions of Ubuntu, and other Debian based distributions. But there is no guarantee that it will work.

This repository was designed to be used with ansible-pull, and has not been tested with any other Ansible commands.

Prerequisites

The only prerequisite is Ansible.

# debian
sudo apt install ansible
# arch
sudo pacman -Sy ansible
# macos
brew install ansible

Installation

Clone the repo, check out the main branch, and run the install script.

./install.sh

Usage

There are future plans to add a detailed guide on how to use the environment post-installation. The only advice I have now is to read the configs and figure it out yourself.

Roadmap

  • Bootstrap necessary installations in install.sh
    • brew (if on mac)
    • ansible (package manager independent)
  • Add support for multiple linux distributions
    • Fedora
    • openSuse
    • Debian
  • Add support for macos
  • Implement molecule for testing the bootstrap playbook
  • Add flags for enabling features (for personal and testing usages)