{"id":13646645,"url":"https://github.com/containers/build","last_synced_at":"2025-04-21T21:31:11.461Z","repository":{"id":33255855,"uuid":"36900260","full_name":"containers/build","owner":"containers","description":"another build tool for container images (archived, see https://github.com/rkt/rkt/issues/4024)","archived":true,"fork":false,"pushed_at":"2017-08-23T16:10:51.000Z","size":2392,"stargazers_count":342,"open_issues_count":47,"forks_count":80,"subscribers_count":26,"default_branch":"master","last_synced_at":"2024-11-09T20:37:42.682Z","etag":null,"topics":[],"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/containers.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":"2015-06-04T23:02:32.000Z","updated_at":"2024-08-22T03:58:35.000Z","dependencies_parsed_at":"2022-09-02T20:22:32.088Z","dependency_job_id":null,"html_url":"https://github.com/containers/build","commit_stats":null,"previous_names":["appc/acbuild"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/containers%2Fbuild","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/containers%2Fbuild/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/containers%2Fbuild/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/containers%2Fbuild/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/containers","download_url":"https://codeload.github.com/containers/build/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250136676,"owners_count":21380876,"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":[],"created_at":"2024-08-02T01:03:01.807Z","updated_at":"2025-04-21T21:31:11.077Z","avatar_url":"https://github.com/containers.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"## _This project is currently unmaintained_\n\nacbuild was originally created to be the tool used to build AppC images. Due to\nthe introduction of the [Open Container\nInitiative](https://www.opencontainers.org/), development on AppC was\n[officially suspended](https://github.com/appc/spec#-disclaimer-) in November,\n2016. While acbuild has the ability to also produce OCI images, it is not the\nonly tool capable of doing so. In its current state, acbuild is not currently\nmaintained. If you wish to become a maintainer of acbuild, feel free to start\ncontributing and ask for direct commit access via the issue/PR tracker.\n\nFor those looking for an OCI image manipulation tool that is actively\nmaintained, [umoci](https://github.com/openSUSE/umoci) or\n[buildah](https://github.com/projectatomic/buildah) might be able to fill the\nrole.\n\n# acbuild - another container build tool\n\nacbuild is a command line utility to build and modify container images.\n\nIt is intended to provide an image build workflow independent of specific\nformats; currently, it can output the following types of container images:\n* ACI, the container image format defined in the [App Container (appc) \n spec](https://github.com/appc/spec).\n* OCI, the format defined in the [Open Containers Image Format\n  specification](https://github.com/opencontainers/image-spec)\n\n\n[http://www.youtube.com/watch?v=WcnIDm80y68](http://www.youtube.com/watch?v=WcnIDm80y68)\n\n[![How to use rkt acbuild to construct app container images](http://img.youtube.com/vi/WcnIDm80y68/0.jpg)](http://www.youtube.com/watch?v=WcnIDm80y68 \"How to use rkt acbuild to construct app container images\")\n\n## Rationale\n\nWe needed a powerful tool for constructing and manipulating container images\nthat made it easy to iteratively build containers, both from scratch and atop\nexisting images. We wanted that tool to integrate well with Unix mechanisms\nlike the shell and `Makefile`s so it would fit seamlessly into well-known\nadministrator and developer workflows.\n\n## Installation\n\n### Dependencies\n\nacbuild can only be run on a Linux system, and has only been tested on the\namd64 architecture.\n\nFor trying out acbuild on Mac OS X, it's recommended to use Vagrant.\nInstructions on how to do this are a little further down in this document.\n\nacbuild requires a handful of commands be available on the system on \nwhich it's run:\n\n- `cp`\n- `modprobe`\n\nAdditionally `systemd-nspawn` is required to use the [default\nengine](Documentation/subcommands/run.md) for acbuild run. Thus on Ubuntu the `systemd-container` package needs to be installed.\n\n### Prebuilt Binaries\n\nThe easiest way to get `acbuild` is to download one of the\n[releases](https://github.com/containers/build/releases) from GitHub.\n\n### Build from source\n\nThe other way to get `acbuild` is to build it from source. Building from source requires [Go 1.5+](https://golang.org/dl/).\n\nFollow these steps to do so:\n\n1. Grab the source code for `acbuild` by `git clone`ing the source repository:\n   ```\n   cd ~\n   git clone https://github.com/containers/build acbuild\n   ```\n\n2. Run the `build` script from the root source repository directory:\n   ```\n   cd acbuild\n   ./build\n   ```\n\n   Or, if you want to build in docker (assuming `$PWD` exists and contains\n   `acbuild/` on your Docker host):\n\n   ```\n   cd acbuild\n   ./build-docker\n   ```\n\n3. A `bin/` directory will be created that contains the `acbuild` tool. To make\n   sure your shell can find this executable, append this directory to your\n   environment's `$PATH` variable. You can do this in your `.bashrc` or similar\n   file, for example:\n   ```\n   vi ~/.bashrc\n   ```\n\nand put the following lines at the end of the file:\n   ```\n   export ACBUILD_BIN_DIR=~/acbuild/bin\n   export PATH=$PATH:$ACBUILD_BIN_DIR\n   ```\n\n### Building acbuild with rkt\n\nIf rkt is installed on the system, acbuild can also be built inside of a rkt container with the following command:\n\n```\n./build-rkt\n```\n\n\n### Trying out acbuild using Vagrant\n\nFor users with Vagrant 1.5.x or greater, there's a provided `Vagrantfile` that\ncan quickly get you set up with a Linux VM that has both acbuild and rkt. The\nfollowing steps will grab acbuild, set up the machine, and ssh into it.\n\n```\ngit clone https://github.com/containers/build acbuild\ncd acbuild\nvagrant up\nvagrant ssh\n```\n\n## Documentation\n\nDocumentation about acbuild and many of its commands is available in the\n[`Documentation`\ndirectory](https://github.com/containers/build/tree/master/Documentation) in this\nrepository.\n\n## Examples\n\nCheck out the [`examples`\ndirectory](https://github.com/containers/build/tree/master/examples) for some common\napplications being packaged into ACIs with `acbuild`.\n\n## Related work\n\n- https://github.com/sgotti/baci\n- https://github.com/appc/spec/tree/master/actool - particularly the `build` and\n  `patch-manifest` subcommands. `acbuild` may subsume such functionality,\n  leaving `actool` as a validator only.\n- https://github.com/blablacar/dgr\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontainers%2Fbuild","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcontainers%2Fbuild","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontainers%2Fbuild/lists"}