Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xynydev/create-ublue-image
https://github.com/xynydev/create-ublue-image
Last synced: 15 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/xynydev/create-ublue-image
- Owner: xynydev
- License: apache-2.0
- Created: 2023-03-29T12:32:06.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-15T08:47:57.000Z (7 months ago)
- Last Synced: 2024-08-01T00:12:39.585Z (4 months ago)
- Language: Shell
- Size: 64.5 KB
- Stars: 11
- Watchers: 1
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# create-ublue-image
This is a small containerized tool to automatically create a functional Github repository custom ostree native container image based on [blue-build/template](https://github.com/blue-build/template).
I'm working on a web-based version at [ublue-os/images-website](https://github.com/ublue-os/images-website), but this one will also be maintained for the time being.
## Running
***create-ublue-image*** should run on any computer with [Podman](https://podman.io/) installed. If you are already running an immutable Fedora variant, you shouldn't have to install anything.
Run the following command in a directory that you have write access to, your repo will be created as a subdirectory. The script will ask you further questions.
```
podman run -v "$(pwd)":/host --security-opt label=disable -it --pull=newer ghcr.io/xynydev/create-ublue-image
```
**It is not recommended to run the tool inside your home directory, but rather a subdirectory, as that can cause errors.**
However, if the command tool starts in your home dir without any errors, it should probably function.
You do not need to run the tool in an empty directory, it will create a new one with the name that you input.
This command runs the OCI container built in this repo using `podman` mounting your working directory `pwd` into the container under the path `/host`. `:z` makes it possible for multiple containers to use the volume at the same time, which is useful when running a Distrobox. If you run into issues with "relabeling" when running the command, you should try removing `:z` from the end of the mount command.
## Pull latest commits
In order to update changes from the upstream repository, run:
```
git fetch upstream
git merge upstream/main -m "chore: merging upstream changes"
```
Some instructions also exist in the uBlue docs: https://ublue.it/making-your-own/#automatic-setup
## Can I trust you?
This tool uses `github-cli` to authenticate to your account, which could be a security concern.
You can read all of the code in `wizard.sh` (<100 loc) and see for yourself everything this tool does.
You can also just set up the repository manually.