Skip to content

Commit

Permalink
Merge pull request #85 from travier/rhel9
Browse files Browse the repository at this point in the history
  • Loading branch information
travier committed Apr 5, 2023
2 parents 934843e + 59d2dac commit e0e52fb
Show file tree
Hide file tree
Showing 4 changed files with 5 additions and 89 deletions.
5 changes: 0 additions & 5 deletions NOTICE

This file was deleted.

51 changes: 4 additions & 47 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,51 +1,8 @@
# toolbox - bring your tools with you

rhcos-toolbox is a small script, designed for RHEL CoreOS, that launches a podman container to let you bring in your favorite debugging or admin tools.
rhcos-toolbox is a small script, designed for RHEL CoreOS, that launches a
podman container to let you bring in your favorite debugging or admin tools.

## Usage
This project is deprecated and in maintenance mode.

```
$ /usr/bin/toolbox
Spawning container core-fedora-latest on /var/lib/toolbox/core-fedora-latest.
Press ^] three times within 1s to kill container.
[root@localhost ~]# dnf -y install tcpdump
...
[root@localhost ~]# tcpdump -i ens3
tcpdump: verbose output suppressed, use -v or -vv for full protocol decode
listening on ens3, link-type EN10MB (Ethernet), capture size 65535 bytes
```

## Advanced Usage

### Use a custom image

toolbox uses a Fedora-based userspace environment by default, but this can be changed to any Docker image. Simply override environment variables in `$HOME/.toolboxrc`:

```
core@core-01 ~ $ cat ~/.toolboxrc
REGISTRY=registry.redhat.io
IMAGE=rhel7/rhel-tools:latest
core@core-01 ~ $ toolbox
Spawning a container 'toolbox-test' with image 'registry.redhat.io/rhel7/rhel-tools:latest'
```

### Automatically enter toolbox on login

Set an `/etc/passwd` entry for one of the users to `/usr/bin/toolbox`:

```sh
useradd bob -m -p '*' -s /usr/bin/toolbox -U -G sudo,docker,rkt
```

Now when SSHing into the system as that user, toolbox will automatically be started:

```
$ ssh bob@hostname.example.com
Container Linux by CoreOS alpha (1284.0.0)
...
Spawning container bob-fedora-latest on /var/lib/toolbox/bob-fedora-latest.
Press ^] three times within 1s to kill container.
[root@localhost ~]# dnf -y install emacs-nox
...
[root@localhost ~]# emacs /media/root/etc/systemd/system/docker.service
```
We recommend that you use https://github.com/containers/toolbox instead.
2 changes: 1 addition & 1 deletion rhcos-toolbox
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ trap cleanup EXIT

# Defaults
REGISTRY=registry.redhat.io
IMAGE=rhel8/support-tools
IMAGE=rhel9/support-tools
AUTHFILE=/var/lib/kubelet/config.json
TOOLBOX_NAME=toolbox-"$(whoami)"
TOOLBOXRC="${HOME}"/.toolboxrc
Expand Down
36 changes: 0 additions & 36 deletions rhcos-toolbox.spec

This file was deleted.

0 comments on commit e0e52fb

Please sign in to comment.