[ARCHIVED repository] Toolbox has relocated to https://cos.googlesource.com/cos/tools.
Note: This is not an official Google product.
This is a Docker image used by the CoreOS Toolbox script on Container-Optimized OS. This image comes pre-installed with common debugging tools that are not pre-installed on the host.
The official toolbox container is available at gcr.io/cos-cloud/toolbox
.
Starting with tag 20190312-00
, COS toolbox includes a tool called
cos-kernel
to make it easy to fetch kernel headers, source, and
toolchain for COS releases. For example, the following command fetches
kernel headers, source, and toolchain for the instance it's running on:
my-cos-instance ~ $ toolbox
root@my-cos-instance:~# cos-kernel fetch
By default, cos-kernel
uses $HOME
as its install directory but this
can be changed via the --instdir
option. cos-kernel
copies the
files it fetches in the fetched-files
directory and extracts them into
cos-kernel-headers
, cos-kernel-src
, and cos-toolchain
.
root@my-cos-instance:~# ls -l
drwxr-xr-x 4 root root 4096 Mar 12 14:43 cos-kernel-headers
drwxr-xr-x 4 root root 4096 Mar 12 14:44 cos-kernel-src
drwxr-xr-x 4 root root 4096 Mar 12 14:43 cos-toolchain
drwxr-xr-x 4 root root 4096 Mar 12 14:40 fetched-files
The following command fetches kernel headers, source, and toolchain for
release 11636.0.0
and builds the kernel:
root@my-cos-instance:~# cos-kernel build 11636.0.0
To see the list of available subcommands and their options, type:
root@my-cos-instance:~# cos-kernel help
For detailed documentation on how this is used, see https://cloud.google.com/container-optimized-os/docs/how-to/toolbox.
To release a new version of COS Toolbox, tag the commit you want to release
with the date in the form of vYYYYMMDD
. This will trigger a Cloud Build job to
build and release the container image.