https://github.com/kaweees/ansible
My ansible playbook collection that has been written for setting up a Debian 12 (bookworm) Linux machine
https://github.com/kaweees/ansible
ansible ansible-galaxy ansible-playbook ansible-role debian
Last synced: 2 months ago
JSON representation
My ansible playbook collection that has been written for setting up a Debian 12 (bookworm) Linux machine
- Host: GitHub
- URL: https://github.com/kaweees/ansible
- Owner: Kaweees
- License: gpl-3.0
- Created: 2023-05-18T20:54:45.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-06-21T14:51:53.000Z (about 2 years ago)
- Last Synced: 2024-06-22T07:24:53.654Z (about 2 years ago)
- Topics: ansible, ansible-galaxy, ansible-playbook, ansible-role, debian
- Language: Shell
- Homepage: https://miguelvf.dev/blog/ansible
- Size: 438 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
~ansible
This playbook installs most of the software I use on my Linux machine for software development. This is a work-in-progress, and things will probably change as the sands of time flow.
### Built With
[![Ansible][Ansible-shield]][Ansble-url]
## Getting Started
To get a local copy of the project up and running on your machine, follow these simple steps:
### Installation
It is best to run this playbook remotely, as it is designed to be executed on a fresh install of Linux. To do so, run the following commands:
1. Add your user to the sudoers group
```bash
# execute the following commands from root
apt install -y sudo curl
sudo usermod -aG sudo
```
2. Execute the ansible-install script
```bash
bash < <(curl -s https://raw.githubusercontent.com/Kaweees/ansible/main/ansible-install)
```
3. Start and enable NetworkManager
```bash
sudo systemctl start NetworkManager #.service
sudo systemctl enable NetworkManager #.service
```
Enter your machine's password when prompted by Ansible.
## Usage
### Running
### Testing
Testing this playbook locally can be done by following the steps below:
1. Clone the repository
```bash
git clone https://github.com/Kaweees/ansible.git
cd ansible
```
2. Install Ansible via pip
```bash
pip install ansible
```
3. Install Molecule with Docker support via pip
```bash
pip install molecule[docker]
```
4. Initialize a Molecule scenario locally with Docker as the driver
```bash
molecule init scenario -r local -d docker
```
5. Run the Molecule tests with the initialized scenario
```bash
molecule test
```
## Roadmap
See the [open issues](
## Project Structure
```
. ansible/
├── .ssh/ - ssh configuration files
├── auth_codes/ - auth codes for various services
├── meta/ - metadata regarding this project for Ansible Galaxy
├── molecule/ - molecule tests
│ └── default/ - default molecule scenario
│ ├── converge.yml - main ansible playbook
│ ├── molecule.yml - molecule configuration
│ └── verify.yml - molecule verification
├── tasks/ - various ansible tasks
├── vars/ - various ansible variables
├── .ansible-lint - ansible-lint configuration
├── .editorconfig - editorconfig configuration
├── .yamllint - yamllint configuration
├── Dockerfile - dockerfile for molecule tests
├── README.md - you are here
├── ansible-install - entry point that install ansible and runs the playbook
├── local.yml - ansible playbook to run locally
└── nvim.Dockerfile - dockerfile for neovim
```
## License
My ansible scripts are distributed under the terms of the GNU General Public License v3.0, as I firmly believe that collaborating on free and open-source software fosters innovations that mutually and equitably beneficial to both collaborators and users alike. See [LICENSE](LICENSE) for details and more information.
[contributors-shield]: https://img.shields.io/github/contributors/Kaweees/ansible.svg?style=for-the-badge
[contributors-url]: https://github.com/Kaweees/ansible/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/Kaweees/ansible.svg?style=for-the-badge
[forks-url]: https://github.com/Kaweees/ansible/network/members
[stars-shield]: https://img.shields.io/github/stars/Kaweees/ansible.svg?style=for-the-badge
[stars-url]: https://github.com/Kaweees/ansible/stargazers
[Ansible-shield]: https://img.shields.io/badge/ansible-%231A1918.svg?style=for-the-badge&logo=ansible&logoColor=FFFFFF&labelColor=222222&color=FFFFFF
[Ansble-url]: https://www.ansble.com