pyinfra

<p align="center"> <a href="https://pyinfra.com"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/2a29ff87-b4ae-47c0-9c3b-b8d9cf874013.png" alt="pyinfra" /> </a> </p> <p> pyinfra将Python代码转换为shell命令并在您的服务器上运行。执行临时命令并编写声明式操作。目标可以是SSH服务器、本地机器和Docker容器。快速且可扩展，从一台服务器到数千台服务器。可以将其视为类似<code>ansible</code>，但使用Python而不是YAML，并且速度更快。 </p>

---

<h3> <a href="https://docs.pyinfra.com/page/getting-started.html"><strong>入门指南</strong></a> &bull; <a href="https://github.com/pyinfra-dev/pyinfra-examples"><strong>示例仓库</strong></a> &bull; <a href="https://matrix.to/#/#pyinfra:matrix.org"><strong>Matrix聊天</strong></a> </h3> <p> <a href="https://docs.pyinfra.com"><strong>文档</strong></a> &bull; <a href="https://docs.pyinfra.com/page/support.html"><strong>帮助与支持</strong></a> &bull; <a href="https://docs.pyinfra.com/page/contributing.html"><strong>贡献</strong></a> </p>

---

为什么选择pyinfra？设计特点包括：

• 🚀 在数千台主机上执行超快速，性能可预测。
• 🚨 通过实时stdin/stdout/stderr输出实现即时调试（-vvv）。
• 🔄 支持差异比较和干运行的幂等操作，在进行更改前先预览。
• 📦 可通过整个Python包生态系统进行扩展。
• 💻 对任何具有shell访问权限的目标进行无代理执行。
• 🔌 与Docker、Terraform、Vagrant等连接器集成。

<img width="100%" src="https://yellow-cdn.veclightyear.com/835a84d5/f8910fdf-1ae2-405a-9cb7-7b9b89b0c689.gif" />

快速入门

使用pip安装pyinfra：

pip install pyinfra

现在您可以通过SSH在主机上执行命令：

pyinfra my-server.net exec -- echo "hello world"

或针对Docker容器、本地机器和其他连接器：

pyinfra @docker/ubuntu exec -- echo "Hello world"
pyinfra @local exec -- echo "Hello world"

除了执行命令，您还可以使用操作定义状态：

# 如果iftop apt包不存在则安装
pyinfra @docker/ubuntu apt.packages iftop update=true _sudo=true

这些操作可以保存为Python文件，如deploy.py：

from pyinfra.operations import apt

apt.packages(
    name="确保安装iftop",
    packages=['iftop'],
    update=True,
    _sudo=True,
)

主机也可以保存在一个文件中，例如inventory.py：

targets = ["@docker/ubuntu", "my-test-server.net"]

然后一起执行：

pyinfra inventory.py deploy.py

现在您已经了解了pyinfra的基本构建块！通过组合清单、操作和Python代码，您可以部署任何东西。

查看更详细的入门指南或使用操作指南。了解如何使用清单和数据、全局参数和命令行界面，或查看文档示例。

---

<p align="center"> <a href="https://pypi.python.org/pypi/pyinfra"><img alt="PyPI版本" src="https://img.shields.io/pypi/v/pyinfra?color=blue"></a> <a href="https://pepy.tech/project/pyinfra"><img alt="PyPi下载量" src="https://pepy.tech/badge/pyinfra"></a> <a href="https://docs.pyinfra.com"><img alt="文档状态" src="https://img.shields.io/github/actions/workflow/status/Fizzadar/pyinfra/docs.yml?branch=2.x"></a> <a href="https://github.com/Fizzadar/pyinfra/actions?query=workflow%3A%22Execute+tests%22"><img alt="执行测试状态" src="https://img.shields.io/github/actions/workflow/status/Fizzadar/pyinfra/test.yml?branch=2.x"></a> <a href="https://codecov.io/github/Fizzadar/pyinfra"><img alt="Codecov覆盖率" src="https://img.shields.io/codecov/c/gh/Fizzadar/pyinfra"></a> <a href="https://github.com/Fizzadar/pyinfra/blob/2.x/LICENSE.md"><img alt="MIT许可" src="https://img.shields.io/pypi/l/pyinfra"></a> </p>