dotfiles

⚠️ DISCLAIMER: This project is intentended to be a personal project to setup my personal computers.

• dotfiles
  • Running the playbooks
    • On Pop!_os
    • On MacOS
    • Manual steps
      • On MacOS
  • Development
    • Running the tests
  • Troubleshooting
    • Pop!_os
      • Could not import python modules: apt, apt_pkg. Please install python3-apt package.
      • ERROR! ansible-galaxy requires resolvelib<1.1.0,>=0.5.3
  • What this project does
    • Applications installed
    • Packages installed
    • Bash
    • Code Editors
    • Docker
    • Git
    • SSH
    • Terminal (emulators)

Running the playbooks

To execute playbook, you need to install ansible and its dependencies locally. To do that run the following commands:

On Pop!_os

sudo apt update && sudo apt upgrade -y
sudo apt install software-properties-common
sudo add-apt-repository --yes --update ppa:ansible/ansible
sudo apt install ansible -y

On MacOS

pip3 install ansible-core
ansible-galaxy collection install --requirements-file roles/requirements.yml --upgrade

After that, you can run the playbooks:

make run

Manual steps

On MacOS

• Iterm profile config needs to be imported manually.

  1. iTerm2 > Preferences > Profiles;
  2. Open the Other Actions... drop-down in the bottom left corner;
  3. Select Import JSON Profiles... from the list;
  4. Select the DenisCosta.json file;
  5. Select DenisCosta from the Profiles list;
  6. Set it as default in the same dropdown below.

• Iterm2 theme needs to be imported manually. Reference here.

  1. iTerm2 > Preferences > Profiles > Colors Tab;
  2. Open the Color Presets... drop-down in the bottom right corner;
  3. Select Import... from the list;
  4. Select the Dracula.itermcolors file;
  5. Select Dracula from Color Presets.

Look at Terminal role README for more information.

Development

Running the tests

There are make tasks to run lint and tests

make lint
make lint-fix
make test

Troubleshooting

Pop!_os

Could not import python modules: apt, apt_pkg. Please install python3-apt package.

In a new installation of Ansible a problem related to python3-apt can occour.

...
"msg": "Could not import python modules: apt, apt_pkg. Please install python3-apt package."
...

There are many sugestions listed on the internet, but the creation symlinks to the lib *.so solved the problem on Pop!_os.

cd /usr/lib/python3/dist-packages
sudo ln -s apt_pkg.cpython*.so apt_pkg.so
sudo ln -s apt_inst.cpython*.so apt_inst.so

ERROR! ansible-galaxy requires resolvelib<1.1.0,>=0.5.3

pip uninstall resolvelib
pip install resolvelib==1.0.1

What this project does

Applications installed

• Caffeine (MaCOS)
• Dash (MacOS)
• DBeaver
• docker-compose
• Docker
• Dropbox
• firefox
• Google Chrome
• iTerm2 (MacOS)
• Password Gorilla
• Slack
• Spotify
• Terminator (Linux)
• Visual Studio Code
• VLC
• Zeal (Linux)

Packages installed

• Ag (The Silver Searcher)
• asdf
• delta
• ffmpeg
• fzf
• Git
• GnuPG
• Homebrew (MacOS)
• htop
• jq
• Neovim
• ripgrep
• tig
• tree
• z

Bash

Look at bash README for more details.

Code Editors

Look at code editors README for more details.

Docker

Creates a Docker user group and adds the current user to it on Linux. This step is required to avoid use of sudo for every docker command you run.

Add also the command docker-full-clean that remove everything related to Docker. Like images, containers, cache, volumes, etc..

Git

Look at Git role README for more details.

SSH

Look at SSH role README for more details.

Terminal (emulators)

Look at Terminal role README for more details.