https://scs.buaa.edu.cn/doc/01_common/Recent content in 云平台使用手册 on 软院云平台文档Hugo -- gohugo.ioenhttps://scs.buaa.edu.cn/doc/01_common/expreiment_paas/Mon, 01 Jan 0001 00:00:00 +0000https://scs.buaa.edu.cn/doc/01_common/expreiment_paas/课程实验PaaS工作流使用介绍 # 为了进一步提升云平台资源对软件学院课程实验的服务能力，我们针对课程实验推出了“PaaS工作流”功能，借助该功能，你可以： 方便地查看学生提交的作业代码的实际运行效果。在教师或助教发布实验或作业后，可以为当前的实验或作业添加“工作流配置”。在该工作流配置中，可以设置学生提交的代码的编译和运行环境。这样当学生提交自己的代码后，可以触发工作流自动运行，学生、助教和教师可以直接看到提交的作业的最终效果。该功能 一方面，可以方便助教和教师检查作业； 另一方面，可以为所有学生提供统一的代码运行环境，防止出现因个人编程环境差异而带来的错误。 为参与实验的学生提供统一的实验环境。我们知道，在一项实验中，配置编程实验环境往往是非常头疼的。“PaaS工作流”可以帮助为每个学生一键生成独立的、相同的编程环境。比如： 在数据库课程中，可以一键为每个学生生成一个独立的MySQL数据库，学生可以连接到该数据库环境完成实验； 在系统编程中，可以一键为每个学生生成一个独立的Ubuntu环境，学生可以登录该环境熟悉LInux中的各种指令、学习使用GCC编译代码、学习使用GDB调试代码等。 下面，我们将通过两个具体的示例来展示上述两个功能的具体用法。 在配置和使用该功能前，请务必与我们事先取得联系，讨论资源使用量，以防止启动容器实例出错。 示例1：“走进软件”课程作业提交与展示 # 在“走进软件”课程中，最主要的作业提交形式是，学生提交一个包含若干HTML、CSS、JS文件的压缩包，已实现某种网页效果。 在传统情况下，教师或助教为了检查作业效果，需要挨个下载学生提交的压缩包，然后将其中的文件放到某个静态服务器下面运行和查看。借助“PaaS工作流”功能，这一过程可以变得非常简单和轻松。 下面详细介绍该示例功能的使用流程： 助教 / 教师配置学生提交的作业的运行环境 # 新建一项实验，并导航至详情页底部，点击“添加新的工作流配置” 按照下图所示选择工作流的类型和需要使用的工作流模板（即基础环境），基础环境请选择“静态网站（Nginx）”： 在选择完模板后，可以看到，剩余大多数选项已经被自动填充了，通常情况下不需要作出进一步更改： 随后，你可以配置哪些选项允许学生在提交作业的时候更改，一般情况下，这些选项保持默认即可： 点击“提交”后（该步骤因为涉及到资源分配之类的工作，可能耗时较长），就完成了一个新的工作流配置，即完成了对学生提交的作业的运行环境的“预设”。随后，学生就可以在该预设的运行环境上提交和运行作业了。 学生提交作业 # 学生进入实验的详情页，导航至最底部，即可看到刚刚教师创建的“作业提交与展示”的选项卡。点击该选项卡之下的“提交新的任务”按钮，即可在弹出的对话框中提交自己的作业： 由于教师在之前的配置中默认不允许学生在提交时不能进行任何修改，所以，弹出的对话框中，绝大部分选项都是默认的，无法修改。学生只需要选择自己的作业压缩包提交即可： 提交后，刷新当前页面，可以提交的代码已经开始进行编译构建和部署流程： 等待部署完成后，再次刷新页面，可以看到提交的源代码的部署结果： 在本例中，我们可以直接访问部署好的网站，看到提交的作业效果： 助教 / 教师查看作业 # 助教或教师可以在实验的详情页查看已经提交作业的学生的作业部署效果： 示例2：为学生部署MySQL实验环境 # 该示例展示如何为实验中的每位学生生成一个相互独立的MySQL实验环境。 助教或教师为学生部署MySQL实例 # 同样地，还是导航到实验的详情页底部： 注意，“工作流类型”需要选择“辅助实验环境”；工作流名称的填写没有明确的格式要求，主要用于标识和区分；基础环境请选择“MySQL 8”。 为了使学生能访问到为其创建的MySQL实例，需要为MySQL的root用户预设一个密码。 其他值保持默认，点击提交即可。 随后，我们可以在实验详情页查看为学生创建MySQL实例的进度： 等待一段时间后，可以看到，工作流基本执行完成，即已经为每位学生创建好了可以使用的独立的MySQL实例： 学生查看和使用MySQL实例 # 学生导航到实验详情页底部，可以看到一个名为“MySQL实验环境”的选项卡。在这个选项卡里，学生可以看到分配给他的MySQL实例的IP、端口号、登录用户名、登录密码等。 学生可以在校园网内使用任何工具连接该数据库进行实验。 总结 # 可以看到，PaaS工作流的实际功能强依赖于预设的实验环境模板。我们会不断添加和完善常用开发和运行环境模板，以提供更好的使用体验。 欢迎各位老师同学与我们联系，反馈自己的使用体验，或提出自己的使用诉求。让我们一起携手创建更好的软件学院云平台！https://scs.buaa.edu.cn/doc/01_common/paas/Mon, 01 Jan 0001 00:00:00 +0000https://scs.buaa.edu.cn/doc/01_common/paas/云平台PaaS工作流使用示例 # 软院云平台引入了PaaS工作流功能。你可以使用该功能编译构建并部署你的代码或者创建数据库等辅助开发环境。下面我们将通过一些具体的事例来演示如何使用该功能。 示例1：部署静态网站 # 准备好要部署的静态网站文件。在该示例中，文件树如下所示： . ├── assets │ ├── index-5ac61b88.js │ ├── index-fc5f319f.css │ └── vue-5532db34.svg ├── index.html └── vite.svg 将上述文件打包为压缩文件，格式为 zip、tar.gz 或 rar，例如 my-website.zip。 打开软院云平台，导航至“项目管理”部分： 你可以看到归属于你的一系列项目列表。其中，每个人都有一个默认的个人项目。点进去这个个人项目。 点击 “添加新的工作流” 在弹出的侧边框中，填写“工作流名称”， 并选择“静态网站（Nginx）”作为基础环境。 此时，我们可以看到，其余参数基本已经被默认填写，一般情况下，我们无需修改。 在“上传压缩包”中，上传我们在第2步准备好的要部署的网站文件。 最后，选择合适的资源池为我们部署的任务提供资源开销。（每位学生默认分配了 2核4G的资源，请谨慎合理分配使用）。 点击提交按钮。 随后，我们可以在工作流列表中看到刚刚部署的网站： 可以使用刷新按钮刷新列表显示的状态： 等待部署完成，且服务状态健康后，可以点击“查看详情”查看服务的具体内容。 可以在服务端口中，点击对应端口的入口，访问部署好的网站。 部署好的网站如下图所示。 示例2：部署 Ubuntu 学习测试环境 # 与示例1类似，有区别的是，需要选择“基础环境”为“Ubuntu 22.04”。并且，由于该模板不需要编译源代码，因此，我们不需要额外上传任何文件。https://scs.buaa.edu.cn/doc/01_common/virtual_machine_help/Mon, 01 Jan 0001 00:00:00 +0000https://scs.buaa.edu.cn/doc/01_common/virtual_machine_help/虚拟机使用说明 # 连接虚拟机 # Linux系统 # 首先从云平台中获取虚拟机的IP和登录名，之后即可在本地通过任意ssh客户端登录。 MacOS 使用系统自带的Terminal.app登录即可。 为了更好的使用体验，推荐使用 iterm2登录。 当然，你也可以使用 termius进行多个ssh连接的管理。 Linux 如果你是Linux Desktop用户，那么你肯定已经有了自己喜爱的终端模拟器，此处不再赘述。 Windows 一般来讲，Windows 10（及以上）自带的cmd.exe都自带ssh client，打开cmd后直接ssh foo@x.x.x.x即可登录。 为了更好的使用体验，推荐下载使用 Windows Terminal。 当然，你也可以使用 termius或者其他工具（如 Xshell等）进行多个ssh连接的管理。 校外访问 || 浏览器访问 联网 # Linux系统 # 可以依次尝试以下两种方式。 校园网登录脚本 # 这里推荐使用buaalogin（即 srun）。 2022年8月开始分配的虚拟机默认已经安装了buaalogin工具，可使用which buaalogin验证其是否存在，如果存在，则可以跳过此步骤。 下载并安装登录工具： sudo wget https://scs.buaa.edu.cn/scsos/tools/linux/buaalogin -O /usr/local/bin/buaalogin sudo chmod +x /usr/local/bin/buaalogin 配置校园网登录使用的用户名和密码： buaalogin config 登录校园网： buaalogin login 登出校园网： buaalogin logout wukuard 服务 # 鉴于校网络中心的某些限制，上述联网方式可能在某短时间内无法使用，这里特别给出软院信息化小组的基于 Wireguard的曲线救国方案。其本质上是将虚拟机加入一个 wireguard虚拟内网，然后覆盖默认路由指向一个可以联网的内网机器，从而实现虚拟机本身与互联网的联通。 2022年8月开始分配的虚拟机默认配置好了 wukuard服务，可使用systemctl status wukuard验证之，如果运行正常，则可跳过下述的各个步骤，直接进行最后的配置hostname即可。 请注意，以下步骤是针对Debian系发行版（包括Debian、Ubuntu等）给出的，其他发行版请自行对照着修改命令。 首先需要安装wireguard-tools（这里需要短暂联网，但完整整个步骤之后就不需要了）：https://scs.buaa.edu.cn/doc/01_common/paas_token/Mon, 01 Jan 0001 00:00:00 +0000https://scs.buaa.edu.cn/doc/01_common/paas_token/获取PaaS平台通用Token # 如下图所示，登录云平台后，进入“项目管理”界面，点击上方的“复制”按钮即可。