p> p> p> p> p> p> pr:link
您听说过Github行动,对吗?如果您没有在此link中利用并探索有关它的文档。
并利用从此功能中执行项目不同动作的实用性,我们创建了一个github动作功能来自动化机器人的更新,称为botcity Action,您可以在此repository中找到它。<<<<<<<<<<<<<<<<<<<<< /p>
为什么要使用botcity动作?
每当我们可以自动化一个过程以使我们的日常生活更轻松时,学习如何做并理解它在我们的背景和需求中是否有意义都是有意义的。因此,假设您有一个持续的机器人开发过程。为什么不让您的日常生活更易于管理,并超越业务和产品流程以外的自动化:您的发行版的部署和更新?
Botcity动作如何工作?
我们的功能无需手动实现即可自动执行更新,部署和发布给我们的编排者Botcity Maestro。另外,如果您需要熟悉Botcity Maestro API以更好地使用,请在此link上咨询我们的文档。
在您的项目中应用botcity行动
按照以下分步。在示例中,我们正在考虑使用Python语言构建的项目。但是,请随意使用其他语言。我们的documentation包含用于在Java,JavaScript和Typescript中配置项目的示例。
[0]配置您的项目
作为第一步,您需要在项目中添加一个文件夹结构。在项目的根部创建一个具有确切名称.github
的文件夹。在该文件夹中,使用特定名称workflows
创建另一个文件夹。
此规范直接来自GitHub,这就是它将解释功能的位置。要进一步澄清,请记住咨询documentation。
[1]创建第一个工作流程
在这一点上,我们假设您已经开发了机器人。但是,如果您需要帮助,请在我们的文档中查看此link。我们有一个非常有趣的教程,讲述了如何使用我们的开源框架创建机器人。
仍然,我们指出,您可以使用与我们的编目中其他技术构建的机器人,例如Java,JavaScript,Selenium和Bash脚本等。
我们在行动中可以考虑的事件之一就是推动main
分支。这意味着每当main
分支发生更改时,您都希望将新的部署到Botcity Maestro来更新机器人。如果您正在考虑使用GIT流量规则和最佳实践,则可以使用这样的工作,而main
分支是生产分支。
在此步骤中,我们将在Workflows文件夹中创建update_bot.yml
文件。您应该添加下面的代码以考虑到main
分支上的PUSH事件中所述的更改:
name: Update the latest version bot on BotCity Maestro.
on:
push:
branches:
- main
[2]通过Botcity Action函数生成机器人
要知道您需要添加到功能中,也有必要了解部署机器人所需的内容。
例如,考虑到您使用我们的开源框架开发自动化,我们需要完成以下先决条件:生成带有bot代码和依赖项的zipped文件,我们可以通过执行脚本:./build.sh
来创建该文件。或./build.bat
,具体取决于操作系统。该脚本位于项目的根部,该脚本是根据我们的desktop或web框架模板构建的。
因此,我们需要在我们的功能中添加以下操作:
- 在环境中运行(在这种情况下,由于ubuntu的宽松和速度,我们选择了ubuntu,但是,您可以分析您的特定情况,并了解是否有必要的依赖性,并在必要时在Windows中运行或MacOS环境,例如);
- 允许执行
build.sh
文件; - 运行
./build.sh
命令。 有了这些新操作,我们的update_bot.yml
文件将看起来像这样:
name: Update the latest version bot on BotCity Maestro.
on:
push:
branches:
- main
jobs:
update-latest:
name: Update the latest version bot on BotCity Maestro.
# Running the latest version of Ubuntu.
runs-on: ubuntu-latest
steps:
# Checking out the project.
- uses: actions/checkout@v3
# Implemented executable permission to `.sh`
- name: Get permission to build.
run: chmod +x build.sh
# Execute to build.
- name: Execute to build.
run: ./build.sh
[3]使用该功能
到目前为止,我们添加到update_bot.yml
文件中的一系列步骤是定义一个环境来构建并创建我们将在Maestro上传的zipped文件。但是,现在我们需要配置使用该函数的步骤。
在这种情况下,我们添加了一些重要的数据以成功部署。它们是机器人,技术(您必须在其中通知机器人中使用的语言,在我们的示例中,我们考虑使用python)和botpath(位于项目根部的位置,将zippled文件上传到我们的Quptestrator - S平台)。
name: Update the latest version bot on BotCity Maestro.
on:
push:
branches:
- main
jobs:
update-latest:
name: Update the latest version bot on BotCity Maestro.
# Running the latest version of Ubuntu.
runs-on: ubuntu-latest
steps:
# Checking out the project.
- uses: actions/checkout@v3
# Implemented executable permission to `.sh`
- name: Get permission to build.
run: chmod +x build.sh
# Execute to build.
- name: Execute to build.
run: ./build.sh
- name: Using a Botcity action.
# Using the v1.0.0 version of botcity-action-bots
uses: botcity-dev/botcity-action-bots@v1.0.0
with:
# Use the update function.
update: true
# Bot Id in Maestro.
botId: 'example'
# Technology utilized in bot
technology: 'python'
# Path from the root of the project where the generated .zip/.jar will be.
botPath: './bot.zip'
env:
# These secrets must be configured in your repository.
LOGIN: ${{ secrets.LOGIN }}
SERVER: ${{ secrets.SERVER }}
KEY: ${{ secrets.KEY }}
请注意,我们添加了一些环境变量,例如登录,服务器和密钥。这些是您能够使用Botcity Maestro的重要秘诀。因此,请记住在您的存储库中安全地设置这些键。
在哪里可以找到更多提示?
您可以访问我们在documentation中创建的指南,并提供有关使用Botcity操作的更多提示和指南,包括创建发行版等。
另外,请记住加入我们的community,分享您的开源项目并与他人回答您的问题。从您的经验中学习会很令人兴奋。