| commit | c164c4d9b90c35fdf950ac2f1d8323d53bb5df74 | [log] [tgz] |
|---|---|---|
| author | Dexter Rivera <riverade@google.com> | Fri Oct 18 18:30:49 2024 +0000 |
| committer | Dexter Rivera <riverade@google.com> | Mon Oct 21 15:33:09 2024 +0000 |
| tree | 0268471cd8fda9d18304b4466b79ae8f4a870d1b | |
| parent | 7b4c0d34cf56f99d5287d939e96f786e2e1421a7 [diff] |
Make toolbox compatible with TPC The toolbox script on the image will detect if the image is running in TPC. If it is running in TPC, pull the toolbox container from the in-universe artifact registry repository. BUG=b/352136305 TEST=Installed and ran script in TPC and GDU instance RELEASE_NOTE=None Change-Id: Ia45a46d2c415a0ed62a763d4ad44031e7c8a879c
toolbox is a small script that launches a container to let you bring in your favorite debugging or admin tools.
$ /usr/bin/toolbox Spawning container core-fedora-latest on /var/lib/toolbox/core-fedora-latest. Press ^] three times within 1s to kill container. -bash-4.3# yum install tcpdump ... -bash-4.3# 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
Now when SSHing into the system as that user, toolbox will automatically be started:
$ ssh bob@hostname.example.com CoreOS alpha (633.1.0) ... Spawning container core-fedora-latest on /var/lib/toolbox/core-fedora-latest. -bash-4.3 # yum install emacs -bash-4.3 # emacs /media/root/etc/systemd/system/docker.service
Please use the CoreOS issue tracker to report all bugs, issues, and feature requests.