mirror of
https://github.com/fscotto/infra.git
synced 2026-05-30 15:39:58 +00:00
Align docs with current playbook layout
This commit is contained in:
@@ -156,7 +156,7 @@ Use the narrowest command matching the changed area.
|
|||||||
- `profile_workstation_dev_common` carries the Ubuntu dev layer shared by native workstation and WSL Ubuntu
|
- `profile_workstation_dev_common` carries the Ubuntu dev layer shared by native workstation and WSL Ubuntu
|
||||||
- `profile_workstation_gnome` carries Linux host-only GNOME setup, extensions, and UFW
|
- `profile_workstation_gnome` carries Linux host-only GNOME setup, extensions, and UFW
|
||||||
- `profile_workstation_dev_wsl` carries WSL-specific Ubuntu tweaks such as `systemd` and PSRP Python dependencies
|
- `profile_workstation_dev_wsl` carries WSL-specific Ubuntu tweaks such as `systemd` and PSRP Python dependencies
|
||||||
- `profile_workstation_host_windows` manages the Windows 11 host via PSRP over HTTPS using `negotiate` by default and installs host applications via `winget`
|
- `profile_workstation_host_windows` manages the Windows 11 host via PSRP over HTTPS using `negotiate` by default, installs host applications via `winget`, applies Windows shell tweaks, and sets Windows Terminal's default profile to Ubuntu
|
||||||
- `deadalus-wsl` is modeled as a local inventory target intended to be run from inside the Ubuntu WSL distro
|
- `deadalus-wsl` is modeled as a local inventory target intended to be run from inside the Ubuntu WSL distro
|
||||||
- Future Windows taskbar pinning work should be done from a real Windows session after discovering installed app identifiers on that host, then applied via a Windows 11 taskbar layout policy with `PinListPlacement="Replace"`
|
- Future Windows taskbar pinning work should be done from a real Windows session after discovering installed app identifiers on that host, then applied via a Windows 11 taskbar layout policy with `PinListPlacement="Replace"`
|
||||||
- Do not auto-restart `emptty` during playbook runs on active desktop hosts; prefer a manual restart from SSH or another TTY after the run
|
- Do not auto-restart `emptty` during playbook runs on active desktop hosts; prefer a manual restart from SSH or another TTY after the run
|
||||||
@@ -172,6 +172,12 @@ ansible-playbook ansible/site.yml --syntax-check
|
|||||||
|
|
||||||
Run a host-limited dry run whenever the change affects a real host profile, package set, service set, session, PAM stack, templates, or dotfiles.
|
Run a host-limited dry run whenever the change affects a real host profile, package set, service set, session, PAM stack, templates, or dotfiles.
|
||||||
|
|
||||||
|
For workstation changes, prefer:
|
||||||
|
```bash
|
||||||
|
ansible-playbook ansible/site.yml --limit deadalus --check --diff
|
||||||
|
ansible-playbook ansible/site.yml --limit deadalus-wsl --check --diff
|
||||||
|
```
|
||||||
|
|
||||||
If you touched `scripts/bootstrap_mail.sh`, also run:
|
If you touched `scripts/bootstrap_mail.sh`, also run:
|
||||||
```bash
|
```bash
|
||||||
sh -n scripts/bootstrap_mail.sh
|
sh -n scripts/bootstrap_mail.sh
|
||||||
|
|||||||
20
README.md
20
README.md
@@ -57,7 +57,7 @@ Nota sullo stato attuale del playbook principale:
|
|||||||
|
|
||||||
- `ansible/site.yml` applica oggi in automatico il profilo desktop su host Void Linux
|
- `ansible/site.yml` applica oggi in automatico il profilo desktop su host Void Linux
|
||||||
- `ansible/site.yml` applica la workstation Linux nativa separando il layer dev comune dal layer host GNOME
|
- `ansible/site.yml` applica la workstation Linux nativa separando il layer dev comune dal layer host GNOME
|
||||||
- `ansible/site.yml` prepara anche il ramo `windows_workstation_host` + `workstation_dev_wsl` per il modello Windows + WSL
|
- `ansible/site.yml` applica anche il ramo `workstation_host_windows` + `workstation_dev_wsl` per il modello Windows 11 + WSL
|
||||||
- `ansible/site.yml` applica anche il profilo `ubuntu_server` con baseline apt, systemd, dotfiles server e firewall UFW
|
- `ansible/site.yml` applica anche il profilo `ubuntu_server` con baseline apt, systemd, dotfiles server e firewall UFW
|
||||||
|
|
||||||
## Desktop
|
## Desktop
|
||||||
@@ -105,7 +105,7 @@ Desktop environment host Linux:
|
|||||||
Macchine attuali:
|
Macchine attuali:
|
||||||
|
|
||||||
- `deadalus` come workstation Ubuntu nativa
|
- `deadalus` come workstation Ubuntu nativa
|
||||||
- supporto strutturale preparato per futuri host Windows + WSL
|
- supporto attivo per host Windows 11 + WSL tramite `deadalus-win` e `deadalus-wsl`
|
||||||
|
|
||||||
Questo profilo è pensato per sviluppo e lavoro, con separazione tra layer host e layer dev.
|
Questo profilo è pensato per sviluppo e lavoro, con separazione tra layer host e layer dev.
|
||||||
|
|
||||||
@@ -122,7 +122,7 @@ Lo stato attuale del profilo workstation include:
|
|||||||
- installazione e configurazione di Docker dal repository ufficiale
|
- installazione e configurazione di Docker dal repository ufficiale
|
||||||
- gestione dei dotfiles workstation e rendering dei template dev condivisi
|
- gestione dei dotfiles workstation e rendering dei template dev condivisi
|
||||||
- installazione di Google Chrome, pacchetti Snap workstation e estensioni GNOME sul solo host Linux nativo
|
- installazione di Google Chrome, pacchetti Snap workstation e estensioni GNOME sul solo host Linux nativo
|
||||||
- preparazione del ramo Windows host con app installate dal playbook via `winget`
|
- configurazione del ramo Windows 11 host con app installate dal playbook via `winget`, tema scuro, taskbar ripulita e profilo predefinito di Windows Terminal impostato su `Ubuntu`
|
||||||
- preparazione del ramo WSL Ubuntu con `systemd` per il toolchain di sviluppo
|
- preparazione del ramo WSL Ubuntu con `systemd` per il toolchain di sviluppo
|
||||||
- attivazione del firewall UFW sul solo host Linux nativo
|
- attivazione del firewall UFW sul solo host Linux nativo
|
||||||
|
|
||||||
@@ -250,7 +250,7 @@ I principali ruoli attualmente presenti sono:
|
|||||||
| profile_workstation_dev_common | configurazione dev Ubuntu condivisa |
|
| profile_workstation_dev_common | configurazione dev Ubuntu condivisa |
|
||||||
| profile_workstation_gnome | configurazione host workstation GNOME |
|
| profile_workstation_gnome | configurazione host workstation GNOME |
|
||||||
| profile_workstation_dev_wsl | configurazione WSL Ubuntu per sviluppo |
|
| profile_workstation_dev_wsl | configurazione WSL Ubuntu per sviluppo |
|
||||||
| profile_workstation_host_windows | configurazione host Windows workstation |
|
| profile_workstation_host_windows | configurazione host Windows 11 workstation |
|
||||||
| profile_server | configurazione server |
|
| profile_server | configurazione server |
|
||||||
| dotfiles_common | distribuzione dotfiles comuni |
|
| dotfiles_common | distribuzione dotfiles comuni |
|
||||||
| dotfiles | distribuzione configurazioni utente |
|
| dotfiles | distribuzione configurazioni utente |
|
||||||
@@ -311,14 +311,14 @@ Per utilizzare il repository sono necessari:
|
|||||||
- `ansible-lint`
|
- `ansible-lint`
|
||||||
- `yamllint`
|
- `yamllint`
|
||||||
- `shellcheck`
|
- `shellcheck`
|
||||||
- collection `community.general`
|
- collection definite in `ansible/collections/requirements.yml`
|
||||||
- accesso locale o SSH alle macchine target, in base a come e definito l'inventory
|
- accesso locale o SSH alle macchine target, in base a come e definito l'inventory
|
||||||
|
|
||||||
Installazione base:
|
Installazione base:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3 -m pip install ansible ansible-lint yamllint shellcheck-py
|
python3 -m pip install ansible ansible-lint yamllint shellcheck-py
|
||||||
ansible-galaxy collection install community.general
|
ansible-galaxy collection install -r ansible/collections/requirements.yml
|
||||||
```
|
```
|
||||||
|
|
||||||
Gestione segreti:
|
Gestione segreti:
|
||||||
@@ -343,7 +343,10 @@ Allo stato attuale questo comando:
|
|||||||
|
|
||||||
- distribuisce i dotfiles comuni a tutti gli host
|
- distribuisce i dotfiles comuni a tutti gli host
|
||||||
- per gli host Void applica bootstrap desktop condiviso, sessioni i3/Sway/Hyprland e override specifici per host
|
- per gli host Void applica bootstrap desktop condiviso, sessioni i3/Sway/Hyprland e override specifici per host
|
||||||
- per gli host `ubuntu_workstation` applica pacchetti Ubuntu, servizi systemd, profilo workstation GNOME, UFW, dotfiles, Snap e template dedicati
|
- per `workstation_dev_ubuntu` applica pacchetti Ubuntu, servizi systemd e profilo dev comune
|
||||||
|
- per `workstation_host_linux` applica il layer host Linux GNOME
|
||||||
|
- per `workstation_dev_wsl` applica pacchetti Ubuntu, servizi systemd, profilo dev comune e tweak WSL dedicati
|
||||||
|
- per `workstation_host_windows` applica il layer host Windows 11 via PSRP
|
||||||
- per gli host `ubuntu_server` applica pacchetti Ubuntu, servizi systemd, profilo server, UFW, dotfiles e template dedicati
|
- per gli host `ubuntu_server` applica pacchetti Ubuntu, servizi systemd, profilo server, UFW, dotfiles e template dedicati
|
||||||
- non riavvia automaticamente `emptty`; le modifiche al display manager vanno applicate manualmente da SSH o da una TTY separata
|
- non riavvia automaticamente `emptty`; le modifiche al display manager vanno applicate manualmente da SSH o da una TTY separata
|
||||||
- carica `secrets/vault.yml` solo se presente
|
- carica `secrets/vault.yml` solo se presente
|
||||||
@@ -356,6 +359,7 @@ ansible-playbook ansible/site.yml --syntax-check
|
|||||||
ansible-playbook ansible/site.yml --limit ikaros --check --diff
|
ansible-playbook ansible/site.yml --limit ikaros --check --diff
|
||||||
ansible-playbook ansible/site.yml --limit nymph --check --diff
|
ansible-playbook ansible/site.yml --limit nymph --check --diff
|
||||||
ansible-playbook ansible/site.yml --limit deadalus --check --diff
|
ansible-playbook ansible/site.yml --limit deadalus --check --diff
|
||||||
|
ansible-playbook ansible/site.yml --limit deadalus-wsl --check --diff
|
||||||
ansible-playbook ansible/site.yml --limit prometheus --check --diff
|
ansible-playbook ansible/site.yml --limit prometheus --check --diff
|
||||||
ansible-lint ansible/site.yml
|
ansible-lint ansible/site.yml
|
||||||
ansible-lint ansible/roles
|
ansible-lint ansible/roles
|
||||||
@@ -393,7 +397,7 @@ Una nuova macchina può essere inizializzata con i seguenti passaggi:
|
|||||||
```bash
|
```bash
|
||||||
git clone <repo>
|
git clone <repo>
|
||||||
cd <repo-dir>
|
cd <repo-dir>
|
||||||
ansible-galaxy collection install community.general
|
ansible-galaxy collection install -r ansible/collections/requirements.yml
|
||||||
ansible-playbook ansible/site.yml
|
ansible-playbook ansible/site.yml
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user