Pyinfra - Cronologia

Maintenance script: Espansione

2026-03-29T19:21:07Z

Espansione

← Versione meno recente		Versione delle 19:21, 29 mar 2026
Riga 68:		Riga 68:
	* [[Confronto Ansible vs Pyinfra]]: confronto generale di approccio.		* [[Confronto Ansible vs Pyinfra]]: confronto generale di approccio.
	* [[Installazione Pyinfra su Fedora]]: installazione CLI in ambiente Fedora.		* [[Installazione Pyinfra su Fedora]]: installazione CLI in ambiente Fedora.

			== Domanda pratica tipica ==
			Se devi controllare 10 server:
			* sul '''manager''' installi <code>pyinfra</code>, tieni inventory e deploy e da li lanci i job
			* sui '''10 server target''' non installi <code>pyinfra</code>, ma devi avere accesso SSH e permessi adeguati

			La spiegazione completa con esempi e nella pagina:
			* [[Esempi Pyinfra]]

	== Esempio minimo per capire la sintassi ==		== Esempio minimo per capire la sintassi ==

Maintenance script: Fix

2026-03-29T18:56:31Z

Fix

← Versione meno recente		Versione delle 18:56, 29 mar 2026
Riga 63:		Riga 63:

	== Mappa delle pagine ==		== Mappa delle pagine ==
	* [[Esempi Pyinfra]]		* [[Esempi Pyinfra]]: guida pratica con esempi base e avanzati di pyinfra.
	~~Guida~~ pratica con esempi base e avanzati di pyinfra.		* [[Pyinfra/Deploy automatico VM Proxmox]]: runbook umano della web UI pubblicata su bot.gazzi.net.
	* [[Pyinfra/Deploy automatico VM Proxmox]]		* [[Pyinfra/Implementazione deploy VM linea per linea]]: spiegazione tecnica del codice che realizza il deploy automatico di VM.
	~~Runbook~~ umano della web UI pubblicata su bot.gazzi.net.		* [[Confronto Ansible vs Pyinfra]]: confronto generale di approccio.
	* [[Pyinfra/Implementazione deploy VM linea per linea]]		* [[Installazione Pyinfra su Fedora]]: installazione CLI in ambiente Fedora.
	~~Spiegazione~~ tecnica del codice che realizza il deploy automatico di VM.
	* [[Confronto Ansible vs Pyinfra]]
	~~Confronto~~ generale di approccio.
	* [[Installazione Pyinfra su Fedora]]
	~~Installazione~~ CLI in ambiente Fedora.

	== Esempio minimo per capire la sintassi ==		== Esempio minimo per capire la sintassi ==

Maintenance script: Espansione pagina Pyinfra con struttura umana e link di approfondimento

2026-03-29T18:55:30Z

Espansione pagina Pyinfra con struttura umana e link di approfondimento

← Versione meno recente		Versione delle 18:55, 29 mar 2026
Riga 76:		Riga 76:
	== Esempio minimo per capire la sintassi ==		== Esempio minimo per capire la sintassi ==
	Inventory:		Inventory:
	<~~syntaxhighlight lang="python"~~>		<pre>
	web_servers = [		web_servers = [
	"web-01.example.net",		"web-01.example.net",
	"web-02.example.net",		"web-02.example.net",
	]		]
	</~~syntaxhighlight~~>		</pre>

	Deploy:		Deploy:
	<~~syntaxhighlight lang="python"~~>		<pre>
	from pyinfra.operations import server		from pyinfra.operations import server

Riga 91:		Riga 91:
	commands=["uptime"],		commands=["uptime"],
	)		)
	</~~syntaxhighlight~~>		</pre>

	Esecuzione:		Esecuzione:
	<~~syntaxhighlight lang="bash"~~>		<pre>
	pyinfra inventory.py deploy.py		pyinfra inventory.py deploy.py
	</~~syntaxhighlight~~>		</pre>

	== Idea chiave ==		== Idea chiave ==

Maintenance script: Espansione pagina Pyinfra con struttura umana e link di approfondimento

2026-03-29T18:51:29Z

Espansione pagina Pyinfra con struttura umana e link di approfondimento

Mostra modifiche

Maintenance script: Aggiornamento

2026-03-29T18:43:35Z

Aggiornamento

Mostra modifiche

Admin: Creazione pagina introduttiva su pyinfra con esempi e link ufficiali

2026-03-28T23:04:49Z

Creazione pagina introduttiva su pyinfra con esempi e link ufficiali

Nuova pagina

= Pyinfra =

'''Pyinfra''' e uno strumento open source di automazione e deploy infrastrutturale scritto in Python. Può essere usato sia per comandi ad-hoc sia per deploy ripetibili definiti in file Python versionabili in Git.

== Concetto base ==
Pyinfra lavora con due elementi principali:
* '''Inventory''': host, gruppi e dati associati agli host.
* '''Operations''': stato desiderato o comandi da applicare ai target.

L'approccio e vicino ad Ansible sul piano operativo, ma invece di descrivere i deploy soprattutto in YAML, pyinfra usa Python.

== Come funziona ==
Secondo la documentazione ufficiale, l'esecuzione avviene in cinque fasi:
# lettura di inventory e data
# connessione ai target
# preparazione con rilevamento cambiamenti e ordine operazioni
# esecuzione delle modifiche
# disconnessione e cleanup

Un punto importante e che pyinfra prepara prima l'ordine delle operazioni e poi le esegue. Questo permette di mantenere l'ordine logico delle operazioni, eseguendo ogni singola operation in parallelo sui target rilevanti.

== Inventory ==
Un inventory pyinfra contiene:
* host
* gruppi
* dati di gruppo
* dati per singolo host

Esempio minimale:
<pre>
web_servers = [
"web-01.example.net",
"web-02.example.net",
]

db_servers = [
("db-01.example.net", {"install_postgres": True}),
]
</pre>

I dati associati agli host o ai gruppi possono essere usati nel deploy Python tramite `host.data`.

== Operations ==
Le operations descrivono cosa deve essere vero sul sistema target. In molti casi non rappresentano un'azione imperativa ma uno '''stato desiderato'''.

Esempio:
<pre>
from pyinfra.operations import apt, files

apt.packages(
name="Install vim",
packages=["vim"],
update=True,
)

files.file(
name="Ensure log file exists",
path="/var/log/app.log",
user="app",
group="app",
mode="644",
)
</pre>

Se il target e gia nello stato richiesto, pyinfra non applica cambiamenti ulteriori.

== Comandi ad-hoc ==
Pyinfra puo essere usato anche direttamente da CLI senza creare un deploy completo.

Esempi:
<pre>
pyinfra @local exec -- echo "hello world"
pyinfra my-server.net exec -- uptime
pyinfra @docker/ubuntu:22.04 exec -- uname -a
</pre>

== Esempio base di deploy ==
Inventory:
<pre>
my_hosts = [
("ubuntu2204", {
"ssh_port": 2222,
"ssh_hostname": "localhost",
"ssh_user": "vagrant",
"_sudo": True,
}),
"my-server.net",
]
</pre>

Deploy:
<pre>
from pyinfra.operations import apt

apt.packages(
name="Ensure vim is installed",
packages=["vim"],
update=True,
)
</pre>

Esecuzione:
<pre>
pyinfra inventory.py deploy.py
</pre>

== Differenze pratiche rispetto ad Ansible ==
* usa '''Python''' invece di fare affidamento principalmente su YAML
* e comodo per chi vuole logica, condizioni e riuso direttamente nel linguaggio
* mantiene il modello inventory + operazioni + stato desiderato
* puo essere piu naturale per team che preferiscono automazione programmabile piuttosto che playbook dichiarativi

== Quando ha senso usarlo ==
* homelab e server Linux
* provisioning e configurazioni ripetibili
* deploy gestiti in Git
* ambienti dove Python e gia parte del flusso operativo

== Limiti da tenere presenti ==
* richiede maggiore familiarita con Python rispetto a strumenti piu dichiarativi
* alcuni team preferiscono YAML per leggibilita immediata lato operations
* va progettato con attenzione quando la logica dipende da fatti che possono cambiare durante il deploy

== Installazione ==
Secondo la documentazione ufficiale, il metodo consigliato e:
<pre>
uv tool install pyinfra
pyinfra --version
</pre>

Alternative supportate: `pipx` oppure `pip` in virtual environment.

== Link ufficiali ==
* [https://pyinfra.com/ Sito ufficiale]
* [https://docs.pyinfra.com/en/3.x/ Documentazione]
* [https://docs.pyinfra.com/en/3.x/getting-started.html Getting Started]
* [https://docs.pyinfra.com/en/3.x/inventory-data.html Inventory & Data]
* [https://docs.pyinfra.com/en/3.x/using-operations.html Using Operations]
* [https://docs.pyinfra.com/en/3.x/deploy-process.html How pyinfra Works]