gvisor/content/docs/user_guide/compatibility/_index.md

90 lines
2.8 KiB
Markdown
Raw Normal View History

2019-03-30 02:40:11 +00:00
+++
title = "Compatibility"
weight = 100
+++
gVisor implements a large portion of the Linux surface and while we strive to
make it broadly compatible, there are (and always will be) unimplemented
features and bugs. The only real way to know if it will work is to try. If you
find a container that doesnt work and there is no known issue, please [file a
bug][bug] indicating the full command you used to run the image. You can view
open issues related to compatibility [here][issues].
2019-03-30 02:40:11 +00:00
If you're able to provide the [debug logs](../debugging/), the
problem likely to be fixed much faster.
## What works?
The following applications/images have been tested:
* elasticsearch
* golang
* httpd
* java8
* jenkins
* mariadb
* memcached
* mongo
* mysql
* nginx
* node
* php
* postgres
* prometheus
* python
* redis
* registry
* tomcat
* wordpress
2019-08-27 17:14:25 +00:00
## Utilities
2019-08-27 22:55:33 +00:00
Most common utilities work. Note that:
* Some tools, such as `tcpdump` and old versions of `ping`, require explicitly
enabling raw sockets via the unsafe `--net-raw` runsc flag.
* Different Docker images can behave differently. For example, Alpine Linux and
Ubuntu have different `ip` binaries.
Specific tools include:
2019-08-26 23:30:08 +00:00
| Tool | Status |
| --- | --- |
2019-08-27 17:14:25 +00:00
| apt-get | Working |
| bundle | Working |
| cat | Working |
2019-08-26 23:30:08 +00:00
| curl | Working |
2019-08-27 17:14:25 +00:00
| dd | Working |
| df | Working |
2019-08-26 23:30:08 +00:00
| dig | Working |
| drill | Working |
2019-08-27 17:14:25 +00:00
| env | Working |
| find | Working |
2019-08-26 23:30:08 +00:00
| gdb | Working |
2019-08-27 17:14:25 +00:00
| gosu | Working |
| grep | Working (unless stdin is a pipe and stdout is /dev/null) |
2020-03-10 22:24:00 +00:00
| ifconfig | Works partially, like ip. Full support [in progress](https://gvisor.dev/issue/578) |
| ip | Some subcommands work (e.g. addr, route). Full support [in progress](https://gvisor.dev/issue/578) |
2019-08-27 17:14:25 +00:00
| less | Working |
| ls | Working |
2019-08-26 23:30:08 +00:00
| lsof | Working |
2019-08-27 17:14:25 +00:00
| mount | Works in readonly mode. gVisor doesn't currently support creating new mounts at runtime |
2019-08-26 23:30:08 +00:00
| nc | Working |
2019-08-27 17:26:47 +00:00
| nmap | Not working |
2020-03-10 22:24:00 +00:00
| netstat | [In progress](https://gvisor.dev/issue/2112) |
2019-08-26 23:30:08 +00:00
| nslookup | Working |
| ping | Working |
| ps | Working |
2020-03-10 22:24:00 +00:00
| route | Working |
| ss | [In progress](https://gvisor.dev/issue/2114) |
| sshd | Partially working. Job control [in progress](https://gvisor.dev/issue/154) |
2019-08-27 17:14:25 +00:00
| strace | Working |
| tar | Working |
2020-03-10 22:24:00 +00:00
| tcpdump | [In progress](https://gvisor.dev/issue/173) |
2019-08-26 23:30:08 +00:00
| top | Working |
2019-08-27 17:14:25 +00:00
| uptime | Working |
| vim | Working |
2019-08-26 23:30:08 +00:00
| wget | Working |
[bug]: https://github.com/google/gvisor/issues/new?title=Compatibility%20Issue:
[issues]: https://github.com/google/gvisor/issues?q=is%3Aissue+is%3Aopen+label%3A%22area%3A+compatibility%22