Add Proxmox networking

1 files changed, 27 insertions, 0 deletions

diff --git a/personal_infra/README.md b/personal_infra/README.md
index 9d466890..0cd32d5e 100644
--- a/personal_infra/README.md
+++ b/personal_infra/README.md
@@ -4,3 +4,30 @@ This is a collection of files I use setting up my personal infrastructure.
 This is a work in progress, as I am redoing a bit how I do configuration management.
 The main source is in a private repo, but I put here as much material as I can make public.
 Inventory, vaults, etc. remain in the private repo.
+
+## Ansible
+
+### Initial setup
+
+Symlink everything in this directory into your root infrastructure directory.
+
+Create an `inventory` file.
+
+Run `./setup_venv` to create a virtual environment.
+
+Create `vault_password` with a vault password.
+
+### Usage
+
+Run `. .venv/bin/activate` to activate the virtual environment.
+
+Run Ansible commands normally.
+
+## Ansible/Puppet integration
+
+I prefer using Ansible for orchestration, and Puppet for configuration management.
+
+`playbooks/apply_puppet.yml` runs Puppet using Ansible.
+The `puppet` directory contains Puppet manifests.
+
+The playbook adds the Ansible inventory to Puppet using Hiera.