关于 gitea
gitea 是一个go语言开发的git项目托管系统:
- 具备与 github.com 类似的功能,如代码存储,浏览,Pull Request,统计分析
- 内置缺陷管理,Wiki模块,密钥管理
- 自托管, 可以安装在企业内部服务器
- 开源, 基于 MIT 授权发布,商业友好
- 更多功能可参考官方对比文档 https://docs.gitea.io/en-us/comparison/
系统分析
此文档主要介绍如何在 InnerStack 上构建并部署 gitea 服务(单机版),先分析下 gitea 部署特征:
数据库依赖 : AppSpec 引用
gitea 依赖并支持多种数据库(MySQL, PostgreSQL, SQLite, MSSQL),这里我们使用 MySQL.
InnerStack 支持 AppSpec 依赖引用,所以这里直接引用 sysinner-mysql-x1 这个 AppSpec 来实现对 MySQL 的依赖.
构建 gitea 原始 package 包
- 主程序文件准备
gitea 以 golang 语言开发,可以被编译为一个没有第三方库依赖的独立二进制包,这里我们采用从 https://dl.gitea.io/gitea/ 直接下载 linux-amd64 格式二进制包的方式。
- 配置模板文件
gitea 依赖配置文件 custem/conf/app.ini, 对数据库访问配置是必要条件,这里将gitea 的 app.ini 作为模板文件放在一个独立的相对路径下,并将配置文件中有关动态配置的变量值替换为形如 {{.cfg/sysinner-mysql/db_host}}
, 这些模板变量将和下面的 AppSpec/Script 配合使用,在容器启动阶段完成配置信息的自动同步。
以上的二进制包和配置模板文件相关代码可通过如下方式下载和构建包文件:
git clone https://github.com/inpack/gitea.git
cd gitea
inpack build --dist linux --version 1.12.4
Building
package: gitea
version: 1.12.4
release: 1
dist: linux
arch: x64
vendor: gitea.io
OK
gitea-1.12.4-1.linux.x64.txz
如果一切顺利,上传新构建的 inpack 原始包文件
inpack push --repo <your-alias-name> --pack_path gitea-1.12.4-1.linux.x64.txz
PUSH /opt/src/inpack/gitea/gitea-1.12.4-1.linux.x64.txz
ok gitea 100%
构建 gitea AppSpec 文件
AppSpec 通过登录 InnerStack inPanel 可视化 WebUI 管理 (https://ip-address:9530/in):
进入方式: Applications / AppSpec Center / New AppSpec
一个完整的定义实例如下图:
更简单的方式: 在上面导出的 https://github.com/inpack/gitea.git 项目根目录有一个 app-spex-x1.toml 文件,可以在 WebUI/AppSpec 编辑界面的 “Advanced editing mode” 模式下直接提交该文件定义, 如下图:
注: 数据库配置信息同步到 app.ini 在 AppSpec/Script Executors 实现, 可参考实例文件细节
构建配置项
对于除数据库连接以外的其他配置信息如何实现,这里做了两个实例,可在 inPanel/Applications/AppSpec 列表的 Config 列点击进入,如下:
单个普通变量: 如 gitea 应用名称(cfg/gitea/app_name), 对应 app.ini
APP_NAME = {{.cfg/gitea/app_name}}
项目富文本配置(ini,json,toml,yaml): 如 gitea 多语言支持清单 (cfg/gitea/app_ini),对应 app.ini
[i18n]...
块
具体如图:
如上步骤提交 AppSpec 后,就可以开始部署了.
部署
Step 1: New Instance
在 AppSpec List 找到 gitea-x1 , 点击 “New Instance”, 为应用设置一个名字
Step 2: 设置 Pod 容器
如下图, 系统会提示两个选项:
- 新建 Pod: 将这个 App 绑定到一个全新的 Pod 中运行
- 绑定到已有的 Pod: 一般用于 DevOps 开发,测试,生产环境推荐一个 App 对应一个 Pod.
注: 不符合硬件规格的 Pod 将不会出现在这个列表里面
这里选择新建 Pod Instance, 提示选择 Pod 规格:
确认 Pod 信息后继续下一步.
Step 3: 配置 MySQL
因为引入依赖 AppSpec/sysinner-mysql-x1 ,这个时候进入 MySQL 配置确认页, 完成对 db_name, db_user, db_auth 等信息确认, 系统后台自动处理并同步配置信息到 Pod/App 运行实例中, 用户可不关注具体细节。点击 “Next” 继续下面操作.
Step 4: 配置 gitea
- 为gitea设置一个名字
- 加入部分 app.ini 附加配置项目, 这项配置最终会通过合并方式(inagent conf-merge) 到 app.ini 中,所以请参照官方给出的 app.ini 完整描诉,只配置必要信息即可。
注: InnerStack 提供的富文本(ini,json,toml,yaml)是一个灵活强大的功能,支持智能合并,模板参数.
Step 5: 创建完成
成功后,会自动跳转到 Pod 详情,可以在这个页面里观察 AppSpec 在这个 Pod 里面的执行情况, 请等待一段时间,没有异常的话,Pod 详情页会出现更多有关这个 AppSpec 的信息,如图:
gitea 后续操作
以上对于 InnerStack 的操作已经完成,对于 gitea 本身而言,它以 web 方式提供用户UI,有自己独立的用户注册管理系统,第一个注册的用户会成为管理员。
gitea web access
gitea 在 Pod 里面提供 web 服务的端口是 3000, 通过部署以后,对外的端口映射为 http://49.232.83.23:18390 (在 Pod 详情里面查看), 进入这个地址:
gitea 1: 应用成功部署后的首页
gitea 2: 注册新用户
gitea 3: 登录 gitea
gitea 4: 在用户页,点击创建新的代码库
gitea 5: 完成一个代码库创建
注: 更多的操作信息请参考 https://gitea.io
申明
- InnerStack/AppCenter 旨在助力企业构建自主 PaaS 平台,InnerStack 自身不提供任何云服务
- AppCenter 涉及的方案、文档、代码、数据旨在为企业构建业务系统过程中提供指导参考,这些 AppSpec 组件可能没有经过完整的功能配置、测试和安全审计, 请不要直接用于生产系统。
- AppCenter 包含的第三方项目源码统一开放在 https://github.com/inpack