{"id":13672238,"url":"https://github.com/science-computing/butido","last_synced_at":"2025-09-01T04:42:49.031Z","repository":{"id":42391027,"uuid":"329260293","full_name":"science-computing/butido","owner":"science-computing","description":"Build Linux packages using Docker containers","archived":false,"fork":false,"pushed_at":"2025-03-07T17:01:05.000Z","size":2500,"stargazers_count":23,"open_issues_count":21,"forks_count":8,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-31T14:15:00.711Z","etag":null,"topics":["docker","eviden","linux","packaging"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/science-computing.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":"2021-01-13T09:42:56.000Z","updated_at":"2025-03-03T14:16:27.000Z","dependencies_parsed_at":"2023-11-06T12:43:15.197Z","dependency_job_id":"41c44888-e60e-4858-963f-bed4a98aec6d","html_url":"https://github.com/science-computing/butido","commit_stats":{"total_commits":1732,"total_committers":14,"mean_commits":"123.71428571428571","dds":"0.49653579676674364","last_synced_commit":"371e83103866a3fbac3ac560669a3aa5db4800cd"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/science-computing%2Fbutido","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/science-computing%2Fbutido/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/science-computing%2Fbutido/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/science-computing%2Fbutido/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/science-computing","download_url":"https://codeload.github.com/science-computing/butido/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247685634,"owners_count":20979085,"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":["docker","eviden","linux","packaging"],"created_at":"2024-08-02T09:01:30.142Z","updated_at":"2025-04-07T16:19:31.605Z","avatar_url":"https://github.com/science-computing.png","language":"Rust","funding_links":[],"categories":["Rust"],"sub_categories":[],"readme":"# BUTIDO\n\n\"butido\" could stand for \"but i do\", \"BUild Things In DOcker\" or\n\"Better Universal Task Instrumentation Docker Observator\".\n\nAnyways, it is a tool for building packages for Linux distributions in Docker\nand it does not make assumptions about the build procedure itself (and thus can\nbuild .rpm, .deb, or any other package format your scripts can build).\n\n\n## Functionality\n\nPackages are defined in TOML and in hierarchies\n(see [config-rs](https://docs.rs/config/)).\nSee the [examples](./examples) for how to define packages.\n\nThe \"business-logic\" of packages are shell scripts which exist in predefined\n\"phases\".\nThese scripts are compiled into one large script (per package) which is then\nrun to build the source into a package.\n\nThe package definition(s) can hold meta-information and (of course) information\nabout a packages dependencies. Both dependencies and meta-information is made\navailable in a build.\n\nEverything that is computed before, during or after a build or submit is written\nto a postgres database, including build logs.\nThis database can be queried for packages, build information, logs and other\ndata.\n\nSuccessfully built packages are collected in a \"staging\" store on FS. A staging\nstore is created per submit.\nThe results can be taken from this \"staging\" store and be released into a\n\"release\" store.\n\n\n## Requirements\n\nBuilding butido is easy, assuming you have a Rust installation:\n\n```bash\ncargo build --release # (remove --release for a debug build)\n```\n\nButido is built and tested with Rust 1.85.0 as MSRV.\n\n\n### (Development) Setup\n\nTo set up a development infrastructure or a production infrastructure (using the\nexamples from the `./examples/packages` directory):\n\n```bash\n# pull down necessary Docker images\ndocker pull debian:bullseye\ndocker pull postgres:12\n\n# setup the database in a postgres container\nPG_USER=pgdev   \\\nPG_PW=password  \\\nPG_DB=butido    \\\nPG_CONTAINER_NAME=butido-db \\\nbash scripts/dev-pg-container.sh\n\n# copy the examples to /tmp\ncd examples/packages\nmake\n\n# Finish the database setup\ncd /tmp/butido-test-repo\n/path/to/butido db setup\n\n# Start building\n/path/to/butido build a --image debian:bullseye\n```\n\n\n### Glossary\n\n| Word        | Explanation                                                                                                      |\n|-------------|------------------------------------------------------------------------------------------------------------------|\n| build / job | The procedure of transforming a set of sources to a package (or, technically, even to multiple packages)         |\n| dependency  | A \"package\" that is required during the buildtime or during the runtime of another \"package\"                     |\n| endpoint    | A Docker API endpoint butido can talk to                                                                         |\n| jobset      | A list of jobs that can be run in any order or in parallel                                                       |\n| output      | The results of a butido build job                                                                                |\n| package     | A single (archive) file OR the definition of a job                                                               |\n| script      | The script that is run inside a container. Basically the \"-\u003e\" in \"source -\u003e package\".                            |\n| source      | A file that contains a source code archive                                                                       |\n| submit      | A call to butido for building a single package, which can result in multiple packages (dependencies) being built |\n| tree        | The tree structure that is computed before a packages is built to find out all (transitive) dependencies         |\n\n\n# Authors\n\n\u003c!-- Note: The author lists should be sorted alphabetically by surname. --\u003e\n- Original author: Matthias Beyer \u003cmail@beyermatthias.de\u003e @matthiasbeyer\n- Active maintainers: See `authors` in Cargo.toml\n- Passive maintainers\n  - Erdmut Pfeifer \u003cerdmut.pfeifer@eviden.com\u003e @ErdmutPfeifer\n  - Christoph Prokop \u003cchristoph.prokop@eviden.com\u003e @christophprokop\n\n\n# License\n\nbutido was developed for science + computing AG (an Atos company).\n\nLicense: EPL-2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscience-computing%2Fbutido","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscience-computing%2Fbutido","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscience-computing%2Fbutido/lists"}