mirror of
https://github.com/balena-os/balena-supervisor.git
synced 2024-12-20 06:07:57 +00:00
279 lines
9.0 KiB
TypeScript
279 lines
9.0 KiB
TypeScript
import { promises as fs } from 'fs';
|
|
import { stripIndent } from 'common-tags';
|
|
import { SinonStub, spy, stub } from 'sinon';
|
|
import { expect } from 'chai';
|
|
|
|
import * as fsUtils from '~/lib/fs-utils';
|
|
import Log from '~/lib/supervisor-console';
|
|
import { ExtraUEnv } from '~/src/config/backends/extra-uEnv';
|
|
|
|
describe('extra_uEnv Configuration', () => {
|
|
const backend = new ExtraUEnv();
|
|
let readFileStub: SinonStub;
|
|
|
|
beforeEach(() => {
|
|
readFileStub = stub(fs, 'readFile');
|
|
});
|
|
|
|
afterEach(() => {
|
|
readFileStub.restore();
|
|
});
|
|
|
|
it('should parse extra_uEnv string', () => {
|
|
const fileContents = stripIndent`\
|
|
custom_fdt_file=mycustom.dtb
|
|
extra_os_cmdline=isolcpus=3,4 splash console=tty0
|
|
`;
|
|
// @ts-expect-error accessing private method
|
|
const parsed = ExtraUEnv.parseOptions(fileContents);
|
|
expect(parsed).to.deep.equal({
|
|
fdt: 'mycustom.dtb',
|
|
isolcpus: '3,4',
|
|
splash: '',
|
|
console: 'tty0',
|
|
});
|
|
});
|
|
|
|
it('should only parse supported configuration options from bootConfigPath', async () => {
|
|
readFileStub.resolves(stripIndent`\
|
|
custom_fdt_file=mycustom.dtb
|
|
extra_os_cmdline=isolcpus=3,4
|
|
`);
|
|
|
|
await expect(backend.getBootConfig()).to.eventually.deep.equal({
|
|
fdt: 'mycustom.dtb',
|
|
isolcpus: '3,4',
|
|
});
|
|
|
|
// Add other options that will get filtered out because they aren't supported
|
|
readFileStub.resolves(stripIndent`\
|
|
custom_fdt_file=mycustom.dtb
|
|
extra_os_cmdline=isolcpus=3,4 console=tty0 splash
|
|
`);
|
|
|
|
await expect(backend.getBootConfig()).to.eventually.deep.equal({
|
|
fdt: 'mycustom.dtb',
|
|
isolcpus: '3,4',
|
|
});
|
|
|
|
// Stub with no supported values
|
|
readFileStub.resolves(stripIndent`\
|
|
fdt=something_else
|
|
isolcpus
|
|
123.12=5
|
|
`);
|
|
|
|
await expect(backend.getBootConfig()).to.eventually.deep.equal({});
|
|
});
|
|
|
|
it('only matches supported devices', async () => {
|
|
const existsStub = stub(fsUtils, 'exists');
|
|
for (const device of MATCH_TESTS) {
|
|
// Test device that has extra_uEnv.txt
|
|
let hasExtraUEnv = true;
|
|
existsStub.resolves(hasExtraUEnv);
|
|
await expect(backend.matches(device.type)).to.eventually.equal(
|
|
device.supported && hasExtraUEnv,
|
|
);
|
|
// Test same device but without extra_uEnv.txt
|
|
hasExtraUEnv = false;
|
|
existsStub.resolves(hasExtraUEnv);
|
|
await expect(backend.matches(device.type)).to.eventually.equal(
|
|
device.supported && hasExtraUEnv,
|
|
);
|
|
}
|
|
existsStub.restore();
|
|
});
|
|
|
|
it('errors when cannot find extra_uEnv.txt', async () => {
|
|
// Stub readFile to reject much like if the file didn't exist
|
|
readFileStub.rejects();
|
|
await expect(backend.getBootConfig()).to.eventually.be.rejectedWith(
|
|
'Could not find extra_uEnv file. Device is possibly bricked',
|
|
);
|
|
});
|
|
|
|
it('logs warning for malformed extra_uEnv.txt', async () => {
|
|
spy(Log, 'warn');
|
|
for (const badConfig of MALFORMED_CONFIGS) {
|
|
// Stub bad config
|
|
readFileStub.resolves(badConfig.contents);
|
|
// Expect warning log from the given bad config
|
|
await backend.getBootConfig();
|
|
// @ts-expect-error
|
|
expect(Log.warn.lastCall?.lastArg).to.equal(badConfig.reason);
|
|
}
|
|
// @ts-expect-error
|
|
Log.warn.restore();
|
|
});
|
|
|
|
it('sets new config values', async () => {
|
|
stub(fsUtils, 'writeAndSyncFile').resolves();
|
|
const logWarningStub = spy(Log, 'warn');
|
|
|
|
// This config contains a value set from something else
|
|
// We to make sure the Supervisor is enforcing the source of truth (the cloud)
|
|
// So after setting new values this unsupported/not set value should be gone
|
|
readFileStub.resolves(stripIndent`\
|
|
extra_os_cmdline=rootwait isolcpus=3,4
|
|
other_service=set_this_value
|
|
`);
|
|
|
|
// Sets config with mix of supported and not supported values
|
|
await backend.setBootConfig({
|
|
fdt: '/boot/mycustomdtb.dtb',
|
|
isolcpus: '2',
|
|
console: 'tty0', // not supported so won't be set
|
|
});
|
|
|
|
expect(fsUtils.writeAndSyncFile).to.be.calledWith(
|
|
'test/data/mnt/boot/extra_uEnv.txt',
|
|
'custom_fdt_file=/boot/mycustomdtb.dtb\nextra_os_cmdline=isolcpus=2\n',
|
|
);
|
|
|
|
expect(logWarningStub.lastCall?.lastArg).to.equal(
|
|
'Not setting unsupported value: { console: tty0 }',
|
|
);
|
|
|
|
// Restore stubs
|
|
(fsUtils.writeAndSyncFile as SinonStub).restore();
|
|
logWarningStub.restore();
|
|
});
|
|
|
|
it('sets new config values containing collections', async () => {
|
|
stub(fsUtils, 'writeAndSyncFile').resolves();
|
|
const logWarningStub = spy(Log, 'warn');
|
|
|
|
// @ts-expect-error accessing private value
|
|
const previousSupportedConfigs = ExtraUEnv.supportedConfigs;
|
|
// Stub isSupportedConfig so we can confirm collections work
|
|
// @ts-expect-error accessing private value
|
|
ExtraUEnv.supportedConfigs = {
|
|
fdt: { key: 'custom_fdt_file', collection: false },
|
|
isolcpus: { key: 'extra_os_cmdline', collection: true },
|
|
console: { key: 'extra_os_cmdline', collection: true },
|
|
splash: { key: 'extra_os_cmdline', collection: true },
|
|
};
|
|
|
|
// Set config again
|
|
await backend.setBootConfig({
|
|
fdt: '/boot/mycustomdtb.dtb',
|
|
isolcpus: '2', // collection entry so should be concatted to other collections of this entry
|
|
console: 'tty0', // collection entry so should be concatted to other collections of this entry
|
|
splash: '', // collection entry so should be concatted to other collections of this entry
|
|
});
|
|
|
|
expect(fsUtils.writeAndSyncFile).to.be.calledWith(
|
|
'test/data/mnt/boot/extra_uEnv.txt',
|
|
'custom_fdt_file=/boot/mycustomdtb.dtb\nextra_os_cmdline=isolcpus=2 console=tty0 splash\n',
|
|
);
|
|
|
|
// Restore stubs
|
|
(fsUtils.writeAndSyncFile as SinonStub).restore();
|
|
logWarningStub.restore();
|
|
// @ts-expect-error accessing private value
|
|
ExtraUEnv.supportedConfigs = previousSupportedConfigs;
|
|
});
|
|
|
|
it('only allows supported configuration options', () => {
|
|
[
|
|
{ configName: 'fdt', supported: true },
|
|
{ configName: 'isolcpus', supported: true },
|
|
{ configName: 'custom_fdt_file', supported: false },
|
|
{ configName: 'splash', supported: false },
|
|
{ configName: '', supported: false },
|
|
].forEach(({ configName, supported }) =>
|
|
expect(backend.isSupportedConfig(configName)).to.equal(supported),
|
|
);
|
|
});
|
|
|
|
it('correctly detects boot config variables', () => {
|
|
[
|
|
{ config: 'HOST_EXTLINUX_isolcpus', valid: true },
|
|
{ config: 'HOST_EXTLINUX_fdt', valid: true },
|
|
{ config: 'HOST_EXTLINUX_rootwait', valid: true },
|
|
{ config: 'HOST_EXTLINUX_5', valid: true },
|
|
{ config: 'DEVICE_EXTLINUX_isolcpus', valid: false },
|
|
{ config: 'isolcpus', valid: false },
|
|
].forEach(({ config, valid }) =>
|
|
expect(backend.isBootConfigVar(config)).to.equal(valid),
|
|
);
|
|
});
|
|
|
|
it('converts variable to backend formatted name', () => {
|
|
[
|
|
{ input: 'HOST_EXTLINUX_isolcpus', output: 'isolcpus' },
|
|
{ input: 'HOST_EXTLINUX_fdt', output: 'fdt' },
|
|
{ input: 'HOST_EXTLINUX_', output: null },
|
|
{ input: 'value', output: null },
|
|
].forEach(({ input, output }) =>
|
|
expect(backend.processConfigVarName(input)).to.equal(output),
|
|
);
|
|
});
|
|
|
|
it('normalizes variable value', () => {
|
|
[{ input: { key: 'key', value: 'value' }, output: 'value' }].forEach(
|
|
({ input, output }) =>
|
|
expect(backend.processConfigVarValue(input.key, input.value)).to.equal(
|
|
output,
|
|
),
|
|
);
|
|
});
|
|
|
|
it('returns the environment name for config variable', () => {
|
|
[
|
|
{ input: 'isolcpus', output: 'HOST_EXTLINUX_isolcpus' },
|
|
{ input: 'fdt', output: 'HOST_EXTLINUX_fdt' },
|
|
{ input: 'rootwait', output: 'HOST_EXTLINUX_rootwait' },
|
|
{ input: '', output: null },
|
|
].forEach(({ input, output }) =>
|
|
expect(backend.createConfigVarName(input)).to.equal(output),
|
|
);
|
|
});
|
|
});
|
|
|
|
const MALFORMED_CONFIGS = [
|
|
{
|
|
contents: stripIndent`
|
|
custom_fdt_file=mycustom.dtb
|
|
extra_os_cmdline=isolcpus=3,4
|
|
another_value
|
|
`,
|
|
reason: 'Could not read extra_uEnv entry: another_value',
|
|
},
|
|
];
|
|
|
|
const MATCH_TESTS = [
|
|
{ type: 'astro-tx2', supported: true },
|
|
{ type: 'blackboard-tx2', supported: true },
|
|
{ type: 'jetson-tx2', supported: true },
|
|
{ type: 'n310-tx2', supported: true },
|
|
{ type: 'n510-tx2', supported: true },
|
|
{ type: 'orbitty-tx2', supported: true },
|
|
{ type: 'spacely-tx2', supported: true },
|
|
{ type: 'srd3-tx2', supported: true },
|
|
{ type: 'jetson-nano', supported: true },
|
|
{ type: 'jetson-nano-emmc', supported: true },
|
|
{ type: 'jn30b-nano', supported: true },
|
|
{ type: 'photon-nano', supported: true },
|
|
{ type: 'intel-nuc', supported: false },
|
|
{ type: 'raspberry', supported: false },
|
|
{ type: 'fincm3', supported: false },
|
|
{ type: 'asus-tinker-board', supported: false },
|
|
{ type: 'nano-board', supported: false },
|
|
{ type: 'jetson-nano-2gb-devkit', supported: true },
|
|
{ type: 'jetson-nano-2gb-devkit-emmc', supported: false },
|
|
{ type: 'tx2-tx2-device', supported: false },
|
|
{ type: 'jetson-tx2-nx-devkit', supported: true },
|
|
{ type: 'photon-tx2-nx', supported: true },
|
|
{ type: 'jetson-xavier-nx-devkit', supported: false },
|
|
{ type: 'photon-xavier-nx', supported: false },
|
|
{ type: 'imx8m-var-dart', supported: true },
|
|
{ type: 'imx8mm-var-dart', supported: true },
|
|
{ type: 'imx8mm-var-dart-nrt', supported: true },
|
|
{ type: 'imx8mm-var-dart-plt', supported: true },
|
|
{ type: 'imx8mm-var-som', supported: true },
|
|
{ type: 'imx8m-var-som', supported: false },
|
|
{ type: 'imx6ul-var-dart', supported: false },
|
|
];
|