mirror of
https://github.com/balena-io/balena-cli.git
synced 2024-12-23 07:22:22 +00:00
19c3178062
E.g. "balena build -e -h <IP> -p 2375" with the CLI running on a Mac laptop, using balenaEngine on an Intel NUC device, building an image for the RPi (ARM image arch). Previously, QEMU setup by the CLI assumed that docker ran on the same OS as the CLI (Docker for Mac has built-in binfmt_misc support and does not require additional setup, but balenaEngine on Linux requires explicit QEMU setup.) Change-type: minor Signed-off-by: Paulo Castro <paulo@balena.io>
62 lines
2.2 KiB
TypeScript
62 lines
2.2 KiB
TypeScript
/**
|
|
* @license
|
|
* Copyright 2019 Balena Ltd.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
import Dockerode = require('dockerode');
|
|
|
|
import Logger = require('./logger');
|
|
import { getQemuPath, installQemu } from './qemu';
|
|
|
|
export { QEMU_BIN_NAME } from './qemu';
|
|
export * from './qemu';
|
|
|
|
export async function installQemuIfNeeded(
|
|
emulated: boolean,
|
|
logger: Logger,
|
|
arch: string,
|
|
docker: Dockerode,
|
|
): Promise<boolean> {
|
|
if (!emulated || !(await platformNeedsQemu(docker))) {
|
|
return false;
|
|
}
|
|
const fs = await import('mz/fs');
|
|
if (!(await fs.exists(await getQemuPath(arch)))) {
|
|
logger.logInfo(`Installing qemu for ${arch} emulation...`);
|
|
await installQemu(arch);
|
|
}
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Check whether the Docker daemon (including balenaEngine) requires explicit
|
|
* QEMU emulation setup. Note that Docker for Mac (macOS), and reportedly also
|
|
* Docker for Windows, have built-in support for binfmt_misc, so do not require
|
|
* explicity QEMU setup. References:
|
|
* - https://en.wikipedia.org/wiki/Binfmt_misc
|
|
* - https://docs.docker.com/docker-for-mac/multi-arch/
|
|
* - https://www.ecliptik.com/Cross-Building-and-Running-Multi-Arch-Docker-Images/
|
|
* - https://stackoverflow.com/questions/55388725/run-linux-arm-container-via-qemu-binfmt-misc-on-docker-lcow
|
|
*
|
|
* @param docker Dockerode instance
|
|
*/
|
|
async function platformNeedsQemu(docker: Dockerode): Promise<boolean> {
|
|
const dockerInfo = await docker.info();
|
|
// Docker for Mac reports dockerInfo.OSType as 'linux'
|
|
// https://stackoverflow.com/questions/38223965/how-can-i-detect-if-docker-for-mac-is-installed
|
|
const isDockerForMac = /Docker for Mac/i.test(dockerInfo.OperatingSystem);
|
|
return dockerInfo.OSType === 'linux' && !isDockerForMac;
|
|
}
|