ビルド

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

このページの内容は古くなっている可能性があり、一部のリンクが無効になっている場合があります。 このページのより新しいバージョンが 英語版にあります。

詳細情報 ...

このページが最後に更新されてからの英語ページの変更を確認するには、 GitHub compare 74d8cb2a..f0f60aff にアクセスし、content/en/site/build/_index.md を検索してください。

このセクションでは、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 を使用します。 リンクチェックスクリプトの詳細は、リンクチェックを参照してください。


依存関係の管理

サイトの npm 依存関係に対するインストール時の動作、更新手順、サプライチェーン制御

CI ワークフロー

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

リンクチェック

ローカルおよび CI でのサイトのリンクチェック方法。

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

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

NPM スクリプト

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

ヘルパースクリプト

ラベル管理、リンクチェック、レジストリ更新などに CI ワークフローやローカル開発で使用されるシェルスクリプト。

Collector コンポーネントの自動化

OpenTelemetry Collector コンポーネントの自動化プロセスの説明。

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

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

ホームページアナウンス

ホームページアナウンスページのフロントマターフィールドとレンダリング動作。