ビルド

CI/CD ワークフロー、このサイトのビルド方法、およびさまざまなサイトメンテナンス作業の実行方法

このセクションでは、OpenTelemetry ウェブサイトのビルド、デプロイ、メンテナンスプロセスを支える CI/CD ワークフロー、NPM スクリプト、ヘルパースクリプトについて説明します。

フルビルドとリーンビルド

通常の(フル)Hugo ウェブサイトビルドに加え、Docsy はリンクチェックの大幅な高速化を可能にしつつ、完全なチェックカバレッジを維持するリーンビルドをサポートしています。 詳細は、Docsy ドキュメントの Chrome build modes を参照してください。

一部のビルド npm スクリプトは常に同じ種類のサイト(フルまたはリーン)をビルドします。 それ以外のスクリプトは BUILD_KIND 環境変数の値を使用し、未設定の場合は lean をデフォルトとします。

ScriptBuild kindDrafts/futureMinify
buildBUILD_KINDyesno
build:fullfullyesno
build:leanleanyesno
build:previewfullyesyes
build:productionfullnoyes
log:build (CI artifact)BUILD_KINDyesno
netlify-build:previewfullyesyes
netlify-build:productionfullnoyes
Most other commandsBUILD_KINDyesno

リンクチェックなど、最初にフレッシュビルドを強制するほとんどのチェックは BUILD_KIND を使用します。 リンクチェックスクリプトの詳細は、リンクチェックを参照してください。


CI ワークフロー

PR のチェック、ラベル管理、その他の CI/CD プロセスを自動化する GitHub Actions ワークフロー。

コンテンツモジュールのパッチ

リリース間でコンテンツモジュールの一時的なパッチを作成・管理する方法。

NPM スクリプト

OpenTelemetry ウェブサイトのビルド、配信、検証、メンテナンスのための NPM スクリプト。

新しいローカリゼーションのセットアップ

OpenTelemetry ウェブサイトに新しい言語のローカリゼーションをオンボーディングするための、メンテナー向けステップバイステップガイド。