build: update docs deployment to use bazel monorepo

Updates docs deployment to rely on the Bazel monorepo.

Author: devversion

docs/firebase.json

@@ -2,7 +2,7 @@
   "$schema": "https://raw.githubusercontent.com/firebase/firebase-tools/master/schema/firebase-config.json",
   "hosting": {
     "target": "mat-aio",
-    "public": "dist/material-angular-io",
+    "public": "./dist/material-angular-io.production",
     "cleanUrls": true,
     "rewrites": [
       {

scripts/docs-deploy/clone-docs-repo.mts

@@ -62,7 +62,7 @@ async function main() {
       // For the stable deployment, we want to update the versions file which is loaded
       // by all docs sites (archives, rc, next etc.). The source of truth for all versions
       // shown in the "docs version picker" is the versions file deployed in stable.
-      prebuild: docsRepoDir => updateVersionsFile(docsRepoDir, active),
+      prebuild: workspaceDir => updateVersionsFile(workspaceDir, active),
     });
     return;
   }

scripts/docs-deploy/deploy-ci-push.mts

@@ -40,7 +40,7 @@ export async function deployToSite(
   info: DeploymentInfo,
 ) {
   const firebase = async (...cmd: string[]) =>
-    $`yarn --cwd ${projectPath} firebase --non-interactive ${cmd}`;
+    $`pnpm --dir=${projectPath}/docs firebase --non-interactive ${cmd}`;
 
   // Setup GCP service key for the docs-app deployment.
   // https://firebase.google.com/docs/admin/setup.

scripts/docs-deploy/deploy-to-site.mts

@@ -1,36 +1,27 @@
 import {$, cd} from 'zx';
 
+import path from 'node:path';
 import {ProductionDeployment} from '../deploy-to-site.mjs';
-import {cloneDocsRepositoryForMajor} from '../clone-docs-repo.mjs';
-import {ActiveReleaseTrains} from '@angular/ng-dev';
-import {getReleaseRepoWithApi} from '../github-versioning.mjs';
-import {installDepsForDocsSite} from '../docs-deps-install.mjs';
-import {sites} from '../utils.mjs';
+import {projectDir, sites} from '../utils.mjs';
 
 /**
  * Runs monitoring tests for the given docs repository, ensuring that the
  * specified remote URL is properly functioning.
  */
-export async function runMonitorTests(docsRepoDir: string, remoteUrl: string) {
-  cd(docsRepoDir);
+export async function runMonitorTests(remoteUrl: string) {
+  cd(path.join(projectDir, 'docs'));
 
   await $`node ./tools/audit-docs.js ${remoteUrl}`;
 }
 
 /** Runs the monitoring tests for the stable release train. */
 export async function runMonitorTestsForStable() {
-  const repo = await getReleaseRepoWithApi();
-  const active = await ActiveReleaseTrains.fetch(repo);
-  const stableMajor = active.latest.version.major;
-  const docsRepoDir = await cloneDocsRepositoryForMajor(stableMajor);
-
-  await installDepsForDocsSite(docsRepoDir);
-  await runMonitorTests(docsRepoDir, sites.stable.remoteUrl);
+  await runMonitorTests(sites.stable.remoteUrl);
 }
 
 /** Runs monitoring tests for all specified production deployments. */
-export async function runMonitoringTests(docsRepoDir: string, targets: ProductionDeployment[]) {
+export async function runMonitoringTests(targets: ProductionDeployment[]) {
   for (const target of targets) {
-    await runMonitorTests(docsRepoDir, target.site.remoteUrl);
+    await runMonitorTests(target.site.remoteUrl);
   }
 }

scripts/docs-deploy/docs-deps-install.mts

@@ -1,20 +1,13 @@
 import {DeploymentInfo, deployToSite, isProductionDeployment} from './deploy-to-site.mjs';
 
-import {buildDocsContentPackage} from '../build-docs-content.mjs';
-import {cloneDocsRepositoryForMajor} from './clone-docs-repo.mjs';
-import {installBuiltPackagesInRepo} from './install-built-packages.mjs';
-import {installDepsAndBuildDocsSite} from './utils.mjs';
-import {performDefaultSnapshotBuild} from '../build-packages-dist.mjs';
 import {runMonitoringTests} from './monitoring/index.mjs';
+import {buildDocsSite, projectDir} from './utils.mjs';
 
 export type DeploymentConfig = {
   /**
    * Optional hook running before building the docs-app for deployment.
-   *
-   * Runs after the docs-content and local packages have been installed
-   * in the docs repository.
    */
-  prebuild?: (docsRepoDir: string) => Promise<void> | void;
+  prebuild?: (workspaceDir: string) => Promise<void> | void;
 };
 
 /**
@@ -48,32 +41,17 @@ export async function buildAndDeployWithSnapshots(
     console.log(`  - ${target.projectId}:${target.site.firebaseSiteId} | ${target.site.remoteUrl}`);
   }
 
-  // Clone the docs repo.
-  const docsRepoDir = await cloneDocsRepositoryForMajor(major);
-
-  // Build the release output.
-  const builtPackages = performDefaultSnapshotBuild();
-
-  // Build the docs-content NPM package (not included in the default snapshot build)
-  builtPackages.push(buildDocsContentPackage());
-
-  // Install the release output, together with the examples into the
-  // the docs repository.
-  await installBuiltPackagesInRepo(docsRepoDir, builtPackages);
-
   // Run the prebuild hook if available.
-  await options.prebuild?.(docsRepoDir);
+  await options.prebuild?.(projectDir);
 
-  // Install yarn dependencies and build the production output.
-  // Lockfile freezing needs to be disabled since we updated the `package.json`
-  // to point to our locally-built package artifacts.
-  await installDepsAndBuildDocsSite(docsRepoDir, {frozenLockfile: false});
+  // Build the production output (we always use HEAD packages).
+  await buildDocsSite();
 
   // Deploy all targets to Firebase.
   for (const target of targets) {
-    await deployToSite(docsRepoDir, firebaseServiceKey, target);
+    await deployToSite(projectDir, firebaseServiceKey, target);
   }
 
   // Run post monitoring tests for production deployments.
-  await runMonitoringTests(docsRepoDir, targets.filter(isProductionDeployment));
+  await runMonitoringTests(targets.filter(isProductionDeployment));
 }

scripts/docs-deploy/monitoring/index.mts

@@ -18,7 +18,7 @@ interface VersionEntry {
 type VersionList = VersionEntry[];
 
 /** Path to the `versions.json` file in the docs-app. */
-const relativeVersionFilePath = 'src/assets/versions.json';
+const relativeVersionFilePath = 'docs/src/assets/versions.json';
 
 /**
  * List of hard-coded major versions which have an archived docs-site,
@@ -33,8 +33,8 @@ const hardcodedOldMajorsWithoutLtsTag = [5, 6, 7, 8, 9, 10, 11];
  * Updates the versions list file in the specified docs repo to reflect
  * the current active release trains and archived LTS versions.
  */
-export async function updateVersionsFile(docsRepoDir: string, active: ActiveReleaseTrains) {
-  const versionFilePath = path.join(docsRepoDir, relativeVersionFilePath);
+export async function updateVersionsFile(workspaceDir: string, active: ActiveReleaseTrains) {
+  const versionFilePath = path.join(workspaceDir, relativeVersionFilePath);
   const {release} = await getConfig([assertValidReleaseConfig]);
   const ltsBranches = await fetchLongTermSupportBranchesFromNpm(release);
 

scripts/docs-deploy/snapshot-deploy.mts

@@ -2,9 +2,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 import {fileURLToPath} from 'url';
 
-import {InstallOptions, installDepsForDocsSite} from './docs-deps-install.mjs';
-
-import {$} from 'zx';
+import {$, cd} from 'zx';
 
 /** Absolute path to the `angular/components` project root. */
 export const projectDir = path.join(path.dirname(fileURLToPath(import.meta.url)), '../..');
@@ -50,10 +48,13 @@ export async function getPackageJsonOfProject(
 }
 
 /**
- * Installs dependencies in the specified docs repository and builds the
- * production site output.
+ * Builds the docs site in production.
  */
-export async function installDepsAndBuildDocsSite(repoPath: string, options: InstallOptions) {
-  await installDepsForDocsSite(repoPath, options);
-  await $`yarn --cwd ${repoPath} prod-build`;
+export async function buildDocsSite() {
+  cd(projectDir);
+  await $`pnpm bazel build --config=snapshot-build //docs:build.production`;
+  await $`rm -Rf docs/dist`;
+  await $`mkdir -p docs/dist`;
+  await $`cp -R dist/bin/docs/material-angular-io.production docs/dist`;
+  await $`chmod -R u+w docs/dist/material-angular-io.production`;
 }