Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/supakeen/ib
Command line client for Red Hat's Image Builder.
https://github.com/supakeen/ib
Last synced: 6 days ago
JSON representation
Command line client for Red Hat's Image Builder.
- Host: GitHub
- URL: https://github.com/supakeen/ib
- Owner: supakeen
- License: mit
- Created: 2023-06-02T11:36:34.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-06-04T13:28:01.000Z (over 1 year ago)
- Last Synced: 2025-01-28T23:55:40.325Z (10 days ago)
- Language: Go
- Homepage:
- Size: 22.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ib
`ib` is a command line client for [Red Hat's Image Builder](https://console.redhat.com/insights/image-builder). A hosted service that lets you build customized operating system images for various architectures and in various output formats.
## API
To use `ib` you need an offline token which requires you to have a Red Hat Subscription. A free developer subscription gives you access.
To obtain an offline token you visit the [Red Hat API Tokens](https://access.redhat.com/management/api) page and store it in your environment under the name `REDHAT_OFFLINE_TOKEN`.
If you forget to do so then `ib` will tell you the same.
## Examples
This example builds a CentOS Stream 9 QCOW image for the x86 architecture and writes it to a file called `image.qcow`.
```sh
€ ib c -a x86_64 -d centos-9 -t guest-image -o image.qcow
queued 968d1756-9121-47cb-8f27-3582639206aa
waiting ........................
downloading 968d1756-9121-47cb-8f27-3582639206aa
```
If you wish for a bit more control then the queuing, status, and downloading steps can be performed separately with the `ib c q`, `ib c s`, and `ib c d` commands. Check their `-help` for any arguments you might need.
If you want to list available distributions you use `ib i d`, if you want to know which architectures support which image types you can use `ib i a -d centos-9`.
The images you download can be customized in various ways:
### Packages
Installing additional packages is done through `-p` argument which takes a comma-separated list of package names:
```
€ ib c -a x86_64 -d centos-9 -t guest-image -p nginx,tmux -o image.qcow
```