termenv

Configuration of terminal environment with ansible playbook.

The configuration contains very basic setup with:

• zsh
• oh-my-zsh
• PowerLevel10k
• zsh-dircolors-solarized
• zsh-autosuggestions
• zsh-syntax-highlighting
• tmux with Powerline theme.
• fzf with fzf ohmyz plugin
• neovim with couple of handy plugins inspired by bcampolo/nvim-starter-kit
• nerd-fonts
• cspell

Inspired also by:

• Terminal History Auto Suggestions As You Type With Oh My Zsh

Neovim Cheat Sheet

This is very basic cheat sheet to get you started. For all mappings see the configuration files.

Key	Command	Key	Command
<C-h>	Jump to left window	<Space>	<leader>
<C-l>	Jump to right window	<leader>wq	Save and quit
<C-j>	Jump down	<leader>qq	Quite without saving
<C-k>	Jump up	<leader>ww	Save
<leader>sv	Split window vertically	<leader>ee	Toggle file explorer
<leader>sh	Split window horizontally	<leader>ff	Find file
<leader>sx	Close split window	<leader>fg	Life grep
:Git	Git with Fugitive	:Neogit	Git with Neogit
<leader>al	Git log	<leader>ar	Git log for selection
<leader>af	Git log for file	<leader>gb	Git blame (inline)
<leader>ha	Add file to quick list	<leader>hh	Show file quick list
<leader>h<1-9]	Jump to file from quick list
<leader>gg	Show definition	<leader>gD	Jump to declaration
<leader>gd	Jump to definition	<leader>gi	Jump to implementation
<C-Space>	Completition	<leader>fw	Grep word under cursor
:Copilot setup	Configure Copilot	:Copilot enable	Enable Copilot
:CopilotChat	Open Copilot chat window
<C-J>	Accept Copilot suggestion

Prerequisites

The ansible script performs package installations. The user under which you execute the script needs to be in sudoers.

Fedora

sudo dnf install git ansible

Ubuntu

sudo apt-get update
sudo apt-get install git ansible

Install

git clone https://github.com/jazik/termenv.git
cd termenv
ansible-playbook -i hosts --ask-become-pass termenv.yml

Customization

All the roles are run by default. If you wish to install only some of the roles or skip some roles, use ansible tags, which are defined in termenv.yml.

For example to skip tmux run:

ansible-playbook -i hosts termenv.yml --skip-tags tmux

Or to install only tmux run:

ansible-playbook -i hosts termenv.yml --tags tmux

Fonts

The nerd-fonts tag installs latest version of Fira Mono Nerd Fonts.

If you are installing the playbook in a remote system, container or in a virtual machine, then note that the terminal will not display patched fonts unless you install the fonts in your local system. For how to configure your terminal to use the fonts see your terminal documentation.

You can also use the playbook to install any other Nerd Font, just pass the name as an option:

ansible-playbook -i hosts nerdfonts.yml -e "font_name=YourFontName"

The YourFontName should be the name of the Nerd Font zip file without .zip. You can find it by checking the download link from Nerd Fonts Downloads.

Neovim Copilot plugins

The Copilot and CopilotChat neovim plugins can be installed separately. This is to avoid spurious errors from the plugins when Copilot is not configured and used.

To install the plugins run:

ansible-playbook -i hosts neovim-copilot.yml

Sample screen shots

Testing playbooks

Docker/Podman/Moby

If you would like to see how the environment looks or you would like to experiment with the configuration, there is a Dockerfile in the project repo to create the environment quickly:

For environment on Fedora:

docker build -t termenv . --build-arg DISTRO=fedora

Or for Ubuntu:

docker build -t termenv . --build-arg DISTRO=ubuntu

Then run the container:

docker run --rm -it termenv

The playbooks are mounted from current directory. If you want to mount the plaoybooks when running the container, you can use -v option:

docker run --rm -it -v .:/home/termenv/termenv:Z termenv

With Vagrant

In order to run local tests install vagrant with both libvirt and VirtualBox providers. Check your host system distro guidelines how to install those.

In fedora you can run following. Note that in order to install VirtualBox you will have to enable RPMFusion.

sudo dnf install vagrant vagrant-libvirt VirtualBox libvirt
sudo usermod -a -G libvirt ${USER}

When using fedora ensure that nfs is enabled in libvirt firewall zone:

sudo systemctl --now enable virtnetworkd.service
sudo firewall-cmd --permanent --zone=libvirt --add-service=nfs
sudo firewall-cmd --reload

To test the playbook and configuration there is Vagrantfile with two predefined configurations. One for fedora and one for ubuntu. There are also couple of custom options to run local tests or to have envs for manual testing.

vagrant [--local=no|yes] [--do-install=yes|no] <command> [fedora|ubuntu]

--local
   Run playbook from Github (no, default) or from local current
   directory (yes)

--do-install
   Install dependencies and run playbook (yes, default) or skip
   installation (no) and just start machine for manual testing

<command>
   vagrant commands such as up, destroy, ssh etc

fedora|ubuntu
   Linux distro to deploy, if none is selected both are created

For example to run playbook for fedora from local repo:

vagrant --local=yes up fedora
vagrant ssh fedora
vagrant destroy fedora

The tests are not automated, nothing is really checked after playbook is executed. But provisioning of machine will fail if playbook fails. The configuration have to be then checked manually by ssh-ing to the machine and looking around.