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，請參閱許可證。