codebattle/app

Codebattle

![Build Status]([***]

Codebattle是一款由Hexlet社区开发的开源编程对战游戏。有关项目的更多详细信息，请参阅https://github.com/hexlet-codebattle/codebattle/wiki%E3%80%82%E6%88%91%E4%BB%AC%E9%9D%9E%E5%B8%B8%E6%AC%A2%E8%BF%8E%E6%82%A8https://github.com/hexlet-codebattle/codebattle/blob/master/CONTRIBUTING.md%E3%80%82%E5%BD%93%E5%89%8D%E7%89%88%E6%9C%AC%E7%9A%84%E5%BA%94%E7%94%A8%E5%8F%AF%E9%80%9A%E8%BF%87codebattle.hexlet.io%E8%AE%BF%E9%97%AE%E3%80%82%E6%82%A8%E5%8F%AF%E4%BB%A5%E9%80%9A%E8%BF%87https://github.com/hexlet-codebattle/codebattle/wiki/News-Feed%E5%85%B3%E6%B3%A8%E5%BC%80%E5%8F%91%E8%BF%9B%E7%A8%8B%E3%80%82

镜像概述和主要用途

Codebattle镜像提供了一个完整的编程对战游戏环境，允许用户在本地部署和运行该开源游戏平台。用户可通过该平台进行编程挑战、与其他玩家对战，并支持多种编程语言的代码检查和执行。

核心功能和特性

• 开源项目：完全开放源代码，支持社区贡献和定制
• 多语言支持：支持多种编程语言的代码检查和执行（如Elixir等）
• 本地部署：可通过Docker和Docker Compose在本地环境快速部署
• 测试功能：提供完整的测试框架，支持代码检查和功能测试
• 社区驱动：由Hexlet社区持续开发和维护，定期更新功能

使用场景和适用范围

• 编程爱好者：用于进行编程练习和挑战，提升编程技能
• 学习者：通过对战形式增强编程学习的趣味性和实践性
• 社区贡献者：参与开源项目开发，扩展游戏功能或修复问题
• 教育场景：作为编程教学辅助工具，促进互动式学习

环境要求

• 操作系统：Mac / Linux
• 依赖工具：Docker、Docker Compose
• 额外工具：Ansible（需通过pip3安装）

安装与部署步骤

1. 克隆代码仓库

bash
$ git clone https://github.com/hexlet-codebattle/codebattle.git

2. 安装Ansible

参考Ansible官方安装文档完成安装。

3. 配置开发环境

bash
$ cd codebattle
$ make ansible-development-setup
$ make compose-setup

运行方法

bash
$ make compose

运行成功后，打开浏览器访问：http://localhost:4000

测试方法

bash
$ make compose-test

常用命令

bash
# 上传语言配置
$ mix upload_lang

# 推送Docker镜像（全部/指定语言）
$ mix dockers.push # 推送所有镜像
$ mix dockers.push elixir # 推送Elixir镜像

# 构建Docker镜像（全部/指定语言）
$ mix dockers.build # 构建所有镜像
$ mix dockers.build elixir # 构建Elixir镜像

# 拉取Docker镜像（全部/指定语言）
$ mix dockers.pull # 拉取所有镜像
$ mix dockers.pull elixir # 拉取Elixir镜像

# 运行特定测试
$ mix test test/code_check/

# 注意：如果在开发环境中使用Docker，需在compose-bash中运行命令

支持与社区

• Slack频道：<[***]>（频道：codebattle）