/** * @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 type { JsonVersions } from '../lib/commands/version'; import { run as oclifRun } from '@oclif/dev-cli'; import * as archiver from 'archiver'; import * as Bluebird from 'bluebird'; import { execFile } from 'child_process'; import * as filehound from 'filehound'; import * as fs from 'fs-extra'; import * as _ from 'lodash'; import * as path from 'path'; import * as rimraf from 'rimraf'; import * as semver from 'semver'; import * as util from 'util'; import { stripIndent } from '../lib/utils/lazy'; import { diffLines, getSubprocessStdout, loadPackageJson, MSYS2_BASH, ROOT, StdOutTap, whichSpawn, } from './utils'; export const packageJSON = loadPackageJson(); export const version = 'v' + packageJSON.version; const arch = process.arch; function dPath(...paths: string[]) { return path.join(ROOT, 'dist', ...paths); } interface PathByPlatform { [platform: string]: string; } const standaloneZips: PathByPlatform = { linux: dPath(`balena-cli-${version}-linux-${arch}-standalone.zip`), darwin: dPath(`balena-cli-${version}-macOS-${arch}-standalone.zip`), win32: dPath(`balena-cli-${version}-windows-${arch}-standalone.zip`), }; const oclifInstallers: PathByPlatform = { darwin: dPath('macos', `balena-${version}.pkg`), win32: dPath('win', `balena-${version}-${arch}.exe`), }; const renamedOclifInstallers: PathByPlatform = { darwin: dPath(`balena-cli-${version}-macOS-${arch}-installer.pkg`), win32: dPath(`balena-cli-${version}-windows-${arch}-installer.exe`), }; export const finalReleaseAssets: { [platform: string]: string[] } = { win32: [standaloneZips['win32'], renamedOclifInstallers['win32']], darwin: [standaloneZips['darwin'], renamedOclifInstallers['darwin']], linux: [standaloneZips['linux']], }; /** * Given the output of `pkg` as a string (containing warning messages), * diff it against previously saved output of known "safe" warnings. * Throw an error if the diff is not empty. */ async function diffPkgOutput(pkgOut: string) { const { monochrome } = await import('../tests/helpers'); const relSavedPath = path.join( 'tests', 'test-data', 'pkg', `expected-warnings-${process.platform}.txt`, ); const absSavedPath = path.join(ROOT, relSavedPath); const ignoreStartsWith = [ '> pkg@', '> Fetching base Node.js binaries', ' fetched-', ]; const modulesRE = process.platform === 'win32' ? /(?<=[ '])([A-Z]:)?\\.+?\\node_modules(?=\\)/ : /(?<=[ '])\/.+?\/node_modules(?=\/)/; const buildRE = process.platform === 'win32' ? /(?<=[ '])([A-Z]:)?\\.+\\build(?=\\)/ : /(?<=[ '])\/.+\/build(?=\/)/; const cleanLines = (chunks: string | string[]) => { const lines = typeof chunks === 'string' ? chunks.split('\n') : chunks; return lines .map((line: string) => monochrome(line)) // remove ASCII colors .filter((line: string) => !/^\s*$/.test(line)) // blank lines .filter((line: string) => ignoreStartsWith.every((i) => !line.startsWith(i)), ) .map((line: string) => { // replace absolute paths with relative paths let replaced = line.replace(modulesRE, 'node_modules'); if (replaced === line) { replaced = line.replace(buildRE, 'build'); } return replaced; }); }; pkgOut = cleanLines(pkgOut).join('\n'); const { readFile } = (await import('fs')).promises; const expectedOut = cleanLines(await readFile(absSavedPath, 'utf8')).join( '\n', ); if (expectedOut !== pkgOut) { const sep = '================================================================================'; const diff = diffLines(expectedOut, pkgOut); const msg = `pkg output does not match expected output from "${relSavedPath}" Diff: ${sep} ${diff} ${sep} Check whether the new or changed pkg warnings are safe to ignore, then update "${relSavedPath}" and share the result of your investigation as comments on the pull request. Hint: the fix is often a matter of updating the 'pkg.scripts' or 'pkg.assets' sections in the CLI's 'package.json' file, or a matter of updating the 'buildPkg' function in 'automation/build-bin.ts'. Sometimes it requires patching dependencies: See for example 'patches/all/open+7.0.2.patch'. ${sep} `; throw new Error(msg); } } /** * Call `pkg.exec` to generate the standalone zip file, capturing its warning * messages (stdout and stderr) in order to call diffPkgOutput(). */ async function execPkg(...args: any[]) { const { exec: pkgExec } = await import('pkg'); const outTap = new StdOutTap(true); try { outTap.tap(); await (pkgExec as any)(...args); } catch (err) { outTap.untap(); console.log(outTap.stdoutBuf.join('')); console.error(outTap.stderrBuf.join('')); throw err; } outTap.untap(); await diffPkgOutput(outTap.allBuf.join('')); } /** * Use the 'pkg' module to create a single large executable file with * the contents of 'node_modules' and the CLI's javascript code. * Also copy a number of native modules (binary '.node' files) that are * compiled during 'npm install' to the 'build-bin' folder, alongside * the single large executable file created by pkg. (This is necessary * because of a pkg limitation that does not allow binary executables * to be directly executed from inside another binary executable.) */ async function buildPkg() { const args = [ '--target', 'host', '--output', 'build-bin/balena', 'package.json', ]; console.log('======================================================='); console.log(`execPkg ${args.join(' ')}`); console.log(`cwd="${process.cwd()}" ROOT="${ROOT}"`); console.log('======================================================='); await execPkg(args); const paths: Array<[string, string[], string[]]> = [ // [platform, [source path], [destination path]] ['*', ['open', 'xdg-open'], ['xdg-open']], ['*', ['opn', 'xdg-open'], ['xdg-open-402']], ['darwin', ['denymount', 'bin', 'denymount'], ['denymount']], ]; await Promise.all( paths.map(([platform, source, dest]) => { if (platform === '*' || platform === process.platform) { // eg copy from node_modules/open/xdg-open to build-bin/xdg-open return fs.copy( path.join(ROOT, 'node_modules', ...source), path.join(ROOT, 'build-bin', ...dest), ); } }), ); const nativeExtensionPaths: string[] = await filehound .create() .paths(path.join(ROOT, 'node_modules')) .ext(['node', 'dll']) .find(); console.log(`\nCopying to build-bin:\n${nativeExtensionPaths.join('\n')}`); await Promise.all( nativeExtensionPaths.map((extPath) => fs.copy( extPath, extPath.replace( path.join(ROOT, 'node_modules'), path.join(ROOT, 'build-bin'), ), ), ), ); } /** * Run some basic tests on the built pkg executable. * TODO: test more than just `balena version -j`; integrate with the * existing mocha/chai CLI command testing. */ async function testPkg() { const pkgBalenaPath = path.join( ROOT, 'build-bin', process.platform === 'win32' ? 'balena.exe' : 'balena', ); console.log(`Testing standalone package "${pkgBalenaPath}"...`); // Run `balena version -j`, parse its stdout as JSON, and check that the // reported Node.js major version matches semver.major(process.version) const stdout = await getSubprocessStdout(pkgBalenaPath, ['version', '-j']); let pkgNodeVersion = ''; let pkgNodeMajorVersion = 0; try { const balenaVersions: JsonVersions = JSON.parse(stdout); pkgNodeVersion = balenaVersions['Node.js']; pkgNodeMajorVersion = semver.major(pkgNodeVersion); } catch (err) { throw new Error(stripIndent` Error parsing JSON output of "balena version -j": ${err} Original output: "${stdout}"`); } if (semver.major(process.version) !== pkgNodeMajorVersion) { throw new Error( `Mismatched major version: built-in pkg Node version="${pkgNodeVersion}" vs process.version="${process.version}"`, ); } console.log('Success! (standalone package test successful)'); } /** * Create the zip file for the standalone 'pkg' bundle previously created * by the buildPkg() function in 'build-bin.ts'. */ async function zipPkg() { const outputFile = standaloneZips[process.platform]; if (!outputFile) { throw new Error( `Standalone installer unavailable for platform "${process.platform}"`, ); } await fs.mkdirp(path.dirname(outputFile)); await new Promise((resolve, reject) => { console.log(`Zipping standalone package to "${outputFile}"...`); const archive = archiver('zip', { zlib: { level: 7 }, }); archive.directory(path.join(ROOT, 'build-bin'), 'balena-cli'); const outputStream = fs.createWriteStream(outputFile); outputStream.on('close', resolve); outputStream.on('error', reject); archive.on('error', reject); archive.on('warning', console.warn); archive.pipe(outputStream); archive.finalize(); }); } export async function buildStandaloneZip() { console.log(`Building standalone zip package for CLI ${version}`); try { await buildPkg(); await testPkg(); await zipPkg(); console.log(`Standalone zip package build completed`); } catch (error) { console.error(`Error creating or testing standalone zip package`); throw error; } } async function renameInstallerFiles() { if (await fs.pathExists(oclifInstallers[process.platform])) { await fs.rename( oclifInstallers[process.platform], renamedOclifInstallers[process.platform], ); } } /** * If the CSC_LINK and CSC_KEY_PASSWORD env vars are set, digitally sign the * executable installer by running the balena-io/scripts/shared/sign-exe.sh * script (which must be in the PATH) using a MSYS2 bash shell. */ async function signWindowsInstaller() { if (process.env.CSC_LINK && process.env.CSC_KEY_PASSWORD) { const exeName = renamedOclifInstallers[process.platform]; const execFileAsync = util.promisify(execFile); console.log(`Signing installer "${exeName}"`); await execFileAsync(MSYS2_BASH, [ 'sign-exe.sh', '-f', exeName, '-d', `balena-cli ${version}`, ]); } else { console.log( 'Skipping installer signing step because CSC_* env vars are not set', ); } } /** * Run the `oclif-dev pack:win` or `pack:macos` command (depending on the value * of process.platform) to generate the native installers (which end up under * the 'dist' folder). There are some harcoded options such as selecting only * 64-bit binaries under Windows. */ export async function buildOclifInstaller() { let packOS = ''; let packOpts = ['-r', ROOT]; if (process.platform === 'darwin') { packOS = 'macos'; } else if (process.platform === 'win32') { packOS = 'win'; packOpts = packOpts.concat('-t', 'win32-x64'); } if (packOS) { console.log(`Building oclif installer for CLI ${version}`); const packCmd = `pack:${packOS}`; const dirs = [path.join(ROOT, 'dist', packOS)]; if (packOS === 'win') { dirs.push(path.join(ROOT, 'tmp', 'win*')); } for (const dir of dirs) { console.log(`rimraf(${dir})`); await Bluebird.fromCallback((cb) => rimraf(dir, cb)); } console.log('======================================================='); console.log(`oclif-dev "${packCmd}" "${packOpts.join('" "')}"`); console.log(`cwd="${process.cwd()}" ROOT="${ROOT}"`); console.log('======================================================='); await oclifRun([packCmd].concat(...packOpts)); await renameInstallerFiles(); // The Windows installer is explicitly signed here (oclif doesn't do it). // The macOS installer is automatically signed by oclif (which runs the // `pkgbuild` tool), using the certificate name given in package.json // (`oclif.macos.sign` section). if (process.platform === 'win32') { await signWindowsInstaller(); } console.log(`oclif installer build completed`); } } /** * Wrapper around the npm `catch-uncommitted` package in order to run it * conditionally, only when: * - A CI env var is set (CI=true), and * - The OS is not Windows. (`catch-uncommitted` fails on Windows) */ export async function catchUncommitted(): Promise { if (process.env.DEBUG) { console.error(`[debug] CI=${process.env.CI} platform=${process.platform}`); } if ( process.env.CI && ['true', 'yes', '1'].includes(process.env.CI.toLowerCase()) && process.platform !== 'win32' ) { await whichSpawn('npx', [ 'catch-uncommitted', '--catch-no-git', '--skip-node-versionbot-changes', '--ignore-space-at-eol', ]); } } export async function testShrinkwrap(): Promise { if (process.env.DEBUG) { console.error(`[debug] platform=${process.platform}`); } if (process.platform !== 'win32') { await whichSpawn(path.resolve(__dirname, 'test-lock-deduplicated.sh')); } }