423 lines
14 KiB
TypeScript
423 lines
14 KiB
TypeScript
/**
|
|
* Copyright 2023 actions-toolkit authors
|
|
*
|
|
* 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 fs from 'fs';
|
|
import path from 'path';
|
|
import * as core from '@actions/core';
|
|
import * as semver from 'semver';
|
|
|
|
import {Git} from '../buildkit/git.js';
|
|
import {Docker} from '../docker/docker.js';
|
|
import {GitHub} from '../github.js';
|
|
import {Exec} from '../exec.js';
|
|
import {Util} from '../util.js';
|
|
|
|
import {VertexWarning} from '../types/buildkit/client.js';
|
|
import {GitURL} from '../types/buildkit/git.js';
|
|
import {Cert, LocalRefsOpts, LocalRefsResponse, LocalState} from '../types/buildx/buildx.js';
|
|
import {GitHubAnnotation} from '../types/github.js';
|
|
|
|
export interface BuildxOpts {
|
|
standalone?: boolean;
|
|
}
|
|
|
|
export class Buildx {
|
|
private _version: string;
|
|
private _versionOnce: boolean;
|
|
private readonly _standalone: boolean | undefined;
|
|
|
|
public static readonly containerNamePrefix = 'buildx_buildkit_';
|
|
|
|
constructor(opts?: BuildxOpts) {
|
|
this._standalone = opts?.standalone;
|
|
this._version = '';
|
|
this._versionOnce = false;
|
|
}
|
|
|
|
static get configDir(): string {
|
|
return process.env.BUILDX_CONFIG || path.join(Docker.configDir, 'buildx');
|
|
}
|
|
|
|
static get refsDir(): string {
|
|
return path.join(Buildx.configDir, 'refs');
|
|
}
|
|
|
|
static get refsGroupDir(): string {
|
|
return path.join(Buildx.refsDir, '__group__');
|
|
}
|
|
|
|
static get certsDir(): string {
|
|
return path.join(Buildx.configDir, 'certs');
|
|
}
|
|
|
|
public async isStandalone(): Promise<boolean> {
|
|
const standalone = this._standalone ?? !(await Docker.isAvailable());
|
|
core.debug(`Buildx.isStandalone: ${standalone}`);
|
|
return standalone;
|
|
}
|
|
|
|
public async getCommand(args: Array<string>) {
|
|
const standalone = await this.isStandalone();
|
|
return {
|
|
command: standalone ? 'buildx' : 'docker',
|
|
args: standalone ? args : ['buildx', ...args]
|
|
};
|
|
}
|
|
|
|
public async isAvailable(): Promise<boolean> {
|
|
const cmd = await this.getCommand([]);
|
|
|
|
const ok: boolean = await Exec.getExecOutput(cmd.command, cmd.args, {
|
|
ignoreReturnCode: true,
|
|
silent: true
|
|
})
|
|
.then(res => {
|
|
if (res.stderr.length > 0 && res.exitCode != 0) {
|
|
core.debug(`Buildx.isAvailable cmd err: ${res.stderr.trim()}`);
|
|
return false;
|
|
}
|
|
return res.exitCode == 0;
|
|
})
|
|
.catch(error => {
|
|
core.debug(`Buildx.isAvailable error: ${error}`);
|
|
return false;
|
|
});
|
|
|
|
core.debug(`Buildx.isAvailable: ${ok}`);
|
|
return ok;
|
|
}
|
|
|
|
public async version(): Promise<string> {
|
|
if (this._versionOnce) {
|
|
return this._version;
|
|
}
|
|
this._versionOnce = true;
|
|
const cmd = await this.getCommand(['version']);
|
|
this._version = await Exec.getExecOutput(cmd.command, cmd.args, {
|
|
ignoreReturnCode: true,
|
|
silent: true
|
|
}).then(res => {
|
|
if (res.stderr.length > 0 && res.exitCode != 0) {
|
|
throw new Error(res.stderr.trim());
|
|
}
|
|
return Buildx.parseVersion(res.stdout.trim());
|
|
});
|
|
return this._version;
|
|
}
|
|
|
|
public async printVersion() {
|
|
const cmd = await this.getCommand(['version']);
|
|
await Exec.exec(cmd.command, cmd.args, {
|
|
failOnStdErr: false
|
|
});
|
|
}
|
|
|
|
public static parseVersion(stdout: string): string {
|
|
const matches = /\sv?([0-9a-f]{7}|[0-9.]+)/.exec(stdout);
|
|
if (!matches) {
|
|
throw new Error(`Cannot parse buildx version`);
|
|
}
|
|
return matches[1];
|
|
}
|
|
|
|
public async versionSatisfies(range: string, version?: string): Promise<boolean> {
|
|
const ver = version ?? (await this.version());
|
|
if (!ver) {
|
|
core.debug(`Buildx.versionSatisfies false: undefined version`);
|
|
return false;
|
|
}
|
|
const res = semver.satisfies(ver, range) || /^[0-9a-f]{7}$/.exec(ver) !== null;
|
|
core.debug(`Buildx.versionSatisfies ${ver} statisfies ${range}: ${res}`);
|
|
return res;
|
|
}
|
|
|
|
public static resolveCertsDriverOpts(driver: string, endpoint: string, cert: Cert): Array<string> {
|
|
let url: URL;
|
|
try {
|
|
url = new URL(endpoint);
|
|
} catch {
|
|
return [];
|
|
}
|
|
if (url.protocol != 'tcp:') {
|
|
return [];
|
|
}
|
|
const driverOpts: Array<string> = [];
|
|
if (Object.keys(cert).length == 0) {
|
|
return driverOpts;
|
|
}
|
|
let host = url.hostname;
|
|
if (url.port.length > 0) {
|
|
host += `-${url.port}`;
|
|
}
|
|
if (cert.cacert !== undefined) {
|
|
const cacertpath = path.join(Buildx.certsDir, `cacert_${host}.pem`);
|
|
fs.writeFileSync(cacertpath, cert.cacert);
|
|
driverOpts.push(`cacert=${cacertpath}`);
|
|
}
|
|
if (cert.cert !== undefined) {
|
|
const certpath = path.join(Buildx.certsDir, `cert_${host}.pem`);
|
|
fs.writeFileSync(certpath, cert.cert);
|
|
driverOpts.push(`cert=${certpath}`);
|
|
}
|
|
if (cert.key !== undefined) {
|
|
const keypath = path.join(Buildx.certsDir, `key_${host}.pem`);
|
|
fs.writeFileSync(keypath, cert.key);
|
|
driverOpts.push(`key=${keypath}`);
|
|
}
|
|
if (driver != 'remote') {
|
|
return [];
|
|
}
|
|
return driverOpts;
|
|
}
|
|
|
|
public static localState(ref: string, dir?: string): LocalState {
|
|
const [builderName, nodeName, id] = ref.split('/');
|
|
if (!builderName || !nodeName || !id) {
|
|
throw new Error(`Invalid build reference: ${ref}`);
|
|
}
|
|
const lsPath = path.join(dir || Buildx.refsDir, builderName, nodeName, id);
|
|
if (!fs.existsSync(lsPath)) {
|
|
throw new Error(`Local state not found in ${lsPath}`);
|
|
}
|
|
return Buildx.fixLocalState(<LocalState>JSON.parse(fs.readFileSync(lsPath, 'utf8')));
|
|
}
|
|
|
|
// https://github.com/docker/buildx/pull/2560
|
|
private static fixLocalState(ls: LocalState): LocalState {
|
|
const fnTrimToValidContext = function (inp: string): [string, string, boolean] {
|
|
const match = inp.match(/(.*)(https?:\/{1,2}\S+|ssh:\/{1,2}\S+|git:\/{1,2}\S+)/i);
|
|
if (match && match.length == 3) {
|
|
const trimed = match[1];
|
|
let url = match[2];
|
|
if (url.startsWith('https:/') && !url.startsWith('https://')) {
|
|
url = url.replace('https:/', 'https://');
|
|
}
|
|
if (url.startsWith('http:/') && !url.startsWith('http://')) {
|
|
url = url.replace('http:/', 'http://');
|
|
}
|
|
if (url.startsWith('ssh:/') && !url.startsWith('ssh://')) {
|
|
url = url.replace('ssh:/', 'ssh://');
|
|
}
|
|
if (url.startsWith('git:/') && !url.startsWith('git://')) {
|
|
url = url.replace('git:/', 'git://');
|
|
}
|
|
return [url, trimed, true];
|
|
}
|
|
return [inp, '', false];
|
|
};
|
|
|
|
const [contextPath, trimedPath, isURL] = fnTrimToValidContext(ls.LocalPath);
|
|
if (isURL) {
|
|
ls.LocalPath = contextPath;
|
|
if (ls.DockerfilePath.indexOf(trimedPath) === 0) {
|
|
ls.DockerfilePath = ls.DockerfilePath.substring(trimedPath.length);
|
|
}
|
|
}
|
|
ls.LocalPath = ls.LocalPath.endsWith('/-') ? '-' : ls.LocalPath;
|
|
ls.DockerfilePath = ls.DockerfilePath.endsWith('/-') ? '-' : ls.DockerfilePath;
|
|
return ls;
|
|
}
|
|
|
|
public static refs(opts: LocalRefsOpts, refs: LocalRefsResponse = {}): LocalRefsResponse {
|
|
const {dir, builderName, nodeName, since} = opts;
|
|
|
|
let dirpath = path.resolve(dir);
|
|
if (opts.builderName) {
|
|
dirpath = path.join(dirpath, opts.builderName);
|
|
}
|
|
if (opts.nodeName) {
|
|
dirpath = path.join(dirpath, opts.nodeName);
|
|
}
|
|
if (!fs.existsSync(dirpath)) {
|
|
return refs;
|
|
}
|
|
|
|
const files = fs.readdirSync(dirpath);
|
|
for (const file of files) {
|
|
const filePath = path.join(dirpath, file);
|
|
const stat = fs.statSync(filePath);
|
|
if (stat.isDirectory()) {
|
|
const nopts: LocalRefsOpts = {...opts};
|
|
if (!builderName) {
|
|
if (file === '__group__') {
|
|
continue;
|
|
}
|
|
nopts.builderName = file;
|
|
} else if (!nodeName) {
|
|
nopts.nodeName = file;
|
|
}
|
|
Buildx.refs(nopts, refs);
|
|
} else {
|
|
if (since && stat.mtime < since) {
|
|
continue;
|
|
}
|
|
const localState = Buildx.fixLocalState(<LocalState>JSON.parse(fs.readFileSync(filePath, 'utf8')));
|
|
const ref = `${builderName}/${nodeName}/${file}`;
|
|
refs[ref] = localState;
|
|
}
|
|
}
|
|
|
|
return refs;
|
|
}
|
|
|
|
public static async convertWarningsToGitHubAnnotations(warnings: Array<VertexWarning>, buildRefs: Array<string>, refsDir?: string): Promise<Array<GitHubAnnotation> | undefined> {
|
|
if (warnings.length === 0) {
|
|
return;
|
|
}
|
|
const fnGitURL = function (inp: string): GitURL | undefined {
|
|
try {
|
|
return Git.parseURL(inp);
|
|
} catch {
|
|
// noop
|
|
}
|
|
};
|
|
const fnLocalState = function (ref: string): LocalState | undefined {
|
|
try {
|
|
return Buildx.localState(ref, refsDir);
|
|
} catch (e) {
|
|
core.debug(`Buildx.convertWarningsToGitHubAnnotations(${ref}): local state not found: ${e.message}`);
|
|
}
|
|
};
|
|
|
|
interface Dockerfile {
|
|
path: string;
|
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
content?: any;
|
|
remote?: boolean;
|
|
}
|
|
|
|
const dockerfiles: Array<Dockerfile> = [];
|
|
for (const ref of buildRefs) {
|
|
const ls = fnLocalState(ref);
|
|
if (!ls) {
|
|
continue;
|
|
}
|
|
|
|
if (ls.DockerfilePath == '-') {
|
|
// exclude dockerfile from stdin
|
|
core.debug(`Buildx.convertWarningsToGitHubAnnotations(${ref}): skipping stdin Dockerfile`);
|
|
continue;
|
|
} else if (ls.DockerfilePath == '') {
|
|
ls.DockerfilePath = 'Dockerfile';
|
|
}
|
|
|
|
const gitURL = fnGitURL(ls.LocalPath);
|
|
if (gitURL) {
|
|
core.debug(`Buildx.convertWarningsToGitHubAnnotations(${ref}): git context detected: ${ls.LocalPath}`);
|
|
const remoteHost = gitURL.host.replace(/:.*/, '');
|
|
if (remoteHost !== 'github.com' && !remoteHost.endsWith('.ghe.com')) {
|
|
// we only support running actions on GitHub for now
|
|
// we might add support for GitLab in the future
|
|
core.debug(`Buildx.convertWarningsToGitHubAnnotations(${ref}): not a GitHub repo: ${remoteHost}`);
|
|
continue;
|
|
}
|
|
// if repository matches then we can link to the Dockerfile
|
|
const remoteRepo = gitURL.path.replace(/^\//, '').replace(/\.git$/, '');
|
|
if (remoteRepo !== GitHub.repository) {
|
|
core.debug(`Buildx.convertWarningsToGitHubAnnotations(${ref}): not same GitHub repo: ${remoteRepo} != ${GitHub.repository}`);
|
|
continue;
|
|
}
|
|
dockerfiles.push({
|
|
path: ls.DockerfilePath, // dockerfile path is always relative for a git context
|
|
remote: true
|
|
});
|
|
continue;
|
|
}
|
|
|
|
if (!fs.existsSync(ls.DockerfilePath)) {
|
|
core.debug(`Buildx.convertWarningsToGitHubAnnotations: Dockerfile not found from localstate ref ${ref}: ${ls.DockerfilePath}`);
|
|
continue;
|
|
}
|
|
|
|
const workspaceDir = GitHub.workspace;
|
|
// only treat dockerfile path relative to GitHub actions workspace dir
|
|
if (Util.isPathRelativeTo(workspaceDir, ls.DockerfilePath)) {
|
|
dockerfiles.push({
|
|
path: path.relative(workspaceDir, ls.DockerfilePath),
|
|
content: Buffer.from(fs.readFileSync(ls.DockerfilePath, {encoding: 'utf-8'}), 'utf-8').toString('base64')
|
|
});
|
|
} else {
|
|
core.debug(`Buildx.convertWarningsToGitHubAnnotations: skipping Dockerfile outside of workspace: ${ls.DockerfilePath}`);
|
|
}
|
|
}
|
|
|
|
if (dockerfiles.length === 0) {
|
|
core.debug(`Buildx.convertWarningsToGitHubAnnotations: no Dockerfiles found`);
|
|
return;
|
|
}
|
|
core.debug(`Buildx.convertWarningsToGitHubAnnotations: found ${dockerfiles.length} Dockerfiles: ${JSON.stringify(dockerfiles, null, 2)}`);
|
|
|
|
const annotations: Array<GitHubAnnotation> = [];
|
|
for (const warning of warnings) {
|
|
if (!warning.detail || !warning.short) {
|
|
core.debug(`Buildx.convertWarningsToGitHubAnnotations: skipping warning without detail or short`);
|
|
continue;
|
|
}
|
|
|
|
const warningSourceFilename = warning.sourceInfo?.filename;
|
|
const warningSourceData = warning.sourceInfo?.data;
|
|
if (!warningSourceFilename || !warningSourceData) {
|
|
core.debug(`Buildx.convertWarningsToGitHubAnnotations: skipping warning without source info filename or data`);
|
|
continue;
|
|
}
|
|
|
|
const title = warning.detail.map(encoded => atob(encoded)).join(' ');
|
|
let message = atob(warning.short).replace(/\s\(line \d+\)$/, '');
|
|
if (warning.url) {
|
|
// https://github.com/docker/buildx/blob/d8c9ebde1fdcf659f1fa3efa6ccc27a28b0f1564/commands/build.go#L854
|
|
message += `\nMore info: ${warning.url}`;
|
|
}
|
|
|
|
// GitHub's annotations don't clearly show ranges of lines, so we'll just
|
|
// show the first line: https://github.com/orgs/community/discussions/129899
|
|
const startLine = warning.range && warning.range.length > 0 ? warning.range[0]?.start.line : undefined;
|
|
|
|
// TODO: When GitHub's annotations support showing ranges properly, we can use this code
|
|
// let startLine: number | undefined, endLine: number | undefined;
|
|
// for (const range of warning.range ?? []) {
|
|
// if (range.start.line && (!startLine || range.start.line < startLine)) {
|
|
// startLine = range.start.line;
|
|
// }
|
|
// if (range.end.line && (!endLine || range.end.line > endLine)) {
|
|
// endLine = range.end.line;
|
|
// }
|
|
// }
|
|
|
|
let annotated = false;
|
|
for (const dockerfile of dockerfiles) {
|
|
// a valid dockerfile path and content is required to match the warning
|
|
// source info or always assume it's valid if this is a remote git
|
|
// context as we can't read the content of the Dockerfile in this case.
|
|
if (dockerfile.remote || (dockerfile.path.endsWith(warningSourceFilename) && dockerfile.content === warningSourceData)) {
|
|
annotations.push({
|
|
title: title,
|
|
message: message,
|
|
file: dockerfile.path,
|
|
startLine: startLine
|
|
});
|
|
annotated = true;
|
|
break;
|
|
}
|
|
}
|
|
if (!annotated) {
|
|
core.debug(`Buildx.convertWarningsToGitHubAnnotations: skipping warning without matching Dockerfile ${warningSourceFilename}: ${title}`);
|
|
}
|
|
}
|
|
|
|
return annotations;
|
|
}
|
|
}
|