Esempi Pyinfra - Cronologia

Maintenance script: Aggiunta

2026-03-29T19:21:07Z

Aggiunta

Maintenance script: Espansione esempi Pyinfra con casi base e avanzati

2026-03-29T18:55:31Z

Espansione esempi Pyinfra con casi base e avanzati

← Versione meno recente		Versione delle 18:55, 29 mar 2026
Riga 14:		Riga 14:
	== Esempio base 1: esecuzione su host locali ==		== Esempio base 1: esecuzione su host locali ==
	Se vuoi solo capire la CLI:		Se vuoi solo capire la CLI:
	<~~syntaxhighlight lang="bash"~~>		<pre>
	pyinfra @local exec -- echo "hello world"		pyinfra @local exec -- echo "hello world"
	</~~syntaxhighlight~~>		</pre>

	Questo serve quando vuoi verificare:		Questo serve quando vuoi verificare:
Riga 24:		Riga 24:

	== Esempio base 2: inventory minimale ==		== Esempio base 2: inventory minimale ==
	<~~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>

	Qui hai solo una lista di host.		Qui hai solo una lista di host.

	== Esempio base 3: operation semplice ==		== Esempio base 3: operation semplice ==
	<~~syntaxhighlight lang="python"~~>		<pre>
	from pyinfra.operations import server		from pyinfra.operations import server

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

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

	== Esempio base 4: installare pacchetti ==		== Esempio base 4: installare pacchetti ==
	<~~syntaxhighlight lang="python"~~>		<pre>
	from pyinfra.operations import apt		from pyinfra.operations import apt

Riga 57:		Riga 57:
	update=True,		update=True,
	)		)
	</~~syntaxhighlight~~>		</pre>

	Questo e un esempio di operation idempotente: se i pacchetti sono gia presenti, pyinfra non rifara cambiamenti inutili.		Questo e un esempio di operation idempotente: se i pacchetti sono gia presenti, pyinfra non rifara cambiamenti inutili.

	== Esempio base 5: gestire file ==		== Esempio base 5: gestire file ==
	<~~syntaxhighlight lang="python"~~>		<pre>
	from pyinfra.operations import files		from pyinfra.operations import files

Riga 72:		Riga 72:
	mode="644",		mode="644",
	)		)
	</~~syntaxhighlight~~>		</pre>

	== Esempio base 6: gestire servizi ==		== Esempio base 6: gestire servizi ==
	<~~syntaxhighlight lang="python"~~>		<pre>
	from pyinfra.operations import systemd		from pyinfra.operations import systemd

Riga 84:		Riga 84:
	enabled=True,		enabled=True,
	)		)
	</~~syntaxhighlight~~>		</pre>

	== Esempio intermedio 1: dati host ==		== Esempio intermedio 1: dati host ==
	Inventory:		Inventory:
	<~~syntaxhighlight lang="python"~~>		<pre>
	app_servers = [		app_servers = [
	("app-01.example.net", {"install_nginx": True}),		("app-01.example.net", {"install_nginx": True}),
	("app-02.example.net", {"install_nginx": False}),		("app-02.example.net", {"install_nginx": False}),
	]		]
	</~~syntaxhighlight~~>		</pre>

	Deploy:		Deploy:
	<~~syntaxhighlight lang="python"~~>		<pre>
	from pyinfra import host		from pyinfra import host
	from pyinfra.operations import apt		from pyinfra.operations import apt
Riga 106:		Riga 106:
	update=True,		update=True,
	)		)
	</~~syntaxhighlight~~>		</pre>

	Qui usi Python per rendere il deploy diverso in base ai dati del target.		Qui usi Python per rendere il deploy diverso in base ai dati del target.

	== Esempio intermedio 2: gruppi ==		== Esempio intermedio 2: gruppi ==
	<~~syntaxhighlight lang="python"~~>		<pre>
	from pyinfra import host, local		from pyinfra import host, local
	from pyinfra.operations import server		from pyinfra.operations import server
Riga 125:		Riga 125:
	commands=["hostname"],		commands=["hostname"],
	)		)
	</~~syntaxhighlight~~>		</pre>

	Questo pattern e utile quando vuoi dividere la logica in file piu piccoli.		Questo pattern e utile quando vuoi dividere la logica in file piu piccoli.
Riga 132:		Riga 132:
	Questo e il pattern usato nel progetto Proxmox Web UI: pyinfra gira su <code>@local</code> ma esegue un helper esterno che contiene la logica vera.		Questo e il pattern usato nel progetto Proxmox Web UI: pyinfra gira su <code>@local</code> ma esegue un helper esterno che contiene la logica vera.

	<~~syntaxhighlight lang="python"~~>		<pre>
	#!/usr/bin/env python3		#!/usr/bin/env python3
	import os		import os
Riga 149:		Riga 149:
	commands=[cmd],		commands=[cmd],
	)		)
	</~~syntaxhighlight~~>		</pre>

	Idea pratica:		Idea pratica:
Riga 180:		Riga 180:

	== Esempio dry run ==		== Esempio dry run ==
	<~~syntaxhighlight lang="bash"~~>		<pre>
	pyinfra inventory.py deploy.py --dry		pyinfra inventory.py deploy.py --dry
	</~~syntaxhighlight~~>		</pre>

	Utile prima di un deploy reale.		Utile prima di un deploy reale.

Maintenance script: Espansione esempi Pyinfra con casi base e avanzati

2026-03-29T18:51:29Z

Espansione esempi Pyinfra con casi base e avanzati

Mostra modifiche

Admin: Creazione pagina informativa su pyinfra

2026-03-28T23:06:21Z

Creazione pagina informativa su pyinfra

Nuova pagina

= Esempi Pyinfra =

Pagina operativa con esempi minimi e riusabili per iniziare a usare '''pyinfra'''.

== Struttura minima ==
Esempio di file:
<pre>
inventory.py
deploy.py
</pre>

== Inventory semplice ==
<pre>
web_servers = [
"web-01.example.net",
"web-02.example.net",
]

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

== Deploy semplice ==
<pre>
from pyinfra.operations import apt, server

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

server.shell(
name="Show uptime",
commands=["uptime"],
)
</pre>

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

== Esempio con gruppi ==
<pre>
from pyinfra import host, local
from pyinfra.operations import server

if 'web_servers' in host.groups:
local.include('tasks/web.py')

if 'db_servers' in host.groups:
local.include('tasks/database.py')

server.shell(
name="Run everywhere",
commands=["hostname"],
)
</pre>

== Esempio con dati host ==
Inventory:
<pre>
app_servers = [
("app-01.example.net", {"install_nginx": True}),
("app-02.example.net", {"install_nginx": False}),
]
</pre>

Deploy:
<pre>
from pyinfra import host
from pyinfra.operations import apt

if host.data.get("install_nginx"):
apt.packages(
name="Install nginx",
packages=["nginx"],
update=True,
)
</pre>

== Esempio local machine ==
<pre>
pyinfra @local exec -- echo "hello world"
</pre>

== Esempio su container Docker ==
<pre>
pyinfra @docker/ubuntu:22.04 exec -- uname -a
</pre>

== Esempio installazione file ==
<pre>
from pyinfra.operations import files

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

== Esempio service management ==
<pre>
from pyinfra.operations import systemd

systemd.service(
name="Ensure nginx is running",
service="nginx",
running=True,
enabled=True,
)
</pre>

== Esempio dry-run ==
<pre>
pyinfra inventory.py deploy.py --dry
</pre>

== Note pratiche ==
* tenere `inventory.py` e `deploy.py` in Git
* usare `host.data` per differenziare host simili
* separare task complessi in file inclusi
* usare `--dry` prima dei deploy reali

== Link ufficiali ==
* [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/examples/groups_roles.html Groups & Roles]
* [https://docs.pyinfra.com/en/3.x/using-operations.html Using Operations]