{"id":42158714,"url":"https://github.com/asteris-llc/converge","last_synced_at":"2026-01-26T19:55:37.801Z","repository":{"id":81707711,"uuid":"59234611","full_name":"asteris-llc/converge","owner":"asteris-llc","description":"A powerful and easy-to-use configuration management system.","archived":false,"fork":false,"pushed_at":"2020-11-10T15:30:56.000Z","size":40866,"stargazers_count":251,"open_issues_count":113,"forks_count":31,"subscribers_count":19,"default_branch":"master","last_synced_at":"2024-06-20T11:46:27.045Z","etag":null,"topics":["devops","golang","grpc","hcl"],"latest_commit_sha":null,"homepage":"","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/asteris-llc.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-05-19T19:11:26.000Z","updated_at":"2024-05-04T22:24:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"f90f8a56-185b-4944-a0db-af65083670e1","html_url":"https://github.com/asteris-llc/converge","commit_stats":null,"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"purl":"pkg:github/asteris-llc/converge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asteris-llc%2Fconverge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asteris-llc%2Fconverge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asteris-llc%2Fconverge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asteris-llc%2Fconverge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/asteris-llc","download_url":"https://codeload.github.com/asteris-llc/converge/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asteris-llc%2Fconverge/sbom","scorecard":{"id":213314,"data":{"date":"2025-08-11","repo":{"name":"github.com/asteris-llc/converge","commit":"02c76fbfe84dc281d881108083675e9b35752187"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.2,"checks":[{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Code-Review","score":3,"reason":"Found 4/11 approved changesets -- score normalized to 3","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact 0.6.0 not signed: https://api.github.com/repos/asteris-llc/converge/releases/5621325","Warn: release artifact 0.6.0-rc1 not signed: https://api.github.com/repos/asteris-llc/converge/releases/5586845","Warn: release artifact 0.5.0 not signed: https://api.github.com/repos/asteris-llc/converge/releases/5033272","Warn: release artifact 0.5.0-rc1 not signed: https://api.github.com/repos/asteris-llc/converge/releases/5025699","Warn: release artifact 0.5.0-beta1 not signed: https://api.github.com/repos/asteris-llc/converge/releases/4984924","Warn: release artifact 0.6.0 does not have provenance: https://api.github.com/repos/asteris-llc/converge/releases/5621325","Warn: release artifact 0.6.0-rc1 does not have provenance: https://api.github.com/repos/asteris-llc/converge/releases/5586845","Warn: release artifact 0.5.0 does not have provenance: https://api.github.com/repos/asteris-llc/converge/releases/5033272","Warn: release artifact 0.5.0-rc1 does not have provenance: https://api.github.com/repos/asteris-llc/converge/releases/5025699","Warn: release artifact 0.5.0-beta1 does not have provenance: https://api.github.com/repos/asteris-llc/converge/releases/4984924"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: containerImage not pinned by hash: ci/Dockerfile:1: pin your Docker image by updating golang:1.10 to golang:1.10@sha256:6d5e79878a3e4f1b30b7aa4d24fb6ee6184e905a9b172fc72593935633be4c46","Warn: goCommand not pinned by hash: ci/Dockerfile:15-21","Warn: goCommand not pinned by hash: ci/Dockerfile:24","Warn: downloadThenRun not pinned by hash: ci/Dockerfile:27","Warn: goCommand not pinned by hash: ci/Dockerfile:30","Warn: goCommand not pinned by hash: ci/Dockerfile:31","Warn: goCommand not pinned by hash: vendor/github.com/coreos/go-systemd/test:26","Warn: goCommand not pinned by hash: vendor/github.com/coreos/go-systemd/test:27","Info:   0 out of   1 downloadThenRun dependencies pinned","Info:   0 out of   1 containerImage dependencies pinned","Info:   0 out of   6 goCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 29 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-17T01:09:11.645Z","repository_id":81707711,"created_at":"2025-08-17T01:09:11.645Z","updated_at":"2025-08-17T01:09:11.645Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28786432,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T13:55:28.044Z","status":"ssl_error","status_checked_at":"2026-01-26T13:55:26.068Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["devops","golang","grpc","hcl"],"created_at":"2026-01-26T19:55:35.184Z","updated_at":"2026-01-26T19:55:37.789Z","avatar_url":"https://github.com/asteris-llc.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"This project is no longer actively maintained. \n\n\n![Converge Logo](docs/static/images/logo/converge_logo.png)\n\nConverge is a configuration management tool that makes it easy to manage servers,\nlaptops and other devices.\n\nKey features:\n\n- Easy to install and run. A single binary and configuration file is all you need.\n- Resources to make changes on your system: docker images and containers, users\nand groups, systemd, and more. The Resource Reference at\n[converge.aster.is](http://converge.aster.is) has a complete list of resources\nand their configuration settings.\n- A powerful graph engine that automatically generates dependencies and\nruns tasks in parallel.\n- API-first communication using [grpc](http://grpc.io).\n- Module verification: only run trusted modules.\n\n![Converge Graph](examples/docker-swarm-mode/graphs/main.png)\n\n[![Slack Status](http://converge-slack.aster.is/badge.svg)](http://converge-slack.aster.is)\n[![Code Climate](https://codeclimate.com/github/asteris-llc/converge/badges/gpa.svg)](https://codeclimate.com/github/asteris-llc/converge)\n\n\u003c!-- markdown-toc start - Don't edit this section. Run M-x markdown-toc-generate-toc again --\u003e\n**Table of Contents**\n\n- [Converge](#converge)\n    - [Installation](#installation)\n    - [Documentation](#documentation)\n    - [Usage](#usage)\n    - [Development](#development)\n        - [Tools](#tools)\n        - [RPC](#rpc)\n        - [Continuous Integration and Testing](#continuous-integration-and-testing)\n    - [License](#license)\n\n\u003c!-- markdown-toc end --\u003e\n\n## Installation\n\nThe `install-converge.sh` script will download and install the converge binary\nto your `/usr/local/bin/` directory:\n\n```bash\nsudo ./install-converge.sh -v 0.4.0\n```\n\nThe same installation script is available at `get.converge.sh`:\n\n```bash\ncurl get.converge.sh | sudo bash -\n```\n\nYou can also use `go get`:\n\n```bash\ngo get github.com/asteris-llc/converge\n```\n\nor download a release for your platform from the\n[releases page on Github](https://github.com/asteris-llc/converge/releases).\n\n## Documentation\n\nComprehensive documentation can be found at [converge.aster.is](http://converge.aster.is).\n\nYou can learn more about Converge from the following blog posts and presentations:\n\n- [Introducing Converge](http://aster.is/blog/2016/11/23/introducing-converge/)\n- [Conditionals In Converge](http://aster.is/blog/2016/10/17/building-reusable-modules-with-conditionals/)\n- [Converge Presentation to STL DevOps](https://speakerdeck.com/stevendborrelli/converge-2)\n\n## Usage\n\nConverge uses [HCL](https://github.com/hashicorp/hcl) for syntax. HCL is a\nsuperset of JSON that looks (and acts) quite a bit nicer.\n\nThe basic unit of composition in converge is the module. Modules have parameters\nand contain resources. Creating a module looks something like this:\n\n```hcl\n# write \"hello world\" to disk\nparam \"message\" {\n  default = \"Hello, World in {{param `filename`}}\"\n}\n\nparam \"filename\" {\n  default = \"test.txt\"\n}\n\nfile.content \"render\" {\n  destination = \"{{param `filename`}}\"\n  content     = \"{{param `message`}}\"\n}\n```\n\nInvoke this with `converge apply --local samples/fileContent.hcl` to place\na test file on your system. You can also `converge plan --local\nsamples/fileContent.hcl` to see what changes will be made before you apply them.\n\n## Development\n\n### Tools\n\nFor linting, you'll need:\n\ntool | `go get`\n---- | --------\n `golint` | github.com/golang/lint/golint\n`go tool vet` | (built in)\n`gosimple` | honnef.co/go/simple/cmd/gosimple\n`unconvert` | github.com/mdempsky/unconvert\n`structcheck` | github.com/opennota/check/cmd/structcheck\n`varcheck` | github.com/opennota/check/cmd/varcheck\n`aligncheck` | github.com/opennota/check/cmd/aligncheck\n`gas` | github.com/HewlettPackard/gas\n\n### RPC\n\nYou'll need:\n\n- [Google's protobuf compiler](https://github.com/google/protobuf/releases), 3.0\n  or above.\n- The go protoc plugin: `go get -a github.com/golang/protobuf/protoc-gen-go`\n- The grpc gateway plugin(s): `go get -u github.com/grpc-ecosystem/grpc-gateway/protoc-gen-grpc-gateway github.com/grpc-ecosystem/grpc-gateway/protoc-gen-swagger`\n\n### Continuous Integration and Testing\n\nWe use Wercker for CI with a custom base image. The Dockerfile for that image\ncan be found at `/ci/Dockerfile` in the root of the project, and is pushed as\n`asteris/converge-ci`. You can test Converge in the container with the\nfollowing invocation:\n\n```bash\ndocker run -i \\\n           -t \\\n           --rm \\\n           --volume $(pwd):/go/src/github.com/asteris-llc/converge \\\n           asteris/converge-ci \\\n           /bin/bash -c 'cd /go/src/github.com/asteris-llc/converge; make test'\n```\n\nBenchmarks are run with `make bench`, and fuzzing is run with `make\nfuzzing/{target}`.\n\n## License\n\nConverge is licensed under the Apache 2.0 license. See [LICENSE](LICENSE) for\nfull details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasteris-llc%2Fconverge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasteris-llc%2Fconverge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasteris-llc%2Fconverge/lists"}