{"id":19675070,"url":"https://github.com/mesosphere/konvoy-image-builder","last_synced_at":"2025-04-05T13:05:36.054Z","repository":{"id":37806067,"uuid":"361869332","full_name":"mesosphere/konvoy-image-builder","owner":"mesosphere","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-26T14:12:11.000Z","size":16339,"stargazers_count":18,"open_issues_count":21,"forks_count":21,"subscribers_count":19,"default_branch":"main","last_synced_at":"2025-04-01T22:58:01.613Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/mesosphere.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-26T19:26:15.000Z","updated_at":"2025-03-24T16:30:15.000Z","dependencies_parsed_at":"2023-10-02T23:15:32.006Z","dependency_job_id":"eb9b69fb-ba47-478f-9ad4-636762587ddf","html_url":"https://github.com/mesosphere/konvoy-image-builder","commit_stats":{"total_commits":787,"total_committers":34,"mean_commits":"23.147058823529413","dds":0.7865311308767471,"last_synced_commit":"e404d36a8a0d064f92cf6d2e849628e9c654e506"},"previous_names":[],"tags_count":171,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mesosphere%2Fkonvoy-image-builder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mesosphere%2Fkonvoy-image-builder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mesosphere%2Fkonvoy-image-builder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mesosphere%2Fkonvoy-image-builder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mesosphere","download_url":"https://codeload.github.com/mesosphere/konvoy-image-builder/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247339155,"owners_count":20923014,"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-11-11T17:21:06.697Z","updated_at":"2025-04-05T13:05:36.026Z","avatar_url":"https://github.com/mesosphere.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Konvoy Image Builder\n\nThe goal of Konvoy Image Builder (KIB) is to produce a common operating surface to run Konvoy across heterogeneous infrastructure. KIB relies on ansible to install software, configure, and sanitize systems for running Konvoy. Packer is used to build images for cloud environments. Goss is used to validate system’s are capable of running Konvoy.\n\n## Supported OS Families\n\nPresently, KIB supports four OS families:\n\n- Debian\n- Red Hat\n- Flatcar\n- SUSE\n\n## KIB Repository Layout\n\n- `ansible`: contains the ansible playbooks, roles, and default variables\n- `images`: contains image definitions for supported platforms. Presently, we provide AMI image definitions and generic image definitions. Generic image definitions are useful for preprovisioned infrastructure\n- `overrides`: contains variable overrides for Nvidia and FIPS. Unless adding an overlay feature, these files can safely be ignored.\n\n## Quickstart\n\n## `konvoy-image` CLI\n\n### Example Usage\n\n```sh\nkonvoy-image build images/ami/centos-79.yaml\n```\n\n### CLI documentation\n\nSee [`konvoy-image`](docs/cli/konvoy-image.md)\n\n## Example Images\n\n| aws-region | base-os  | ami-id                | image params                                           |\n|------------|----------|-----------------------|--------------------------------------------------------|\n| us-west-2  | centos 7 | ami-0bc38a003a647b084 | [`images/ami/centos-79.yaml`](images/ami/centos-79.yaml) |\n\n## Development\n\n## Recommended Tools\n\n* [Go](https://golang.org/doc/install)\n* [Docker](https://docs.docker.com/get-docker/)\n* [Docker Buildx](https://docs.docker.com/build/install-buildx/)\n* [goreleaser](https://goreleaser.com/install/)\n* [magefile](https://magefile.org/)\n\n### Linting\n\nThe tooling consists of several languages, the main wrapper code is written in\n`go` which is linted with `golangci-lint`. To lint the `go` files run:\n\n```sh\nmake lint\n```\n\nOther languages are linted with the help of\n[`super-linter`](https://github.com/github/super-linter). To lint everything\nelse run:\n\n```sh\nmake super-lint\n```\n\n*NOTE* Konvoy Image Builder makes use of the `embed` feature of `go` 1.16.\n`super-linter` currently uses `go` 1.15. It is expected that the `go` linter\nwill fail under `super-linter`, and is skipped for\n[CI](.github/workflows/lint.yml).\n\n### Testing\n\n[Magefile](https://magefile.org/) tool is used to run konvoy image builder e2e tests.\n\nIn this example, we run the end-to-end test against the Centos 7.9 with air-gapped and fips configuration in AWS\n```sh\nrunE2e \"centos 7.9\" \"offline-fips\" aws false\n```\n### Building\n\nTo build the CLI command run:\n\n```sh\nmake build\n```\n\n### Building the Wrapper\n\nTo build the wrapper for testing.\n\n```sh\nmake build-wrapper\n```\ncreates `./bin/konvoy-image-wrapper` binary for testing using konvoy image wrapper.\n\nFor further development, see the [Dev Docs](docs/dev).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmesosphere%2Fkonvoy-image-builder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmesosphere%2Fkonvoy-image-builder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmesosphere%2Fkonvoy-image-builder/lists"}