Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thoth-station/thoth-toolbox
This is a Thoth tool box! A toolbox of Thoth tools...
https://github.com/thoth-station/thoth-toolbox
fedora hacktoberfest openshift ostree thoth thoth-toolbox
Last synced: 26 days ago
JSON representation
This is a Thoth tool box! A toolbox of Thoth tools...
- Host: GitHub
- URL: https://github.com/thoth-station/thoth-toolbox
- Owner: thoth-station
- Created: 2020-05-12T07:17:49.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-05-29T21:46:13.000Z (over 1 year ago)
- Last Synced: 2024-04-16T02:29:04.496Z (9 months ago)
- Topics: fedora, hacktoberfest, openshift, ostree, thoth, thoth-toolbox
- Language: Dockerfile
- Size: 44.9 KB
- Stars: 3
- Watchers: 4
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Thoth toolbox
This is a Thoth toolbox! It contains a few tools published by Project Thoth
ready to use on your local source code repositories or in conjunction with
your OpenShift cluster.
## Usage
### Create your toolbox container
```shell
[user@hostname ~]$ toolbox create --image quay.io/thoth-station/thoth-toolbox:v0.6.0
Created container: thoth-toolbox
Enter with: toolbox enter --container thoth-toolbox-v0.6.0
[user@hostname ~]$
```
This will create a container called `thoth-toolbox-`.
### Enter the toolbox
```shell
[user@hostname ~]$ toolbox enter --container thoth-toolbox-v0.6.0
⬢[user@toolbox ~]$
```
### Tools included
#### thoth-si
thoth-s2i is a tool that can assist you to port an existing application to use Thoth or expose information about
OpenShift build configs used within a cluster. See https://github.com/thoth-station/s2i/blob/master/README.rst for more
information.
#### thamos
A CLI tool and library for communicating with Thoth backend, see https://github.com/thoth-station/thamos/blob/master/README.rst
for more information.
#### thoth-glyph
[Glyph](https://github.com/thoth-station/glyph) uses Machine Learning and Natural Language Processing to understand
commit messages. This knowledge can be used for classifying commits into categories such as Bug-fixes, Feature
additions, Improvements etc.
## Background Information
[Toolbox](https://github.com/containers/toolbox) is a tool that offers a
familiar package based environment for developing and debugging software that
runs fully unprivileged using [Podman](https://podman.io/).
The toolbox container is a fully *mutable* container; when you see
`yum install ansible` for example, that's something you can do inside your
toolbox container, without affecting the base operating system.
This is particularly useful on
[OSTree](https://ostree.readthedocs.io/en/latest/) based operating systems like
[CoreOS](https://coreos.fedoraproject.org/) and
[Silverblue](https://silverblue.fedoraproject.org/). The intention of these
systems is to discourage installation of software on the host, and instead
install software as (or in) containers.
However, this tool doesn't *require* using an OSTree based system — it
works equally well if you're running e.g. existing Fedora Workstation or
Server, and that's a useful way to incrementally adopt containerization.
The toolbox environment is based on an [OCI](https://www.opencontainers.org/)
image. On Fedora this is the `fedora-toolbox` image. This image is used to
create a toolbox container that seamlessly integrates with the rest of the
operating system.