Skip to content

Latest commit

 

History

History
92 lines (72 loc) · 3.35 KB

index.rst

File metadata and controls

92 lines (72 loc) · 3.35 KB
Raw

qemu-user-static (qus) and containers

.. only:: html

  .. centered::
    |SHIELD:GitHubRepo|
    |SHIELD:ContainerRegistry|
    |SHIELD:CommitsSince|
    |SHIELD:Citation|
    |SHIELD:GitterRoom|
    |SHIELD:WorkflowTest|
_static/logo/logo.png

Welcome to the Documentation of qemu-user-static and containers (qus)! Build and execute OCI images for foreign architectures using QEMU's user-mode emulation.

qus is a compilation of utilities, examples and references to build and execute OCI images :cite:p:`opencontainers` :cite:p:`w:opencontainers` :cite:p:`gh:opencontainers` (aka Docker :cite:p:`docker` :cite:p:`w:docker` :cite:p:`gh:docker` images) for foreign architectures, using QEMU's :cite:p:`bellard05` :cite:p:`qemu` :cite:p:`w:qemu` user-mode emulation.

Ready-to-use docker images are provided for each of seven host architectures officially supported by Docker, Inc. or built by official images :cite:p:`docker-official-images`:

  • amd64
  • i386
  • arm64v8
  • arm32v7
  • arm32v6
  • s390x
  • ppc64le

Multiple minimal working setups to build and execute arm64v8 containers on amd64 are configured and tested on Continuous Integration (CI) :cite:p:`w:continuousintegration` services (GitHub Actions :cite:p:`gha` :cite:p:`w:github`). The full flow is public, for other users to learn and adapt these resources to their needs. See github.com/dbhi/qus/actions.

These resources are tested on GNU/Linux and Windows 10 (Docker Desktop). Contributions to test them on other host OSs are welcome!

.. toctree::
   :hidden:

   intro
   context
   images
   tests
   development
   faq
   related
   references