diff options
| author | Zuul <zuul@review.opendev.org> | 2024-03-28 16:29:14 +0000 |
|---|---|---|
| committer | Gerrit Code Review <review@openstack.org> | 2024-03-28 16:29:14 +0000 |
| commit | 95a671b00df7625a357aa73f99f75965cb08aff2 (patch) | |
| tree | 9fb3f5d6ba16da122e88f91730e79c7fc83a93f9 /doc/source | |
| parent | 2576fbde000484502e88b58d372b4c193341ed8b (diff) | |
| parent | 3ee1a82d8761902a75e075ccbcd8e9e02a226051 (diff) | |
| download | kolla-95a671b00df7625a357aa73f99f75965cb08aff2.tar.gz kolla-95a671b00df7625a357aa73f99f75965cb08aff2.zip | |
Merge "add: cross-compile support"
Diffstat (limited to 'doc/source')
| -rw-r--r-- | doc/source/admin/image-building.rst | 22 |
1 files changed, 22 insertions, 0 deletions
diff --git a/doc/source/admin/image-building.rst b/doc/source/admin/image-building.rst index f0c0e84c1..81e04f401 100644 --- a/doc/source/admin/image-building.rst +++ b/doc/source/admin/image-building.rst @@ -526,6 +526,28 @@ variables that will be picked up from the user env: Also these variables could be overwritten using ``--build-args``, which have precedence. +Cross-compiling +--------------- + +It is possible to cross-compile container images in order to, e.g., build +``aarch64`` images on a ``x86_64`` machine. + +To build ``ARM`` images on ``x86_64`` platform, pass the ``--base-arch`` and +``--platform`` arguments: + +.. code-block:: console + + kolla-build --platform linux/arm64 --base-arch aarch64 + +.. note:: + + To make this work on x86_64 platform you can use tools like: `qemu-user-static + <https://github.com/multiarch/qemu-user-static>`_ or `binfmt + <https://github.com/tonistiigi/binfmt>`_. + + To make this work on Apple Silicon you can use Docker Desktop or Podman + Desktop to build ``x86_64`` or native ``ARM`` images. + Known issues ============ |