harness

马具

线束开源是一个开源开发平台，配备了代码托管，自动化DevOps管道，托管开发环境（Gitspaces）和文物注册机构的功能。

概述

线束开源是一个开源开发平台，配备了代码托管，自动化的DevOps管道，Gitspaces和工件登记处的功能。

本地跑步线束

最新发布的Docker图像可以在安全带/线束上找到。

要安装线束，只需在下面运行命令。容器启动后，您可以在浏览器中访问http：// localhost：3000。

docker run -d 
  -p 3000:3000 
  -p 22:22 
  -v /var/run/docker.sock:/var/run/docker.sock 
  -v /tmp/harness:/data 
  --name harness 
  --restart always 
  harness/harness

线束图像使用卷存储数据库和存储库。强烈建议使用绑定安装座或命名音量，因为一旦停止容器，所有数据将丢失。

请参阅开发人员。harness.io，学习如何充分利用安全带。

无人机在哪里？

线束开源代表了下一代无人机的大量投资。如果无人机专注于连续集成，则安全件添加了源代码托管，开发人员环境（Gitspaces）和人工制品注册表；为团队提供端到端的开源DevOps平台。

目的是让利用管道功能最终与无人机完全均匀，从而使用户可以无缝从无人机迁移到线束。

但是，我们预计这需要一些时间，这就是为什么我们将无人机快照作为功能分支无人机（README），以便它可以继续开发。

至于安全带，开发项目正在主分支机构上进行。

有关安全带的更多信息，请访问developer.harness.io。

有关无人机的更多信息，请访问Drone.io。

线束开源开发

先决条件

安装最新的稳定版本的节点和GO版本1.20或更高版本，然后安装以下GO程序。确保将Gopath bin目录添加到您的路径中。

安装Protobuf

• 检查您是否已经安装了Protobuf protoc --version
• 如果您的版本与v3.21.11不同，请运行brew unlink protobuf
• Get v3.21.11 curl -s https://raw.githubusercontent.com/Homebrew/homebrew-core/9de8de7a533609ebfded833480c1f7c05a3448cb/Formula/protobuf.rb > /tmp/protobuf.rb
• 安装brew install /tmp/protobuf.rb
• 查看您的版本protoc --version

安装Protoc-Gen-Go和Protoc-Gen-Go-RPC：

• 安装Protoc-gen-Go v1.28.1 go install google.golang.org/protobuf/cmd/[email protected] （请注意，这将在$ Gobin中安装二进制二进制文件，因此请确保$ Gobin在您的$路径中）

• 安装Protoc-gen-go-grpc v1.2.0 go install google.golang.org/grpc/cmd/[email protected]

$ make dep
$ make tools

建造

第一步是构建用户界面工件：

$ pushd web
$ yarn install
$ yarn build
$ popd

之后，您可以构建线束二进制：

$ make build

跑步

该项目支持GO支持的所有操作系统和架构。这意味着您可以在计算机上构建并运行系统；在本地开发和测试中，不需要Docker容器。

要在localhost:3000启动服务器，只需运行以下命令：

./gitness server .local.env

UI使用Swagger使用的自动生成线束API客户端

在添加新的REST API时，请确保更新UI使用的自动化客户端代码。

要重新生成代码，请执行以下步骤：

• 带有最新线束二进制的重新摇动./gitness swagger > web/src/services/code/swagger.yaml
• 导航到web文件夹并运行yarn services

现在，最新的API更改应反映在web/src/services/code/index.tsx中

运行注册表一致性测试

 make conformance-test

对于现有运行服务的运行一致性测试，请使用：

 make hot-conformance-test

用户界面

该项目包括用于与系统交互的完整用户界面。运行应用程序时，您可以通过导航到http://localhost:3000在浏览器中访问用户界面。

REST API

该项目包括招摇规格。运行应用程序时，您可以通过导航到http://localhost:3000/swagger （有关RAW YAML请参见http://localhost:3000/openapi.yaml ）来访问Swagger规范。对于注册表端点，当前Swagger位于不同的端点http://localhost:3000/registry/swagger/ （对于RAW JSON，请参见http://localhost:3000/registry/swagger.json ）。这些将稍后移至主要的摇摇子端点。

为了进行测试，最简单的是使用CLI创建令牌（这需要线束服务器运行）：

 # LOGIN (user: admin, pw: changeit)
$ ./gitness login

# GENERATE PAT (1 YEAR VALIDITY)
$ ./gitness user pat " my-pat-uid " 2592000

该命令输出有效的PAT，该PAT已被授予用户全面访问。然后，可以将令牌作为Authorization标头的一部分发送，并以邮递员或卷曲的形式发送：

$ curl http://localhost:3000/api/v1/user 
-H " Authorization: Bearer $TOKEN " 

CLI

该项目包括用于开发和运行服务的非常基本的命令行工具。请记住，您必须启动服务器，然后才能执行命令。

有关支持操作的完整列表，请参阅

$ ./gitness --help

贡献

请参阅贡献

执照

Apache许可证2.0，请参阅许可证。