🖥️ Personal Ubuntu Machine Setup with Ansible and Dotfiles

This repository contains an Ansible playbook for setting up my personal Ubuntu machine, complete with my preferred dotfiles. The playbook automates the process of setting up my machine, making it easy to get started with a fresh Ubuntu installation or to reset an existing system.

🚀 Quick Start

To set up my personal Ubuntu machine, follow these steps:

1. Run setup.sh to install Ansible and its dependencies.
2. Run generate_ssh_github.sh to generate an SSH key and add it to my GitHub account.
3. Run download_appimages.sh to download and configure necessary AppImages.

Note: Change GTK theme to Arc-Dark using gnome-tweaks.

🐳 Local Testing with Docker

I can test the Ansible playbook locally using Docker. This allows me to ensure that my playbook is working correctly before deploying it to my Ubuntu machine.

🏗️ Building the Docker Image

Build the Docker image with the following command:

docker build -t ansible-build -f Dockerfile .

If I need to build the image without using cache, I can use the --no-cache flag:

docker build -t ansible-build -f Dockerfile . --no-cache

🏃 Running the Docker Container

Run the Docker container in interactive mode with this command:

docker run -it ansible-build

This will allow me to explore the container and verify that the Ansible playbook has been applied correctly.

📝 Ansible Usage Examples

Decrypting a file with Ansible Vault

To decrypt a file that has been encrypted with Ansible Vault, use the following command:

ansible-vault decrypt generate_ssh_github.sh

You will be prompted for the vault password. After providing the correct password, the file generate_ssh_github.sh will be decrypted.

🗂️ Repository Structure

• entrypoint.sh: Script that serves as the starting point for the Docker container.
• generate_ssh_github.sh: Script to generate an SSH key and add it to GitHub.
• setup.sh: Bash script to install Ansible and its dependencies on Ubuntu.
• download_appimages.sh: Script to download and configure AppImages.
• main.yml: Main Ansible playbook that automates the setup of the Ubuntu machine.
• README.md: Documentation for the repository.
• Dockerfile: Dockerfile for building a Docker image of the setup.
• secrets.yml: Encrypted file containing sensitive information, managed with Ansible Vault.

📝 Note

This repository is tailored to my personal preferences and is not intended for general use.