Files
Michael Kriese ef96e4da50 feat: validate the containerbase image version on startup (#47248)
* feat: validate the containerbase image version on startup

Co-Authored-By: Claude Opus 5.5 <michael.kriese+claude-code@mend.io>
Co-Authored-By: Claude Sonnet 5.5 <michael.kriese+claude-code@mend.io>

* fix: read the containerbase version check bypass from the process environment only

Co-Authored-By: Claude Opus 5.5 <michael.kriese+claude-code@mend.io>
Co-Authored-By: Claude Sonnet 5.5 <michael.kriese+claude-code@mend.io>

* refactor: use isContainerbase from the base image package in the version check

Co-Authored-By: Claude Opus 5.5 <michael.kriese+claude-code@mend.io>
Co-Authored-By: Claude Sonnet 5.5 <michael.kriese+claude-code@mend.io>

* fix: explain the containerbase image version check errors

Co-Authored-By: Claude Opus 5.5 <michael.kriese+claude-code@mend.io>
Co-Authored-By: Claude Sonnet 5.5 <michael.kriese+claude-code@mend.io>

* test: read the containerbase version file from memfs

Co-Authored-By: Claude Opus 5.5 <michael.kriese+claude-code@mend.io>

* fix: address review feedback for the containerbase version check

Co-Authored-By: Claude Opus 5.5 <michael.kriese+claude-code@mend.io>

---------

Co-authored-by: Claude Opus 5.5 <michael.kriese+claude-code@mend.io>
2026-10-22 14:02:27 +00:00

142 lines
5.4 KiB
TypeScript

import os from 'node:os';
import {
isContainerbase,
validateContainerbaseVersion,
} from '@renovatebot/base-image';
import fs from 'fs-extra';
import upath from 'upath';
import { applySecretsAndVariablesToConfig } from '../../config/secrets.ts';
import type { AllConfig, RenovateConfig } from '../../config/types.ts';
import { logger } from '../../logger/index.ts';
import { resetGlobalLogLevelRemaps } from '../../logger/remap.ts';
import { initPlatform } from '../../modules/platform/index.ts';
import * as packageCache from '../../util/cache/package/index.ts';
import { setEmojiConfig } from '../../util/emoji.ts';
import { validateGitVersion } from '../../util/git/index.ts';
import * as hostRules from '../../util/host-rules.ts';
import { setHttpRateLimits } from '../../util/http/rate-limits.ts';
import { initMergeConfidence } from '../../util/merge-confidence/index.ts';
import { setMaxLimit } from './limits.ts';
async function setDirectories(input: AllConfig): Promise<AllConfig> {
const config: AllConfig = { ...input };
process.env.TMPDIR = process.env.RENOVATE_TMPDIR ?? os.tmpdir();
if (config.baseDir) {
logger.debug(`Using configured baseDir: ${config.baseDir}`);
} else {
config.baseDir = upath.join(process.env.TMPDIR, 'renovate');
logger.debug(`Using baseDir: ${config.baseDir}`);
}
await fs.ensureDir(config.baseDir);
if (config.cacheDir) {
logger.debug(`Using configured cacheDir: ${config.cacheDir}`);
} else {
config.cacheDir = upath.join(config.baseDir, 'cache');
logger.debug(`Using cacheDir: ${config.cacheDir}`);
}
await fs.ensureDir(config.cacheDir);
if (config.binarySource === 'docker' || config.binarySource === 'install') {
if (config.containerbaseDir) {
logger.debug(
`Using configured containerbaseDir: ${config.containerbaseDir}`,
);
} else {
config.containerbaseDir = upath.join(config.cacheDir, 'containerbase');
logger.debug(`Using containerbaseDir: ${config.containerbaseDir}`);
}
await fs.ensureDir(config.containerbaseDir);
}
return config;
}
function limitCommitsPerRun(config: RenovateConfig): void {
const limit = config.prCommitsPerRunLimit;
setMaxLimit('Commits', typeof limit === 'number' && limit > 0 ? limit : null);
}
/**
* Checks that the Containerbase image version is compatible with Renovate.
*
* Can be skipped using `RENOVATE_X_IGNORE_CONTAINERBASE_VERSION`, which is
* read from the process environment only.
*/
async function checkContainerbaseVersion(): Promise<void> {
if (!isContainerbase()) {
return;
}
if (process.env.RENOVATE_X_IGNORE_CONTAINERBASE_VERSION) {
logger.info(
'Containerbase version check is skipped via RENOVATE_X_IGNORE_CONTAINERBASE_VERSION',
);
return;
}
try {
const version = await validateContainerbaseVersion();
logger.debug({ version }, 'Containerbase image version is compatible');
} catch (err) {
throw new Error(
`Init: containerbase image version check failed: ${err.message}. Upgrade your version of Containerbase, or set \`RENOVATE_X_IGNORE_CONTAINERBASE_VERSION\` to skip the check.`,
);
}
}
/**
* Checks the versions of the tools and the image Renovate depends on.
*/
async function checkVersions(): Promise<void> {
const validGitVersion = await validateGitVersion();
if (!validGitVersion) {
throw new Error('Init: git version needs upgrading');
}
await checkContainerbaseVersion();
}
function setGlobalHostRules(config: AllConfig): void {
if (config.hostRules) {
logger.debug('Setting global hostRules');
applySecretsAndVariablesToConfig({
config,
deleteVariables: false,
deleteSecrets: false,
});
for (const rule of config.hostRules) {
// the self-hosted admin's own rules: `trusted`, so that their `headers` are applied over any a repository or preset sets for the same host, and exempt from `allowedHeaders` altogether - `allowedHeaders` constrains what a repository or preset may set, not the administrator, mirroring how `allowedEnv` does not constrain the administrator's own `env`
hostRules.add(rule, { trusted: true });
}
}
}
function configureThirdPartyLibraries(config: AllConfig): void {
// Not using early return style to make clear what's the criterion to set the variables,
// especially when there is more stuff added here in the future.
if (!config.useCloudMetadataServices) {
logger.debug('Disabling the use of cloud metadata services');
process.env.AWS_EC2_METADATA_DISABLED = 'true'; // See https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-envvars.html#envvars-list
process.env.METADATA_SERVER_DETECTION = 'none'; // See https://cloud.google.com/nodejs/docs/reference/gcp-metadata/latest#environment-variables
}
}
export async function globalInitialize(
config_: AllConfig,
): Promise<RenovateConfig> {
let config = config_;
setHttpRateLimits();
await checkVersions();
setGlobalHostRules(config);
config = await initPlatform(config);
config = await setDirectories(config);
await packageCache.init(config);
limitCommitsPerRun(config);
setEmojiConfig(config);
// registered a second time in case initialization changed them
setGlobalHostRules(config);
configureThirdPartyLibraries(config);
await initMergeConfidence(config);
return config;
}
export async function globalFinalize(config: RenovateConfig): Promise<void> {
await packageCache.cleanup(config);
resetGlobalLogLevelRemaps();
}