shellphish/mechaphish

CGC云环境设置

注意：本仓库仅用于历史存档。Mechanical Phish曾是优秀的软件，在CGC及其他竞赛中部署使用，但自2016年起未再维护，已过时且被其他内部和公开原型替代。请勿就本仓库相关内容联系任何人。Mechanical Phish的独立组件（如REX、PATCHEREX及angr本身）仍在各自仓库中维护。

本仓库包含用于管理CGC云服务器配置的脚本和数据。

使用本仓库

1. 获取Ansible（执行pip install -r requirements.txt）
2. 克隆本仓库。
3. 构建或下载roles/crs/vm/files/cgc-vm.qcow2中的VM镜像（参见kubernetes/tester-qemu-docker）。
4. 运行ansible-playbook。

剧本（Playbooks）

• 安装设置
  在CGC节点上安装并运行Kubernetes：

  bash
  ansible-playbook -i inventory/mechaphish/hosts setup.yml -b
  

  这将设置用户、安装依赖并启动新的Kubernetes实例。

• 拆除清理
  使用teardown.yml剧本停止Kubernetes并将节点重置为原始状态：

  bash
  ansible-playbook -i inventory/mechaphish/hosts teardown.yml -b
  

• 虚拟竞赛

  bash
  ansible-playbook -i inventory/mechaphish/hosts setup-virtualcompetition.yml -b
  

• 注册中心

  bash
  ansible-playbook -i inventory/mechaphish/hosts setup-registry.yml -b
  

直接运行命令

您也可以直接使用ansible命令在远程主机上执行任务：

bash
ansible all -i inventory/mechaphish/hosts -a "uptime"

添加-vvvv（或--verbose）可获取详细调试信息。

仓库结构

setup.yml、teardown.yml等

顶层Ansible剧本。

roles/

应用特定配置。

inventory/

主机或主机组特定配置。CGC节点按不同集合分组。主清单位于inventory/NAME/hosts，主机和组变量文件位于inventory/NAME/{host,group}_vars。

kubernetes/

Kubernetes镜像的Dockerfile和复制控制器设置。

tools/

• crs：启动/停止crs的便捷脚本
• powercontrol.py：简易IPMI工具
• virtualcompetition：启动/停止虚拟竞赛
• update-vm-image：将最新组件安装到DECREE VM镜像中，需满足：

  bash
  pip install paramiko stopit
  apt-get --no-install-recommends install qemu-kvm
  adduser gitlab-runner kvm
  

sshp/

用于sshp的主机列表（需安装https://www.npmjs.com/package/sshp%EF%BC%89%EF%BC%9A

bash
sshp -f sshp/ips.txt uptime

CGC云服务器

https://docs.google.com/spreadsheets/d/1merG8nu291re7AyIhTZdZP4NNU7wPd4RcnNRLsHsSwI/edit?usp=sharing