Function inspectImageInRegistry

src/spec-node/utils.ts:320–375

(output: Log, platformInfo: PlatformInfo, name: string)

}

export async function inspectImageInRegistry(output: Log, platformInfo: PlatformInfo, name: string): Promise<ImageDetails> {
	const resourceAndVersion = qualifyImageName(name);
	const params = { output, env: process.env };
	const ref = getRef(output, resourceAndVersion);
	if (!ref) {
		throw new Error(`Could not parse image name '${name}'`);
	}

	const registryServer = ref.registry === 'docker.io' ? 'registry-1.docker.io' : ref.registry;
	const manifestUrl = `https://${registryServer}/v2/${ref.path}/manifests/${ref.version}`;
	output.write(`manifest url: ${manifestUrl}`, LogLevel.Trace);

	let targetDigest: string | undefined = undefined;
	const manifest = await getManifest(params, manifestUrl, ref, 'application/vnd.docker.distribution.manifest.v2+json');
	if (manifest?.manifestObj.config) { // Checking for config because the above mime type sometimes returns an image index.
		targetDigest = manifest.manifestObj.config.digest;
	} else {
		// If we couldn't fetch the manifest, perhaps the registry supports querying for the 'Image Index'
		// Spec: https://github.com/opencontainers/image-spec/blob/main/image-index.md
		const imageIndexEntry = await getImageIndexEntryForPlatform(params, manifestUrl, ref, platformInfo);
		if (imageIndexEntry) {
			const manifestUrl = `https://${registryServer}/v2/${ref.path}/manifests/${imageIndexEntry.digest}`;
			const a = await getManifest(params, manifestUrl, ref);
			if (a) {
				targetDigest = a.manifestObj.config.digest;
			}
		}
	}

	if (!targetDigest) {
		throw new Error(`No manifest found for ${resourceAndVersion}.`);
	}

	const blobUrl = `https://${registryServer}/v2/${ref.path}/blobs/${targetDigest}`;
	output.write(`blob url: ${blobUrl}`, LogLevel.Trace);

	const httpOptions = {
		type: 'GET',
		url: blobUrl,
		headers: {}
	};

	const res = await requestEnsureAuthenticated(params, httpOptions, ref);
	if (!res) {
		throw new Error(`Failed to fetch blob for ${resourceAndVersion}.`);
	}
	const blob = res.resBody.toString();
	const obj = JSON.parse(blob);
	return {
		Id: targetDigest,
		Config: obj.config,
		Os: platformInfo.os,
		Variant: platformInfo.variant,
		Architecture: platformInfo.arch,
	};
}

export function qualifyImageName(name: string) {