Actionsflow介绍 - 可以一键部署在Github上的IFTTT/Zapier的开源替代

2021-02-02T00:00:00+00:00

我还记得当年第一次使用IFTTT</a>的时候的那种兴奋，天呐，这才是互联网！从那时起，就一直使用 IFTTT 到今天，真的很棒的一个产品！直到 IFTTT 最近宣布要收费，我就在想有没有合适的开源方案可以替代，因为托管方案肯定没戏了，连 10 年都免费的 IFTTT 都开始收费了，其他的只会更贵，结果发现主流的开源替代方案，比如 huginn, n8n, node-red 好像又有点重，不够轻量，而且扩展起来也不容易。</p> </span>

刚好在那时看到 Github 的 Actions</a>支持 Schedule</a>事件，而 Github 的 Actions 又是对开源项目免费使用，所以就萌生了利用 Github Actions 的定时运行来检测更新，并执行指定动作。所以一个新的轮子 Actionsflow</a> 来了！</p>

开始 🔗</a></h2>

使用这个链接</a>用 Actionsflow 的默认模板创建一个新的 GitHub 项目，一个典型的 Actionsflow 项目长这样：</p>

├──</span> .github
</span>│</span>   └── workflows
</span>│</span>       └── actionsflow.yml
</span>├──</span> .gitignore
</span>├──</span> README.md
</span>└──</span> workflows
</span>│</span>   └── rss.yml
</span>│</span>   └── webhook.yml
</span>└──</span> package.json
</span></code></pre>
</li>

取消 .github/workflows/actionsflow.yml</code> 文件里schedule</code>的注释</p>
</li>

在workflows/</code>文件夹创建你自己的 workflow 文件</p>
</li>

保存并提交你的文件到 Github</p>
</li>
</ol>
配置🔗</a></h2>
我对 Actionsflow 的设计原则是规则尽可能简单，并且可扩展，workflow 的配置规则直接采用 Github Actions 的配置格式</a>，如果你之前有用过 Github Actions 的话，应该立刻就能懂 Actionsflow 的全部配置规则：</p>
on</span>:
</span>  </span>rss</span>:
</span>    </span>url</span>: </span>https://hnrss.org/newest?points=300
</span>    </span>config</span>:
</span>    	</span>limit</span>: </span>10
</span>jobs</span>:
</span>  </span>request</span>:
</span>    </span>name</span>: </span>Make a HTTP Request
</span>    </span>runs-on</span>: </span>ubuntu-latest
</span>    </span>steps</span>:
</span>      - </span>name</span>: </span>Make a HTTP Request
</span>        </span>uses</span>: </span>actionsflow/axios@v1
</span>        </span>with</span>:
</span>          </span>url</span>: </span>https://hookb.in/VGPzxoWbdjtE22bwznzE
</span>          </span>method</span>: </span>POST
</span>          </span>body</span>: </span>|
</span>            {
</span>              "link":"${{ on.rss.outputs.link }}",
</span>              "title": "${{ on.rss.outputs.title }}",
</span>              "content":"<<<${{ on.rss.outputs.contentSnippet }}>>>"
</span>            }
</span></code></pre>
和原生的 Github Actions 的配置相比，Actionsflow 只是扩展了on</code>的事件，在 Actionsflow 里，我把它叫做trigger</code>， RSS trigger</a>经常被用来做示例使用，你可以点击[这里](Actionsflow Triggers | Actionsflow Documentation</a>)查看目前 Actionsflow 支持的所有 trigger. Trigger 里有个特殊的参数是config</code>,这个 config 是通用参数，也就是所有的 trigger 都支持 config 参数，config 实现了很多通用的功能的，比如设置过滤条件，设置过滤条数，格式化输出结果，设置触发时间等等，点击[这里](Workflow Syntax for Actionsflow | Actionsflow Documentation</a>可以查看所有支持的配置。</p>
其他的就和 Github Actions 的配置一样了，你可以在 jobs 里配置任何复杂的任务，或者简单的发个请求，你可以用 ${{ on.rss.outputs.<key> }}</code>来使用 trigger 的结果，每个 trigger 的结果的 key 需要去看对应 trigger 的文档。</p>
我在这里</a>列出了你可能会用到的 Github Action，同时新建了一个Awesome 项目</a>列出一些常用的 Actionsflow 工作流。</p>
Webhook🔗</a></h2>
Actionsflow 不仅支持定时抓取类的任务，同时还支持 Webhook 类的任务，这样第三方服务如果有任何更新就可以主动通知 Actionsflow 了。这里 Webhook 机制是利用 Github 可以接收外界的 repository_dispatch</code></a> 事件来触发 Action 运行来实现的，具体使用可以见这里</a></p>
本地运行🔗</a></h2>
大多数情况下，使用 Github Actions 运行 Actionsflow 是更方便，也是推荐的使用方式，但是可能出于某种原因你需要在本地或者你自己的 VPS 上部署 Actionsflow. 要在本地运行 Actionsflow，必须先安装Docker</a></p>
然后只需要运行:</p>
docker</span> run</span> -it -v</span> /var/run/docker.sock:/var/run/docker.sock</span> -v </span>${</span>PWD</span>}:/data</span> -p</span> 3000:3000 actionsflow/actionsflow
</span></code></pre>
手动运行方式见这里</a></p>

Owen的博客 - Workflows

Actionsflow介绍 - 可以一键部署在Github上的IFTTT/Zapier的开源替代