{"id":23654865,"url":"https://github.com/sgeisbacher/container-juggler","last_synced_at":"2025-09-01T06:32:29.163Z","repository":{"id":51293526,"uuid":"71161154","full_name":"sgeisbacher/container-juggler","owner":"sgeisbacher","description":"docker-compose wrapper/config-generator to manage different development-environments","archived":false,"fork":false,"pushed_at":"2024-02-16T16:20:14.000Z","size":134,"stargazers_count":17,"open_issues_count":3,"forks_count":4,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-08-15T11:58:47.591Z","etag":null,"topics":["developer-tools","docker","docker-compose","generator","golang"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sgeisbacher.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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-10-17T16:59:29.000Z","updated_at":"2023-04-19T13:15:15.000Z","dependencies_parsed_at":"2024-11-15T00:37:36.218Z","dependency_job_id":null,"html_url":"https://github.com/sgeisbacher/container-juggler","commit_stats":null,"previous_names":["sgeisbacher/compose-env-manager","sgeisbacher/docker-compose-env-manager"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/sgeisbacher/container-juggler","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sgeisbacher%2Fcontainer-juggler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sgeisbacher%2Fcontainer-juggler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sgeisbacher%2Fcontainer-juggler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sgeisbacher%2Fcontainer-juggler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sgeisbacher","download_url":"https://codeload.github.com/sgeisbacher/container-juggler/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sgeisbacher%2Fcontainer-juggler/sbom","scorecard":{"id":814306,"data":{"date":"2025-08-11","repo":{"name":"github.com/sgeisbacher/container-juggler","commit":"5652f4c407921d3df8717ffd3587e846334b643a"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.5,"checks":[{"name":"Code-Review","score":0,"reason":"Found 1/27 approved changesets -- score normalized to 0","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":"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":"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":"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":"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":"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":"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":"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":"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: GNU General Public License v3.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":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v2.0.1 not signed: https://api.github.com/repos/sgeisbacher/container-juggler/releases/5498176","Warn: release artifact v2.0.0 not signed: https://api.github.com/repos/sgeisbacher/container-juggler/releases/5449587","Warn: release artifact v1.0.0 not signed: https://api.github.com/repos/sgeisbacher/container-juggler/releases/4589705","Warn: release artifact v2.0.1 does not have provenance: https://api.github.com/repos/sgeisbacher/container-juggler/releases/5498176","Warn: release artifact v2.0.0 does not have provenance: https://api.github.com/repos/sgeisbacher/container-juggler/releases/5449587","Warn: release artifact v1.0.0 does not have provenance: https://api.github.com/repos/sgeisbacher/container-juggler/releases/4589705"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"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":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: containerImage not pinned by hash: examples/basic/app/Dockerfile:1: pin your Docker image by updating node:boron to node:boron@sha256:e133e66ec3bfc98da0440e552f452e5cdf6413319d27a2db3b01ac4b319759b3","Warn: containerImage not pinned by hash: examples/basic/frontend/Dockerfile:1: pin your Docker image by updating nginx to nginx@sha256:33e0bbc7ca9ecf108140af6288c7c9d1ecc77548cbfd3952fd8466a75edefe57","Warn: containerImage not pinned by hash: examples/volume/app/Dockerfile:1: pin your Docker image by updating node:boron to node:boron@sha256:e133e66ec3bfc98da0440e552f452e5cdf6413319d27a2db3b01ac4b319759b3","Warn: containerImage not pinned by hash: examples/volume/frontend/Dockerfile:1: pin your Docker image by updating nginx to nginx@sha256:33e0bbc7ca9ecf108140af6288c7c9d1ecc77548cbfd3952fd8466a75edefe57","Warn: npmCommand not pinned by hash: examples/basic/app/Dockerfile:7","Warn: npmCommand not pinned by hash: examples/volume/app/Dockerfile:7","Info:   0 out of   2 npmCommand dependencies pinned","Info:   0 out of   4 containerImage 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":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 6 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-23T13:52:31.801Z","repository_id":51293526,"created_at":"2025-08-23T13:52:31.801Z","updated_at":"2025-08-23T13:52:31.801Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273082410,"owners_count":25042282,"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","status":"online","status_checked_at":"2025-09-01T02:00:09.058Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["developer-tools","docker","docker-compose","generator","golang"],"created_at":"2024-12-28T19:34:10.313Z","updated_at":"2025-09-01T06:32:28.858Z","avatar_url":"https://github.com/sgeisbacher.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# container-juggler\n[![Build Status](https://travis-ci.org/sgeisbacher/container-juggler.svg?branch=master)](https://travis-ci.org/sgeisbacher/container-juggler) [![Code Climate](https://codeclimate.com/github/sgeisbacher/container-juggler/badges/gpa.svg)](https://codeclimate.com/github/sgeisbacher/container-juggler) [![Go Report Card](https://goreportcard.com/badge/github.com/sgeisbacher/container-juggler)](https://goreportcard.com/report/github.com/sgeisbacher/container-juggler) [![Coverage Status](https://coveralls.io/repos/github/sgeisbacher/container-juggler/badge.svg?branch=master)](https://coveralls.io/github/sgeisbacher/container-juggler?branch=master) [![Issue Count](https://codeclimate.com/github/sgeisbacher/container-juggler/badges/issue_count.svg)](https://codeclimate.com/github/sgeisbacher/container-juggler)  \n**container-juggler** is a wrapper/config-generator for **docker-compose** to manage different development-scenarios.\n\nIt preruns a *docker-compose.yml*-file-generator, which renders based on *scenarios* defined in *container-juggler.yml*.  \nThis means you define multiple *scenarios* (scenario *all* is required, which is also the base for other scenarios).  \nOther scenarios must be subsets of the *all*-scenario.  \nThe renderer will detect missing services by diffing the selected with the all-*scenario* and adds them as */etc/hosts*-entries (via docker's extra-hosts-option) in each of the services. So requests to missing services will be routed to your host-machine.  \nNow you are able to run parts of your multi-tier-application directly on your host-machine (parts you're currently working on) and all others in docker with docker-compose.  \n\n## Installation\ntodo\n## Project-Configuration\n- create a **container-juggler.yml** in the root-folder of your project\n- add at least the *all*-scenario, e.g.:\n\n```yaml\ntemplateFolderPath: ./templates/\nscenarios:\n  all:\n    - frontend\n    - app\n    - db\n```\n- *container-juggler* will lookup the service-templates in **./templates/\\\u003cservice-name\\\u003e.yml**. So create your service-templates (like in the example above *frontend.yml*, *app.yml* and *db.yml*) as you know from [docker-compose-file-reference](https://docs.docker.com/compose/compose-file/) in that folder. e.g.:\n\n```yaml\nimage: nginx\nports:\n  - \"80:80\"\n```\n## Additional Configuration\n### volume-init\nIf you run *docker-compose up* your database and all other docker-volumes will be empty. So you may want to provide initial-data-zips for your docker-volumes.  \n*container-juggler init* will download the specified zip and extracts it to your specified target-dir. If target-dir is not empty, *container-juggler* will skip this volume-init.  \nYou can define a *volume-init*-section in your *container-juggler.yml* to achieve that, e.g.:\n\n```yaml\nvolume-init:\n    - name: app-data-dir\n      source: http://example.org/app-data.zip\n      target: ./data/app\n    - name: mysql-data-dir\n      source: /path/to/file.zip \n      target: ./data/mysql\n```\n\n\u003e **Note!**  \n\u003e - Don't forget to add this data-directory to .gitignore-file ;-)  \n\n## Sample Configuration\n### container-juggler.yml\n\n```yaml\nscenarios:\n  all:\n    - frontend\n    - app\n    - db\n  backend:\n    - frontend\n    - db\n  frontend:\n    - app\n    - db\nvolume-init:\n    - name: app-data-dir\n      source: http://example.org/app-data.zip\n      target: ./data/app\n    - name: mysql-data-dir\n      source: http://example.org/db-data.zip\n      target: ./data/mysql\n```\n\n### ./templates/db.yml\n\n```yaml\nimage: mysql\nports:\n    - \"3306:3306\"\nvolumes:\n    - ./data/mysql:/var/lib/mysql\n```\n\n## RUN\nplease check:\n```bash\ncontainer-juggler help\n```\n\n## Examples\n\nThere are examples available in the `examples` folder, showcasing how different configurations could look like.\n\nThe `basic` example contains a configuration for a simple setup with a `frontend (nginx)`, `backend (nodejs)` and `db (mongodb)`.\n\nIn order to generate and run the `basic` example with the `all` scenario, you need to execute the following commands from the repository root:\n\n```\ncd examples/basic\ncontainer-juggler generate all\ncontainer-juggler run all\n```\n\n## Development setup\n\nIn order to use the same versions of the dependencies we provide a\n`vendor/vendor.json` file which you can use with [govendor][]\n\n```bash\ngovendor sync\n```\n\nOnce you have all dependencies inside the `vendor` folder, you can run the tests\nwith `make test`.\n\n[govendor]: https://github.com/kardianos/govendor\n\n## TODOS\n\n- [x] ~~detect required extra-hosts by diffing all-scenario with current-scenario~~\n- [x] ~~stability-adjustments (no args, ...)~~\n- [ ] add template-loading from remote-server\n- [ ] test on windows\n- [ ] add static extra-hosts to container-juggler.yml\n- [x] ~~check scenario \"all\" is present (in configuration)~~\n- [x] ~~check all template-files of scenario \"all\" are present~~\n- [x] ~~detect missing services (against \"all\"-scenario)~~\n- [x] ~~add extra-hosts for missing scenarios~~\n- [ ] add extra-hosts for global external-services\n- [x] ~~add all services to compose-data-map~~\n- [x] ~~gen yaml and write it to docker-compose.yml~~\n- [ ] build dependency-tree to generate depends_on-entries in docker-compose.yml\n- [ ] autocompletion for bash and zsh\n- [ ] add flag to generate-cmd to write generated docker-compose.yml to stdout only\n- [ ] run init on empty data-dirs\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsgeisbacher%2Fcontainer-juggler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsgeisbacher%2Fcontainer-juggler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsgeisbacher%2Fcontainer-juggler/lists"}