diff --git a/NOTICE b/NOTICE deleted file mode 100644 index b39ddfa..0000000 --- a/NOTICE +++ /dev/null @@ -1,5 +0,0 @@ -CoreOS Project -Copyright 2014 CoreOS, Inc - -This product includes software developed at CoreOS, Inc. -(http://www.coreos.com/). diff --git a/README.md b/README.md index 5c3cdde..e2ff36b 100644 --- a/README.md +++ b/README.md @@ -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. diff --git a/rhcos-toolbox b/rhcos-toolbox index 9273486..a1b59f2 100755 --- a/rhcos-toolbox +++ b/rhcos-toolbox @@ -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 diff --git a/rhcos-toolbox.spec b/rhcos-toolbox.spec deleted file mode 100644 index b2b40af..0000000 --- a/rhcos-toolbox.spec +++ /dev/null @@ -1,36 +0,0 @@ -Name: toolbox -Version: 0.0.1 -Release: 1%{?dist} -Summary: script to launch privileged container with podman - -License: ASLv2.0 -URL: https://github.com/coreos/toolbox -Source0: https://github.com/coreos/%{name}/archive/%{version}.tar.gz -Requires: podman - -%description -toolbox is a small script that launches a container to let -you bring in your favorite debugging or admin tools. - -%define debug_package %{nil} - -%prep -%autosetup - -%build -# No building required - -%install -rm -rf $RPM_BUILD_ROOT -install -d $RPM_BUILD_ROOT/%{_bindir} -install -m 755 rhcos-toolbox $RPM_BUILD_ROOT/%{_bindir}/toolbox - -%files -%license LICENSE -%doc README.md NOTICE -%{_bindir}/toolbox - - -%changelog -* Thu Sep 6 2018 Yu Qi Zhang - 0.0.1 -- Initial Specfile for Red Hat CoreOS Toolbox