https://github.com/pythoninthegrass/ansible_meetup
https://github.com/pythoninthegrass/ansible_meetup
Last synced: 7 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/pythoninthegrass/ansible_meetup
- Owner: pythoninthegrass
- License: unlicense
- Created: 2024-09-24T06:29:21.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-07T23:30:50.000Z (11 months ago)
- Last Synced: 2025-05-07T05:09:42.468Z (9 months ago)
- Language: Shell
- Size: 365 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ansible_meetup
## Minimum Requirements
* macOS/Linux
* [Homebrew](https://brew.sh)
* Tart
* Ansible
## Recommended Requirements
* Devbox
## Quickstart
### Environment
Create the virtual environment and install the requirements.
```bash
python3 -m venv .venv
python3 -m pip install --upgrade pip
python3 -m pip install -r requirements.txt
```
Activate the virtual environment.
```bash
# activate
source .venv/bin/activate
# exit
# deactivate
```
### Ansible
Install third-party roles.
```bash
cd ./ansible
ansible-galaxy install -r requirements.yml
```
Copy the `ansible.cfg.example` file to `ansible.cfg`.
```bash
# change any settings as needed
cp ansible.cfg.example ansible.cfg
```
Edit the `hosts` file to include the IP address of the target machine.
```bash
[servers]
192.168.105.5 ansible_user=admin
```
Run a quick smoke test.
```bash
# ping the target machine
ansible -m ping 192.168.105.5
# ping a group of machines
ansible -m ping servers
# ping all machines
ansible -m ping all
```
> [!NOTE]
> `ansible` is an "agentless" configuration management tool.
>
> This means that you do not need to install any software on the target machine.
>
> However, you do need to have SSH access to the target machine.
Once the machine is reachable over SSH, run the `main.yml` file:
```bash
ansible-navigator run tasks/main.yml --limit 'servers' -v
```
This will execute these tasks sequentially:
* `pkg.yml`
* `git.yml`
* `pull-repos.yml`
* `gum.yml`
* `docker.yml`
* `wallpaper.yml`
Shout-out to @schultzie for convincing me to switch to `ansible-navigator`!
## Dev
```bash
# install tart
brew install cirruslabs/cli/tart
# tart commands
tart clone
tart run
tart list
tart stop
tart delete
# start macos guest (manual)
tart clone ghcr.io/cirruslabs/macos-sonoma-base:latest sonoma-base
tart set sonoma-base --disk-size 40
tart run sonoma-base
ssh-copy-id admin@$(tart ip sonoma-base)
ssh admin@$(tart ip sonoma-base)
# vagrant via task (automatic)
# * macos, ubuntu, fedora are supported
task vagrant:plugin
task vagrant:up -- macos
task vagrant:ssh -- macos
task vagrant:halt -- macos
task vagrant:destroy -- macos
task vagrant:validate -- macos
```
## TODO
* Ansible
* ~~Install~~
* ~~Setup~~
* Playbooks
* Pare down to useful examples for short demo
* Ideas
* kind cluster
* cron job
* dev environment
* wallpaper
* Vagrant
* Use provisioning with ansible to install minimum requirements in each vm
* Tart
* Orchard
* Orchestrate VMs
* Snapshots?
* Packer
* Build custom images (e.g., Fedora 40, Ubuntu 24.04)
* Test
* gum install on fedora and ubuntu
* Run on fresh Mac (remember devbox ðŸ˜)
## Further Reading
* [Using Ansible playbooks — Ansible Community Documentation](https://docs.ansible.com/ansible/latest/playbook_guide/index.html)
* [Ansible Navigator Documentation](https://ansible.readthedocs.io/projects/navigator/)
* [4 things to know about programming using Ansible | Enable Sysadmin](https://www.redhat.com/sysadmin/ansible-coding-programming)
* [General tips — Ansible Community Documentation](https://docs.ansible.com/ansible/latest/tips_tricks/ansible_tips_tricks.html)
* [geerlingguy/mac-dev-playbook: Mac setup and configuration via Ansible.](https://github.com/geerlingguy/mac-dev-playbook)
* [Allaman/mac-setup: My Ansible Playbook to configure my MacBook](https://github.com/Allaman/mac-setup)