使用GAMS引擎和GitHub Actions进行自动 GAMS模型测试

软件开发很依赖自动化和持续集成(CI)以确保在开发过程的早期发现错误。Jenkins是一个被大量采用的开源自动化服务器,并且是GAMS每天都使用的工具之一。借助GitLab CI/CD和GitHub Actions,两大存储平台近年来也加入了自己的持续集成产品。对于GAMS模型的开发人员来说,Jenkins 、GitHub和GitLab的CI功能并不便于使用,因为构建构成很难与可用于运行测试代码的GAMS安装进行通信。

 

现在我们的新产品GAMS引擎改变了这种情况。对于那些还不知道的人,GAMS Engine提供了一个REST API,可用于将GAMS作业提交和运行到一个中心位置。

 

下面我们将概述GitHub上GAMS模型开发人员 如何轻松使用Engine为其模型运行自动化测试。同样的原则也适用于GitLab和Jenkins。

 

一个GitHub示例

先决条件包括:

  • 包含GAMS模型代码的GitHub存储库。

  • 访问GAMS引擎实例的凭据。

 

它是如何完成的

“GitHub Actions”背后的概念很简单。简而言之:

代码存储中发生的事件(例如推送新提交)都可触发工作流。

工作流包含一个或多个作业,这些在称为运行器的计算资源上执行。作业中发生的全部事情都在同一个运行器上按吮吸运行,默认情况下,多个作业在多个运行器上同时运行。您可以选择基于Linux、Windows或Mac OS 的运行器。GitHub提供了向单慷慨的运行时间配额,对于大多数项目来说应该足够了。

 

每个作业都包含了一个或多个步骤。典型的步骤可以是“将新版本从存储库签出到运行器”、“编辑源代码”、“将某些东西部署到服务器”等等。

 

每一步骤都调用动作或执行shell命令。行动是实际做某事的事情。

 

如何使用GitHub操作?

要定义工作流程,您可以在.GitHub/workflows/源存储库中创建一个YAML文件。将新提交推送到存储库时,将运行以下工作流。它检查对新运行程序的新提交,准备模型以提交给GAMS Engine,然后在Engine上以编译模式运行模型:

 

关于可以传递给“运行作业”操作的参数,应该解释一些事情:

你可以看到我们使用了一些形式的变量${{ secrets.xyz }}。这些变量可以以加密形式存储在模型存储库中。您需要将这些秘密设置为指向URL您选择的引擎实例的,并同时提供USER和PASSWORD。

后一行中使用的${{ github.workspace }}变量包含运行器内部的路径,您的代码在作业中通过“checkout”操作签出。

该参数a=c导致模型由GAMS工作者便于,但不执行。这足以捕获语法错误,并确保工作流程能够快速完成。

一旦将此工作流文件添加到存储库并对其进行修改以适合您的模型,每次推送到存储库都会触发模型在Engine上的运行。如果模型编译失败,运行将失败并发送电子通知邮件。

 

查看GAMS软件详情

热门产品

2022-02-07 10:37
首页    技术文档    使用GAMS引擎和GitHub Actions进行自动 GAMS模型测试