{"id":13393879,"url":"https://github.com/harness/harness","last_synced_at":"2026-01-18T00:32:48.039Z","repository":{"id":13909005,"uuid":"16607898","full_name":"harness/harness","owner":"harness","description":"Harness Open Source is an end-to-end developer platform with Source Control Management, CI/CD Pipelines, Hosted Developer Environments, and Artifact Registries.","archived":false,"fork":false,"pushed_at":"2025-05-08T18:38:32.000Z","size":53447,"stargazers_count":32709,"open_issues_count":73,"forks_count":2844,"subscribers_count":542,"default_branch":"main","last_synced_at":"2025-05-08T19:40:57.315Z","etag":null,"topics":["build-automation","build-pipelines","ci","ci-cd","code-repository","continuous-delivery","continuous-integration","docker","git","go","hacktoberfest","scm"],"latest_commit_sha":null,"homepage":"https://www.harness.io/open-source","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/harness.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":"audit/audit.go","citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2014-02-07T07:54:44.000Z","updated_at":"2025-05-08T18:38:38.000Z","dependencies_parsed_at":"2023-10-20T20:10:03.008Z","dependency_job_id":"3ab43e09-78c6-47c9-a528-b57d5c393cfe","html_url":"https://github.com/harness/harness","commit_stats":{"total_commits":1282,"total_committers":27,"mean_commits":47.48148148148148,"dds":0.8315132605304212,"last_synced_commit":"3701d4a24fd2d1f906127beff20d7384117c97b0"},"previous_names":["drone/drone","harness/gitness","harness/drone","harness/harness"],"tags_count":122,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harness%2Fharness","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harness%2Fharness/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harness%2Fharness/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harness%2Fharness/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/harness","download_url":"https://codeload.github.com/harness/harness/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253671745,"owners_count":21945463,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["build-automation","build-pipelines","ci","ci-cd","code-repository","continuous-delivery","continuous-integration","docker","git","go","hacktoberfest","scm"],"created_at":"2024-07-30T17:01:01.755Z","updated_at":"2026-01-18T00:32:48.006Z","avatar_url":"https://github.com/harness.png","language":"Go","readme":"# Harness\nHarness Open Source is an open source development platform packed with the power of code hosting, automated DevOps pipelines, hosted development environments (Gitspaces), and artifact registries.\n\n## Overview\nHarness Open source is an open source development platform packed with the power of code hosting, automated DevOps pipelines, Gitspaces, and artifact registries.\n\n\n## Running Harness locally\n\u003e The latest publicly released docker image can be found on [harness/harness](https://hub.docker.com/r/harness/harness).\n\nTo install Harness yourself, simply run the command below. Once the container is up, you can visit http://localhost:3000 in your browser.\n\n```bash\ndocker run -d \\\n  -p 3000:3000 \\\n  -p 3022:3022 \\\n  -v /var/run/docker.sock:/var/run/docker.sock \\\n  -v /tmp/harness:/data \\\n  --name harness \\\n  --restart always \\\n  harness/harness\n```\n\u003e The Harness image uses a volume to store the database and repositories. It is highly recommended to use a bind mount or named volume as otherwise all data will be lost once the container is stopped.\n\nSee [developer.harness.io](https://developer.harness.io/docs/open-source) to learn how to get the most out of Harness.\n\n## Where is Drone?\n\nHarness Open Source represents a massive investment in the next generation of Drone. Where Drone focused solely on continuous integration, Harness adds source code hosting, developer environments (gitspaces), and artifact registries; providing teams with an end-to-end, open source DevOps platform.\n\nThe goal is for Harness to eventually be at full parity with Drone in terms of pipeline capabilities, allowing users to seamlessly migrate from Drone to Harness.\n\nBut, we expect this to take some time, which is why we took a snapshot of Drone as a feature branch [drone](https://github.com/harness/harness/tree/drone) ([README](https://github.com/harness/harness/blob/drone/.github/readme.md)) so it can continue development.\n\nAs for Harness, the development is taking place on the [main](https://github.com/harness/harness/tree/main) branch.\n\nFor more information on Harness, please visit [developer.harness.io](https://developer.harness.io/).\n\nFor more information on Drone, please visit [drone.io](https://www.drone.io/).\n\n## Harness Open Source Development\n### Pre-Requisites\n\nInstall the latest stable version of Node and Go version 1.20 or higher, and then install the below Go programs. Ensure the GOPATH [bin directory](https://go.dev/doc/gopath_code#GOPATH) is added to your PATH.\n\nInstall protobuf\n- Check if you've already installed protobuf ```protoc --version```\n- If your version is different than v3.21.11, run ```brew unlink protobuf```\n- Get v3.21.11 ```curl -s https://raw.githubusercontent.com/Homebrew/homebrew-core/9de8de7a533609ebfded833480c1f7c05a3448cb/Formula/protobuf.rb \u003e /tmp/protobuf.rb```\n- Install it ```brew install /tmp/protobuf.rb```\n- Check out your version ```protoc --version```\n\nInstall protoc-gen-go and protoc-gen-go-rpc:\n\n- Install protoc-gen-go v1.28.1 ```go install google.golang.org/protobuf/cmd/protoc-gen-go@v1.28.1```\n(Note that this will install a binary in $GOBIN so make sure $GOBIN is in your $PATH)\n\n- Install protoc-gen-go-grpc v1.2.0 ```go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@v1.2.0```\n\n```bash\n$ make dep\n$ make tools\n```\n\n### Build\n\nFirst step is to build the user interface artifacts:\n\n```bash\n$ pushd web\n$ yarn install\n$ yarn build\n$ popd\n```\n\nAfter that, you can build the Harness binary:\n\n```bash\n$ make build\n```\n\n### Run\n\nThis project supports all operating systems and architectures supported by Go.  This means you can build and run the system on your machine; docker containers are not required for local development and testing.\n\nTo start the server at `localhost:3000`, simply run the following command:\n\n```bash\n./gitness server .local.env\n```\n\n### Auto-Generate Harness API Client used by UI using Swagger\nPlease make sure to update the autogenerated client code used by the UI when adding new rest APIs.\n\nTo regenerate the code, please execute the following steps:\n- Regenerate swagger with latest Harness binary `./gitness swagger \u003e web/src/services/code/swagger.yaml`\n- navigate to the `web` folder and run `yarn services`\n\nThe latest API changes should now be reflected in `web/src/services/code/index.tsx`\n\n# Run Registry Conformance Tests\n```\nmake conformance-test\n```\nFor running conformance tests with existing running service, use:\n```\nmake hot-conformance-test\n```\n\n## User Interface\n\nThis project includes a full user interface for interacting with the system. When you run the application, you can access the user interface by navigating to `http://localhost:3000` in your browser.\n\n## REST API\n\nThis project includes a swagger specification. When you run the application, you can access the swagger specification by navigating to `http://localhost:3000/swagger` in your browser (for raw yaml see `http://localhost:3000/openapi.yaml`).\nFor registry endpoints, currently swagger is located on different endpoint `http://localhost:3000/registry/swagger/` (for raw json see `http://localhost:3000/registry/swagger.json`). These will be later moved to the main swagger endpoint. \n\n\nFor testing, it's simplest to just use the cli to create a token (this requires Harness server to run):\n```bash\n# LOGIN (user: admin, pw: changeit)\n$ ./gitness login\n\n# GENERATE PAT (1 YEAR VALIDITY)\n$ ./gitness user pat \"my-pat-uid\" 2592000\n```\n\nThe command outputs a valid PAT that has been granted full access as the user.\nThe token can then be send as part of the `Authorization` header with Postman or curl:\n\n```bash\n$ curl http://localhost:3000/api/v1/user \\\n-H \"Authorization: Bearer $TOKEN\"\n```\n\n\n## CLI\nThis project includes VERY basic command line tools for development and running the service. Please remember that you must start the server before you can execute commands.\n\nFor a full list of supported operations, please see\n```bash\n$ ./gitness --help\n```\n\n## Contributing\n\nRefer to [CONTRIBUTING.md](https://github.com/harness/harness/blob/main/CONTRIBUTING.md)\n\n## License\n\nApache License 2.0, see [LICENSE](https://github.com/harness/harness/blob/main/LICENSE).\n","funding_links":[],"categories":["Go","hacktoberfest","HarmonyOS","运维管理平台","☁️ Cloud Platforms \u0026 Infrastructure","Continuous Integration","Others"],"sub_categories":["Windows Manager","Tools","Standard CLI"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharness%2Fharness","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fharness%2Fharness","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharness%2Fharness/lists"}