| commit | 598df78f6b09a9bb19b636bdc983e90f723ae256 | [log] [tgz] |
|---|---|---|
| author | Yu Qi Zhang <jzehrarnyg@gmail.com> | Wed Sep 19 17:53:50 2018 |
| committer | Yu Qi Zhang <jzehrarnyg@gmail.com> | Wed Sep 19 17:53:50 2018 |
| tree | 4a290f0d9ebc77e3b60a50882254bb8c4247532c | |
| parent | 30d4799ee5f6d32c2423135fca34f6fec55ffacb [diff] |
Add toolbox script for RHCOS Add rhcos-toolbox and corresponding specfile for building wtih rdgo. rhcos-toolbox is a script that makes use of podman to create a privileged debug/admin container, with ability to handle user defined commands and variables. Modify README to reflect the change. Signed-off-by: Yu Qi Zhang <jerzhang@redhat.com>
toolbox is a small script that launches a container to let you bring in your favorite debugging or admin tools.
There are currently two scripts that live within this repository:
$ /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
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 TOOLBOX_DOCKER_IMAGE=ubuntu-debootstrap TOOLBOX_DOCKER_TAG=14.04 core@core-01 ~ $ toolbox Spawning container core-ubuntu-debootstrap-14.04 on /var/lib/toolbox/core-ubuntu-debootstrap-14.04. Press ^] three times within 1s to kill container. root@core-01:~# apt-get update && apt-get install tcpdump
Set an /etc/passwd entry for one of the users to /usr/bin/toolbox:
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
Please use the CoreOS issue tracker to report all bugs, issues, and feature requests.