{"id":15663090,"url":"https://github.com/koalalorenzo/backpack","last_synced_at":"2025-10-14T05:30:46.810Z","repository":{"id":64303356,"uuid":"296087536","full_name":"koalalorenzo/backpack","owner":"koalalorenzo","description":"Template system and package manager to deploy Hashicorp Nomad Jobs. Mirror on GitHub, Official repo available on Gitlab.com","archived":true,"fork":false,"pushed_at":"2020-11-15T22:48:19.000Z","size":332,"stargazers_count":18,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-10-04T13:35:26.575Z","etag":null,"topics":["backpack","hashicorp-nomad","helm","nomad","nomad-backpack","nomad-jobs","package"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/koalalorenzo.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-09-16T16:24:30.000Z","updated_at":"2024-08-22T10:55:48.000Z","dependencies_parsed_at":"2023-01-15T10:00:47.273Z","dependency_job_id":null,"html_url":"https://github.com/koalalorenzo/backpack","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koalalorenzo%2Fbackpack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koalalorenzo%2Fbackpack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koalalorenzo%2Fbackpack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koalalorenzo%2Fbackpack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/koalalorenzo","download_url":"https://codeload.github.com/koalalorenzo/backpack/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":236446698,"owners_count":19150125,"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":["backpack","hashicorp-nomad","helm","nomad","nomad-backpack","nomad-jobs","package"],"created_at":"2024-10-03T13:35:27.988Z","updated_at":"2025-10-14T05:30:41.528Z","avatar_url":"https://github.com/koalalorenzo.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nomad's Backpack 🎒\n\n[Backpack](https://backpack.qm64.tech) 🎒 is a packaging system for\n[Hashicorp Nomad](https://www.nomadproject.io) that allows to:\n\n* Helps you define and install complex jobs configuration\n* Helps building reproducible jobs across multiple Nomad clusters\n* Simplifies updates to new version of jobs\n* Allows you to publish and share packages of applications\n\nPlease, keep in mind that this is designed for Nomad, and it might result as\nvery different than Helm, as Kubernetes is way more than a scheduler.\nRead more [here](https://www.nomadproject.io/intro/vs/kubernetes.html) about\nthe differences between k8s and nomad\n\nTo learn more about the motivation behind the development of this project\ncheck [the blog post on Qm64 website](https://qm64.tech/posts/202011-hashicorp-nomad-backpack/).\n\nIf you need some help or you want to stay updated with the latest news,\n[join Qm64's chatroom on Matrix](https://matrix.to/#/#qm64:matrix.org?via=matrix.org)\n\nBackpack is currently tested against Nomad version 0.12.8\n\n## TL;DR: Install\nYou can manually download the latest release from \n[the release page here](https://gitlab.com/Qm64/backpack/-/releases).\n\nOr compile the binaries:\n```shell\ngo get -v gitlab.com/Qm64/backpack\ncd $GOPATH/src/gitlab.com/Qm64/backpack/\nmake install\n```\n\n## TL;DR How to Use\n**Create** your first pack, by using the boilerplate directory structure:\n\n```shell\nbackpack create nginx\n```\n\n**Pack** all the files into one single pack:\n```shell\nbackpack pack ./nginx-0.1.0/\n```\n\n**Customize** the values for the template to configure, enable, adjust the jobs:\n```shell\nbackpack unpack values ./nginx-0.1.0.backpack -f ./values.yaml\n```\n\n**Plan** and validate (dry-run) the jobs of a package before running:\n```shell\nbackpack plan ./nginx-0.1.0.backpack -v ./values.yaml\n```\n\n**Run** your Nomad Jobs with my custom values:\n```shell\nbackpack run ./nginx-0.1.0.backpack -v ./values.yaml\n```\n\n**Check** the status of the job allocations:\n```shell\nbackpack status ./nginx-0.1.0.backpack --all\n```\n\nUnpack, customize or Run a backpack **from an URL**:\n```shell\nbackpack unpack values https://backpack.qm64.tech/examples/redis-6.0.0.backpack -f ./values.yaml\nbackpack run https://backpack.qm64.tech/examples/redis-6.0.0.backpack -v values.yaml\n```\n\n**Get Help** and learn more for each command\n```shell\nbackpack help\n```\n\nHappy Backpacking! 🎒😀 \n\n## Read More\n\n* [How to build Backpack binaries from source code](docs/build.md)\n* [How to install Backpack from source code](docs/build.md#installing)\n* [How to use backpack with Helm](docs/usage.md)\n\n# Copyright and License\n\nCopyright © 2020 Lorenzo Setale https://setale.me\nThe full license is available in the file [LICENSE](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoalalorenzo%2Fbackpack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkoalalorenzo%2Fbackpack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoalalorenzo%2Fbackpack/lists"}